What's New in This Guide

This section lists the documentation updates for release 23.4.x.

Release 23.4.7 - F89512-13, February 2025

General Updates:

Added details about the recommended openssl version in the Creating HTTPS or TLS Certificates for Encrypted Connection section.

Upgrade, Rollback, and Uninstall Updates:

Release 23.4.6 - F89512-12, September 2024

Moved a note in the Configuring Multiple Replication Channel Groups section to the beginning of the section as this note has to be considered before configuring multiple replication channel groups.

Release 23.4.6 - F89512-11, August 2024

General Updates:

Updated the steps to create certificates for encrypted connection of replication using TLS in the Creating HTTPS or TLS Certificates for Encrypted Connection section.

Installation Updates:
  • Added notes in the Creating Secrets section to state that the encryption key must be same across all clusters and that encryption key cannot be changed after installation.
  • Made the following updates in the Installation Task section:
    • Added a note to provide information about the NF-specific occndbtier_custom_values_${OCCNE_VERSION}.yaml file provided as part the NF CSAR package.
    • Updated the installation steps to clarify that the user must use the customized NF-specific occndbtier_custom_values_${OCCNE_VERSION}.yaml file to install cnDBTier.
  • Added the numberofparallelbackuptransfer parameter which is used to configure the number of threads created for transferring backups of multiple data nodes in parallel in the DB Replication Service Parameters section.
Upgrade and Rollback Updates:
  • Added a note in the Upgrading cnDBTier Clusters section to state that upgrade from a password encryption enabled cnDBTier version to a password encryption disabled cnDBTier version is not supported.
  • Added a note in the Rolling Back cnDBTier section to state that rollback from a password encryption enabled cnDBTier version to a password encryption disabled cnDBTier version is not supported.

Release 23.4.5 - F89512-10, July 2024

Installation Updates:
  • Added a note in the Configuring Multiple Replication Channel Groups to state that user must create each NF user in each cluster in the multi-cluster deployments, when multiple replication channel groups are enabled and configured.
  • Added the /global/ndb/retainbackupno parameter in the Global Parameters section to provide information about configuring the maximum number of backups that are retained in the cluster.
Upgrade, Rollback, and Uninstall Updates:
Fault Recovery Updates:
  • Updated the "Restoring Database Schema and Tables" sub-section in the Restoring Database from Backup with ndb_restore section to include a step (Step 2) to convert the backup file from zip format to the format required by the restore script.

Release 23.4.4 - F89512-09, May 2024

  • Replaced "fault recovery" with "georeplication recovery" in the entire document wherever the former term was used to indicate performing a georeplication recovery.
  • Added a note in the Customizing cnDBTier section to retain the value of the replication service ports as "80" in the custom_values.yaml file.
  • Updated the supported upgrade paths in the Supported Upgrade Paths section.
  • Updated the supported rollback paths in the Supported Rollback Paths section.
  • Removed -k flag from the CURL commands in the Georeplication Recovery APIs section as using this flag with CURL commands can compromise the security of the system.

Release 23.4.3 - F89512-08, April 2024

  • Updated the apiReplicaCount parameter in the Global Parameters section to provide details about the value set for a standalone site.
  • Added additional details about including pod prefix as part of the ndbmysqld pod name in the following parameters:
    • /db-replication-svc/dbreplsvcdeployments[0]/mysql/primaryhost
    • /db-replication-svc/dbreplsvcdeployments[0]/mysql/secondaryhost
    • /db-replication-svc/dbreplsvcdeployments[1]/mysql/primaryhost
    • /db-replication-svc/dbreplsvcdeployments[1]/mysql/secondaryhost
    • /db-replication-svc/dbreplsvcdeployments[2]/mysql/primaryhost
    • /db-replication-svc/dbreplsvcdeployments[2]/mysql/secondaryhost
  • Added notes in the following sections to request users to ensure that the OCCNE_NAMESPACE variable is set to cnDBTier namespace before running any command containing this variable:

Release 23.4.2 - F89512-07, March 2024

Updated the Helm test command in the Installation Task section.

Release 23.4.2 - F89512-04, February 2024

  • Added the following parameters to configure the start-up probes in the DB Replication Service Parameters section:
    • /db-replication-svc/startupProbe/initialDelaySeconds
    • /db-replication-svc/startupProbe/successThreshold
    • /db-replication-svc/startupProbe/failureThreshold
    • /db-replication-svc/startupProbe/periodSeconds
    • /db-replication-svc/startupProbe/timeoutSeconds
  • Added the /db-monitor-svc/onDemandFetchApproach parameter to enable and disable metrics fetch approach of monitor service in the DB Monitor Service Parameters section.
  • Updated the alert file name to occndbtier_alertrules_promha_${OCCNE_VERSION}.yaml in the Loading cnDBTier Alerts to Prometheus Operator section.

Release 23.4.1 - F89512-03, February 2024

Added a note in the Restoring Database from Backup with ndb_restore section to ignore temporary failures observed in the NDB database.

Release 23.4.1 - F89512-02, February 2024

Release 23.4.0 - F89512-01, December 2023

Installation Updates:
  • Added the Installing cnDBTier Using CDCS section to provide the steps to follow when installing cnDBTier using CDCS.
  • Added a note in the Installing cnDBTier Using CDCS section stating that installation is not supported on cnDBTier setups where TLS is enabled.
  • Added a note in the Installation Task section stating that the LockPagesInMainMemory parameter must be disabled in the custom_values.yaml file as the cnDBTier pods run in non-root user mode.
  • Added the following parameters in the Global Parameters section:
    • /global/networkpolicy/enabled
    • /global/additionalndbconfigurations/mysqld/binlog_cache_size
  • Removed the following parameters from the DB Monitor Service Parameters section:
    • /db-monitor-svc/mysql/primaryhost
    • /db-monitor-svc/mysql/primarysignalhost
    • /db-monitor-svc/mysql/secondaryhost
    • /db-monitor-svc/mysql/secondarysignalhost
  • Updated the alertrules file names in the Loading cnDBTier Alerts to Prometheus Operator section.
Upgrade, Rollback, and Uninstall Updates:
Fault Recovery Updates:
General Updates:
  • Updated the release number to 23.4.0 in the entire document.
  • Updated the MySQL server version from 8.0.34 to 8.0.35 in the sample outputs in the entire document.
  • Updated the timestamps in the sample outputs in the entire document.