What's New in This Guide

This section introduces the documentation updates for release 24.3.x.

Release 24.3.1 - G13393-02, March 2025

General Updates:

Updated the release number to 24.3.1 in the entire document.

Installation Updates:

• Updated the sample custom_values.yaml file configuration in the Configuring CNLB for Communication Between Local and Remote Cluster Replication Pods section.
• Updated the default value of the /api/externalService/labels parameter in the API Parameters section to eliminate duplicate labels in ndbmysqldsvc.
• Added the recommended openssl version details in the Creating HTTPS or TLS Certificates for Encrypted Connection section.

Upgrade, Rollback, and Fault Recovery Updates:

• Updated the upgrade paths in the Supported Upgrade Paths section.
• Updated the rollback paths in the Supported Rollback Paths section.
• Added a note in the following sections to state that upgrade from TLS enabled to a non-TLS version and viceversa follows a two-hop upgrade procedure:
  • Upgrading Cluster from Non-TLS Enabled to TLS Enabled Version
  • Upgrading Cluster from TLS Enabled to Non-TLS Enabled Version
• Added a note in the following sections to state that roll back from TLS enabled to a non-TLS version and viceversa follows a two-hop rollback procedure:
  • Rolling Back cnDBTier from Non-TLS enabled to TLS Enabled Version
  • Rolling Back cnDBTier from TLS enabled to Non-TLS Enabled Version

Fault Recovery Updates:

Updated an assumption in the following sections to state that the procedure assumes that the NF functionality is impacted:

• Resolving GR Failure Between cnDBTier Clusters in a Two-Cluster Replication
• Resolving GR Failure Between cnDBTier Clusters in a Three-Cluster Replication
• Resolving GR Failure Between cnDBTier Clusters in a Four-Cluster Replication
• Restoring Two cnDBTier Clusters in a Four-Cluster Replication
• Restoring Three cnDBTier Clusters in a Four-Cluster Replication
• Resolving GR Failure Between cnDBTier Clusters in Two-Cluster Replication using CNC Console
• Resolving GR Failure Between cnDBTier Clusters in Three-Cluster Replication using CNC Console
• Resolving GR Failure Between cnDBTier Clusters in Four-Cluster Replication using CNC Console
• Restoring Two cnDBTier Clusters in Four-Cluster Replication using CNC Console
• Restoring Three cnDBTier Clusters in Four-Cluster Replication using CNC Console

Release 24.3.0 - G13393-01, October 2024

General Updates:

• Updated the MySQL version from "8.0.37" to "8.4.2" in the entire document.
• Updated the release number to "24.3.0" in the entire document.
• Updated the timestamps in the sample outputs in the entire document.
• Updated the error correct policy details in the Oracle Error Correction Policy section.
• Added the procedure to disable password encryption in the Disabling Password Encryption section.
• 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:
  • Installing cnDBTier
  • Upgrading cnDBTier
  • Rolling Back cnDBTier
  • Uninstalling cnDBTier

Installation Updates:

• Made the following updates in the Creating Secrets section:
  • Updated the password complexity requirements for Transparent Data Encryption (TDE) password.
  • Updated the sample output in step 1 to include updates related to TDE secret.
  • Added a step to create secret for encrypting data stored in data nodes using TDE.
• Updated the resources in the Resource Requirement section.
• Added a step to create service monitor with cnDBTier configuration in the Verifying and Creating Namespace section.
• Made the following updates in the Customizing cnDBTier section:
  • Added the /global/ndb/EncryptedFileSystem parameter which is used to enable TDE in the Global Parameters section.
  • Updated the default value of the /global/additionalndbconfigurations/ndb/HeartbeatIntervalDbDb parameter from 500 to 1250 in the Global Parameters section.
  • Updated the default value of /global/api/binlogpurgetimer from 600000 to 600s.
  • Added the following parameters in the Global Parameters section:
    • /global/k8sResource/container/prefix
    • /global/k8sResource/pod/prefix
    • /global/backupencryption/backupencryptionsecret
    • /global/additionalndbconfigurations/ndb/__TransactionErrorLogLevel
    • /global/additionalndbconfigurations/ndb/TotalSendBufferMemory
    • /global/additionalndbconfigurations/ndb/CompressedLCP
    • /global/additionalndbconfigurations/ndb/HeartbeatIntervalDbDb
    • /global/additionalndbconfigurations/ndb/ConnectCheckIntervalDelay
    • /global/additionalndbconfigurations/ndb/LockPagesInMainMemory
    • /global/additionalndbconfigurations/ndb/MaxNoOfConcurrentOperations
    • /global/additionalndbconfigurations/ndb/MaxNoOfConcurrentTransactions
    • /global/additionalndbconfigurations/ndb/MaxNoOfUniqueHashIndexes
    • /global/additionalndbconfigurations/ndb/FragmentLogFileSize
    • /global/additionalndbconfigurations/ndb/ODirect
    • /global/additionalndbconfigurations/ndb/RedoBuffer
    • /global/additionalndbconfigurations/ndb/SchedulerExecutionTimer
    • /global/additionalndbconfigurations/ndb/SchedulerSpinTimer
    • /global/additionalndbconfigurations/ndb/TimeBetweenGlobalCheckpoints
    • /global/additionalndbconfigurations/ndb/TimeBetweenLocalCheckpoints
    • /global/additionalndbconfigurations/ndb/TimeBetweenEpochsTimeout
    • /global/additionalndbconfigurations/ndb/TimeBetweenGlobalCheckpointsTimeout
    • /global/additionalndbconfigurations/ndb/RedoOverCommitLimit
    • /global/additionalndbconfigurations/ndb/RedoOverCommitCounter
    • /global/additionalndbconfigurations/ndb/StartPartitionedTimeout
    • /global/additionalndbconfigurations/ndb/MaxBufferedEpochBytes
    • /global/additionalndbconfigurations/ndb/MaxBufferedEpochs
    • /global/additionalndbconfigurations/api/TotalSendBufferMemory
    • /global/additionalndbconfigurations/api/DefaultOperationRedoProblemAction
    • /global/additionalndbconfigurations/mysqld/max_connect_errors
    • /global/additionalndbconfigurations/mysqld/ndb_applier_allow_skip_epoch
    • /global/additionalndbconfigurations/mysqld/max_allowed_packet
    • /global/additionalndbconfigurations/mysqld/ndb_log_update_minimal
    • /global/additionalndbconfigurations/mysqld/binlog_transaction_compression
    • /global/additionalndbconfigurations/mysqld/binlog_transaction_compression_level_zstd
    • /global/additionalndbconfigurations/mysqld/ndb_report_thresh_binlog_epoch_slip
    • /global/additionalndbconfigurations/mysqld/ndb_allow_copying_alter_table
    • /global/additionalndbconfigurations/mysqld/ndb_clear_apply_status
    • /global/additionalndbconfigurations/mysqld/replica_net_timeout
    • /global/additionalndbconfigurations/replmysqld/ndb_eventbuffer_max_alloc
    • /global/additionalndbconfigurations/replmysqld/relay_log_space_limit
    • /global/additionalndbconfigurations/replmysqld/max_relay_log_size
    • /global/additionalndbconfigurations/appmysqld/ndb_eventbuffer_max_alloc
    • /global/additionalndbconfigurations/tcp/SendBufferMemory
    • /global/additionalndbconfigurations/tcp/ReceiveBufferMemory
    • /global/additionalndbconfigurations/tcp/TCP_SND_BUF_SIZE
    • /global/additionalndbconfigurations/tcp/TCP_RCV_BUF_SIZE
    • /global/ndb/ndbbackupdisksize
    • /global/api/user
    • /global/ndbapp/ndb_cluster_connection_pool
    • /global/ndbapp/ndb_cluster_connection_pool_base_nodeid
    • /global/services/ipFamilyPolicy
    • /global/additionalndbconfigurations/tcpemptyapi/SendBufferMemory
    • /global/additionalndbconfigurations/tcpemptyapi/ReceiveBufferMemory
    • /global/additionalndbconfigurations/tcpemptyapi/TCP_SND_BUF_SIZE
    • /global/additionalndbconfigurations/tcpemptyapi/TCP_RCV_BUF_SIZE
  • Renamed the /global/additionalndbconfigurations/mysqld/slave_allow_batching parameter to /global/additionalndbconfigurations/mysqld/replica_allow_batching in the Global Parameters section.
  • Removed the /global/k8sResource parameter from the Global Parameters section as it is not applicable.
  • Updated the error numbers in the default values of the /global/replicationskiperrors/replicationerrornumbers parameter in the Global Parameters section.
  • Added the following parameters in the Management Parameters section:
    • /mgm/inframonitor/image/name
    • /mgm/inframonitor/image/repository
    • /mgm/inframonitor/image/tag
    • /mgm/inframonitor/image/imagePullPolicy
    • /mgm/annotations
    • /mgm/commonlabels
    • /mgm/anti_pod_affinity
    • /mgm/use_pod_affinity_rules
    • /mgm/nodeAffinity/enable
    • /mgm/service/labels
    • /mgm/selector
  • Added the following parameters in the NDB Parameters section:
    • /ndb/sidecar/image/repository
    • /ndb/sidecar/image/imagePullPolicy
    • /ndb/sidecar/log/level
    • /ndb/sidecar/resources/limits/cpu
    • /ndb/sidecar/resources/limits/memory
    • /ndb/sidecar/resources/requests/cpu
    • /ndb/sidecar/resources/requests/memory
    • /ndb/inframonitor/image/name
    • /ndb/inframonitor/image/repository
    • /ndb/inframonitor/image/tag
    • /ndb/inframonitor/image/imagePullPolicy
    • /ndb/annotations
    • /ndb/commonlabels
    • /ndb/anti_pod_affinity
    • /ndb/use_pod_affinity_rules
    • /ndb/pod_affinity
    • /ndb/service/labels
    • /ndb/selector
    • /api/initsidecar/image/repository
    • /api/initsidecar/image/tag
    • /api/initsidecar/image/imagePullPolicy
    • /api/initSidecarResources/limits/cpu
    • /api/initSidecarResources/limits/memory
    • /api/initSidecarResources/limits/ephemeral-storage
    • /api/initSidecarResources/requests/cpu
    • /api/initSidecarResources/requests/memory
    • /api/initSidecarResources/requests/ephemeral-storage
    • /api/anti_pod_affinity
    • /api/externalService/type
    • /api/externalService/annotations
    • /api/externalService/sqlgeorepsvclabels[0]/labels
    • /api/externalService/sqlgeorepsvclabels[1]/labels
    • /api/externalService/sqlgeorepsvclabels[2]/labels
    • /api/externalService/sqlgeorepsvclabels[3]/labels
    • /api/externalService/labels
    • /api/connectivityService/name
    • /api/connectivityService/multus/networkAttachmentDefinationApiName
    • /api/connectivityService/labels
    • /api/connectivityService/selector
    • /api/externalconnectivityService/enable
    • /api/externalconnectivityService/selector
    • /api/ndbapp/anti_pod_affinity
    • /api/ndbapp/use_pod_affinity_rules
    • /api/ndbapp/pod_affinity
    • /api/ndbapp/annotations
    • /api/ndbapp/commonlabels
    • /api/ndbapp/service/labels
    • /api/ndbapp/connectivityService/name
    • /api/ndbapp/connectivityService/labels
    • /api/ndbapp/connectivityService/selector
    • /api/ndbapp/connectivityService/ndbappconnetselector
    • /api/ndbapp/externalconnectivityService/enable
    • /api/ndbapp/externalconnectivityService/type
    • /api/ndbapp/externalconnectivityService/annotations
    • /api/ndbapp/externalconnectivityService/labels
    • /api/ndbapp/externalconnectivityService/selector
  • Added the following parameters in the DB Replication Service Parameters section:
    • /db-replication-svc/enabled
    • /db-replication-svc/useClusterIpForReplication
    • /db-replication-svc/image/repository
    • /db-replication-svc/image/tag
    • /db-replication-svc/image/pullPolicy
    • /db-replication-svc/dbreplsvcdeployments[0]/multus/networkAttachmentDefinationApiName
    • /db-replication-svc/dbreplsvcdeployments[0]/podDisruptionBudget/enabled
    • /db-replication-svc/dbreplsvcdeployments[0]/podDisruptionBudget/maxUnavailable
    • /db-replication-svc/dbreplsvcdeployments[0]/podDisruptionBudget/labels
    • /db-replication-svc/dbreplsvcdeployments[0]/mysql/dbtierservice
    • /db-replication-svc/dbreplsvcdeployments[0]/mysql/dbtierreplservice
    • /db-replication-svc/dbreplsvcdeployments[0]/mysql/port
    • /db-replication-svc/dbreplsvcdeployments[0]/mysql/primarysignalhostmultusconfig/networkAttachmentDefinationApiName
    • /db-replication-svc/dbreplsvcdeployments[0]/mysql/secondarysignalhostmultusconfig/networkAttachmentDefinationApiName
    • /db-replication-svc/dbreplsvcdeployments[0]/podAnnotations
    • /db-replication-svc/dbreplsvcdeployments[0]/schedulertimer
    • /db-replication-svc/dbreplsvcdeployments[0]/log/level
    • /db-replication-svc/dbreplsvcdeployments[0]/service/type
    • /db-replication-svc/dbreplsvcdeployments[0]/service/port
    • /db-replication-svc/dbreplsvcdeployments[0]/service/labels
    • /db-replication-svc/dbreplsvcdeployments[0]/service/annotations
    • /db-replication-svc/dbreplsvcdeployments[1]/multus/enable
    • /db-replication-svc/dbreplsvcdeployments[1]/multus/networkAttachmentDefinationApiName
    • /db-replication-svc/dbreplsvcdeployments[1]/multus/networkAttachmentDefinationTagName
    • /db-replication-svc/dbreplsvcdeployments[1]/podDisruptionBudget/enabled
    • /db-replication-svc/dbreplsvcdeployments[1]/podDisruptionBudget/maxUnavailable
    • /db-replication-svc/dbreplsvcdeployments[1]/podDisruptionBudget/labels
    • /db-replication-svc/dbreplsvcdeployments[1]/mysql/dbtierservice
    • /db-replication-svc/dbreplsvcdeployments[1]/mysql/dbtierreplservice
    • /db-replication-svc/dbreplsvcdeployments[1]/mysql/port
    • /db-replication-svc/dbreplsvcdeployments[1]/mysql/primarysignalhostmultusconfig/multusEnabled
    • /db-replication-svc/dbreplsvcdeployments[1]/mysql/primarysignalhostmultusconfig/networkAttachmentDefinationApiName
    • /db-replication-svc/dbreplsvcdeployments[1]/mysql/primarysignalhostmultusconfig/networkAttachmentDefinationTagName
    • /db-replication-svc/dbreplsvcdeployments[1]/mysql/secondarysignalhostmultusconfig/multusEnabled
    • /db-replication-svc/dbreplsvcdeployments[1]/mysql/secondarysignalhostmultusconfig/networkAttachmentDefinationApiName
    • /db-replication-svc/dbreplsvcdeployments[1]/mysql/secondarysignalhostmultusconfig/networkAttachmentDefinationTagName
    • /db-replication-svc/dbreplsvcdeployments[1]/podAnnotations
    • /db-replication-svc/dbreplsvcdeployments[1]/schedulertimer
    • /db-replication-svc/dbreplsvcdeployments[1]/log/level
    • /db-replication-svc/dbreplsvcdeployments[1]/service/type
    • /db-replication-svc/dbreplsvcdeployments[1]/service/port
    • /db-replication-svc/dbreplsvcdeployments[1]/service/labels
    • /db-replication-svc/dbreplsvcdeployments[1]/service/annotations
    • /db-replication-svc/dbreplsvcdeployments[2]/multus/enable
    • /db-replication-svc/dbreplsvcdeployments[2]/multus/networkAttachmentDefinationApiName
    • /db-replication-svc/dbreplsvcdeployments[2]/multus/networkAttachmentDefinationTagName
    • /db-replication-svc/dbreplsvcdeployments[2]/podDisruptionBudget/enabled
    • /db-replication-svc/dbreplsvcdeployments[2]/podDisruptionBudget/maxUnavailable
    • /db-replication-svc/dbreplsvcdeployments[2]/podDisruptionBudget/labels
    • /db-replication-svc/dbreplsvcdeployments[2]/mysql/dbtierservice
    • /db-replication-svc/dbreplsvcdeployments[2]/mysql/dbtierreplservice
    • /db-replication-svc/dbreplsvcdeployments[2]/mysql/port
    • /db-replication-svc/dbreplsvcdeployments[2]/mysql/primarysignalhostmultusconfig/multusEnabled
    • /db-replication-svc/dbreplsvcdeployments[2]/mysql/primarysignalhostmultusconfig/networkAttachmentDefinationApiName
    • /db-replication-svc/dbreplsvcdeployments[2]/mysql/primarysignalhostmultusconfig/networkAttachmentDefinationTagName
    • /db-replication-svc/dbreplsvcdeployments[2]/mysql/secondarysignalhostmultusconfig/multusEnabled
    • /db-replication-svc/dbreplsvcdeployments[2]/mysql/secondarysignalhostmultusconfig/networkAttachmentDefinationApiName
    • /db-replication-svc/dbreplsvcdeployments[2]/mysql/secondarysignalhostmultusconfig/networkAttachmentDefinationTagName
    • /db-replication-svc/dbreplsvcdeployments[2]/podAnnotations
    • /db-replication-svc/dbreplsvcdeployments[2]/schedulertimer
    • /db-replication-svc/dbreplsvcdeployments[2]/log/level
    • /db-replication-svc/dbreplsvcdeployments[2]/service/type
    • /db-replication-svc/dbreplsvcdeployments[2]/service/port
    • /db-replication-svc/dbreplsvcdeployments[2]/service/labels
    • /db-replication-svc/dbreplsvcdeployments[2]/service/annotations
    • /db-replication-svc/numberofparallelbackuptransfer
    • /db-replication-svc/validateresourcesingeorecovery
    • /db-replication-svc/initcontainer/image/pullPolicy
    • /db-replication-svc/InitContainersResources/limits/cpu
    • /db-replication-svc/InitContainersResources/limits/memory
    • /db-replication-svc/InitContainersResources/requests/cpu
    • /db-replication-svc/InitContainersResources/requests/memory
  • Updated the default value of /db-replication-svc/dbreplsvcdeployments[0]/pvc/disksize from 8Gi to 60Gi in the DB Replication Service Parameters section.
  • Added the following parameters in the DB Monitor Service Parameters section:
    • /db-monitor-svc/metricsFetchSchedulerTimer
    • /db-monitor-svc/image/pullPolicy
    • /db-monitor-svc/labels
    • /db-monitor-svc/podAnnotations
    • /db-monitor-svc/service/labels
    • /db-monitor-svc/service/annotations
    • /db-monitor-svc/log/level
  • Updated the default value of the /db-monitor-svc/ schedulertimer parameter from 5000 to 5s.
  • Added the following parameters in the DB Backup Manager Service Parameters section:
    • /db-backup-manager-svc/securityContext
    • /db-backup-manager-svc/executor_status_verify_retry/count
    • /db-backup-manager-svc/executor_status_verify_retry/gap
    • /db-backup-manager-svc/pod/annotations
    • /db-backup-manager-svc/pod/labels
    • /db-backup-manager-svc/image/pullPolicy
    • /db-backup-manager-svc/log/level
    • /db-backup-manager-svc/resources/limits/cpu
    • /db-backup-manager-svc/resources/limits/memory
    • /db-backup-manager-svc/resources/requests/cpu
    • /db-backup-manager-svc/resources/requests/memory
    • /db-backup-manager-svc/priorityClassName
    • /db-backup-manager-svc/service/annotations
    • /db-backup-manager-svc/service/labels
  • Added the following parameters in the Post Install Job Parameters:
    • /postInstallJob/image/repository
    • /postInstallJob/image/tag
    • /postInstallJob/image/pullPolicy
    • /postInstallJob/resources/limits/cpu
    • /postInstallJob/resources/limits/memory
    • /postInstallJob/resources/limits/ephemeral-storage
    • /postInstallJob/resources/requests/cpu
    • /postInstallJob/resources/requests/memory
    • /postInstallJob/resources/requests/ephemeral-storage
  • Added the following parameters in the Preupgrade Job Parameters section:
    • /preUpgradeJob/image/pullPolicy
    • /preUpgradeJob/resources/limits/cpu
    • /preUpgradeJob/resources/limits/memory
    • /preUpgradeJob/resources/requests/cpu
    • /preUpgradeJob/resources/requests/memory
  • Added the following parameters in the Post Upgrade Job Parameters section:
    • /postUpgradeJob/image/pullPolicy
    • /postUpgradeJob/resources/limits/cpu
    • /postUpgradeJob/resources/limits/memory
    • /postUpgradeJob/resources/requests/cpu
    • /postUpgradeJob/resources/requests/memory
  • Added the following parameters in the Post Rollback Job Parameters section:
    • /postRollbackJob/image/pullPolicy
    • /postRollbackJob/resources/limits/cpu
    • /postRollbackJob/resources/limits/memory
    • /postRollbackJob/resources/requests/cpu
    • /postRollbackJob/resources/requests/memory
  • Added the following parameters in the Helm Test Parameters section:
    • /test/image/pullPolicy
    • /test/annotations
    • /test/resources/limits/cpu
    • /test/resources/limits/memory
    • /test/resources/requests/cpu
    • /test/resources/requests/memory

Upgrade, Rollback, and Uninstall Updates:

• Made the following updates in the Upgrading cnDBTier Clusters section:
  • Added a note to state that TDE secret must be created first if TDE is enabled.
  • Added an assumption to state that the HELM parameters that are restricted to be updated during upgrade, must not be changed.
  • Added a note to state that password encryption must be disabled in the cnDBtier site from which cnDBTier is upgraded.
  • Updated a note to change the recommended value of the HeartbeatIntervalDbDb parameter to 1250 and to update the example accordingly.
  • Added a note to state that PVC sizes must not be changed during an upgrade and must be modified only using the vertical scaling procedures.
• Updated the steps to roll back cnDBTier in the Rolling Back cnDBTier section.

Fault Recovery Updates:

• Added a note in the Monitoring Georeplication Recovery Status Using cnDBTier APIs section to inform the user to restart the georeplication recovery process if dr_state displays GRR_FAILED.
• Added the VALIDATERESOURCES status which validates the georeplication resources in the Georeplication Recovery Status section.