What's New in This Guide

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

Release 24.1.2 - F93830-05, October 2024

  • Made the following updates in the Creating Secrets section:
    • Added a note to inform that cnDBTier supports either disabling encryption across all the clusters or enabling encryption by using the same encryption key across all the clusters.
    • Added a note to inform that cnDBTier doesn't support changing the encryption key after installation.
  • The following updates are made in the Global Parameters section:
    • Added the /global/additionalndbconfigurations/ndb/HeartbeatIntervalDbDb parameter which is used to configure how often the heartbeat signals are sent and how often the system can expect to receive them.
    • Added the /global/ndb/retainbackupno parameter which is used to configure the maximum number of backups that are retained in the cluster.
    • Added the following parameters that are used to configure the size of the send or receive buffer during TCP transporters initialization:
      • /Values/global/additionalndbconfigurations/tcpemptyapi/SendBufferMemory
      • /Values/global/additionalndbconfigurations/tcpemptyapi/ReceiveBufferMemory
      • /Values/global/additionalndbconfigurations/tcpemptyapi/TCP_SND_BUF_SIZE
      • /Values/global/additionalndbconfigurations/tcpemptyapi/TCP_RCV_BUF_SIZE
  • Added the /db-replication-svc/numberofparallelbackuptransfer parameter in the DB Replication Service Parameters section to provide details about configuring the number of threads created for transferring backups of multiple data nodes in parallel.
  • Added a note in the following sections to inform that cnDBTier doesn't support upgrading or rolling back from a password encryption enabled version to a password encryption disabled version and vice-versa:
  • Added a note in the following sections to state that the namespace name "occne-cndbtier" given in the procedures is only an example and user must configure the namespace name according to their environment:
  • Updated the Creating HTTPS or TLS Certificates for Encrypted Connection section to include steps to create certificates for encrypted connection of replication using HTTPS.
  • Updated the Rolling Back cnDBTier section to add a step to instruct the user to restart the ndbmtd pods with the --initial flag after the rollback when certain parameters were updated during an upgrade.

Release 24.1.1 - F93830-04, 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 24.1.1 - F93830-03, August 2024

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.

Release 24.1.1 - F93830-02, July 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 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 a note in the Customizing cnDBTier section to retain the value of the replication service ports as "80" in the custom_values.yaml file.
  • Made the following updates in the Global Parameters section:
    • Updated the default value of the /global/additionalndbconfigurations/mysqld/replica_parallel_workers parameter from "1" to "0".
    • Added a note in the /global/replicationskiperrors/replicationerrornumbers parameter to include additional error numbers to skip replication errors with respect to DDL statements.
    • Added the /global/ndb/retainbackupno parameter to provide information about configuring the maximum number of backups that are retained in the cluster.
Installation, 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 24.1.0 - F93830-01, April 2024

Installation Updates:
  • Made the following updates in the Global Parameters section:
    • Added the following parameters to handle switchover identification time:
      • source_connect_retry
      • source_heartbeat_period
      • source_retry_count
      • replica_net_timeout
    • Updated the apiReplicaCount parameter to provide details about the value set for a standalone site.
    • Added the TransactionDeadlockDetectionTimeout parameter to configure the amount of time a transaction can spend running within a data node.
    • Updated the default value of the replica_parallel_workers parameter.
    • Added the following parameters to configure the transaction dependencies:
      • binlog_transaction_dependency_tracking
      • ndb_log_transaction_dependency
  • Made the following updates in the DB Replication Service Parameters section:
    • Updated the default value, description, and notes of the enableInitContainerForIpDiscovery parameter.
    • 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
  • Removed the Installing cnDBTier Using CDCS section from the document as CDCS support is stalled and is not applicable to this release.
  • Removed notes that provided details about upgrading or rolling back cnDBTier using CDCS from the following sections as CDCS support is stalled and is not applicable to this release:
  • Added the following postinstallation procedures to configure cnDBTier alerts and metrics in OCI:
Upgrade, Rollback, and Uninstall Updates:
Fault Recovery Updates:
General Updates:
  • Updated the release number to 24.1.0 in the entire document.
  • Updated the MySQL server version from 8.0.35 to 8.0.36 in the sample outputs in the entire document.
  • Updated the timestamps in the sample outputs in the entire document.
  • 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: