--- title: Release Notes for Couchbase Server 7.2 pubDate: 2026-08-17T09:53:44.266Z antora: editUrl: https://github.com/couchbase/docs-server/edit/release/7.2/modules/release-notes/pages/relnotes.adoc xref: xref:7.2@server:release-notes:relnotes.adoc[] --- [Consult the llms.txt file for a full list of contents](/llms.txt) [View original HTML](/server/7.2/release-notes/relnotes.html) # Release Notes for Couchbase Server 7.2 > [!WARNING] > Data consistency issue for buckets using Magma storage engine > > If you're using Magma buckets and upgrading from any release prior to 7.2.7, then follow the upgrade instructions as described in [MB-67762](https://jira.issues.couchbase.com/browse/MB-67762) ## [](#release-728)Release 7.2.8 (August 2025) Couchbase Server 7.2.8 was released in August 2025\. This maintenance release contains fixes to issues. ## [](#fixed-issues)Fixed Issues ### [](#data-service)Data Service | Issue | Description | Resolution | | ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ | | [MB-67762](https://jira.issues.couchbase.com/browse/MB-67762) | There is an integer overflow bug in buckets using the Magma storage engine. This bug can potentially cause a subset of mutations to become invisible to read operations after approximately 500 billion to 2 trillion mutations per bucket. | For details, please refer to [MB-67762](https://jira.issues.couchbase.com/browse/MB-67762) | ### [](#xdcr)XDCR | Issue | Description | Resolution | | -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------- | | [MB-66650](https://jira.issues.couchbase.com/browse/MB-66650/) | When modifying filter expressions or mapping configurations (explicit/migration), race conditions may prevent proper replication from the source. This can result in source bucket documents failing to replicate to the target bucket. To address this issue, the system now displays an alert when detecting replication resuming from stale checkpoints. This alert notifies users to delete and recreate the affected replication. IMPORTANT: Do not dismiss this alert by pausing and resuming the replication, as this will hide the warning without resolving the underlying issue. | Issue resolved | ### [](#query-service)Query Service | Issue | Description | Resolution | | -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- | | [MB-67849](https://jira.issues.couchbase.com/browse/MB-67849/) | The recent builds of Couchbase Server versions 7.2.7 through 8.1.0 and Enterprise Analytics 2.1.0 include updates from the go\_json library to address int64 overflow issues reported under MB-67849\. The updates involve implementing proper checks for int64 overflow in order to properly represent large numbers (greater than \\$2^63\\$ or less than \\$-2^63\\$). | Issue resolved | ### [](#index-service)Index Service | Issue | Description | Resolution | | -------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- | | [MB-66034](https://jira.issues.couchbase.com/browse/MB-66034/) | Previously, during smart batching, the calculation of max concurrent builds per node incorrectly considered all indexer nodes as potential destinations; even those not participating in index movement during the rebalance. As a result, the destination node count was inflated, causing the batch size to be divided across more nodes than necessary. This led to smaller batch sizes and fewer tokens per batch on the actual recipient nodes. With this fix, only indexer nodes that are actively receiving index transfers are considered in the destination node count. This results in more accurate batch sizing and improved efficiency during index rebalance operations. | Issue resolved | | [MB-67116](https://jira.issues.couchbase.com/browse/MB-67116/) | A race condition in the projector service could cause a deadlock when closing streams with high mutation rates. The issue, present since version 7.2.2, didn't affect functionality but resulted in increased memory consumption as mutations in the pipeline couldn't be released properly. With this fix, memory usage has been restored to normal levels. | Issue resolved | | [MB-67118](https://jira.issues.couchbase.com/browse/MB-67118/) | DropInstanceToken increased in size due to changes in the definition. With more partitions, its size can increase beyond the metakv size limit. This ticket fixes the issue by using BigValueGet with DropInstanceToken which splits the tokens in parts, stores them in metakv, and retrieves the token by combining the parts. Before this patch, replica drops were failing when the token increased in size as retrieval was failing. | Issue resolved | ### [](#tools)Tools | Issue | Description | Resolution | | -------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- | | [MB-57755](https://jira.issues.couchbase.com/browse/MB-57755/) | Beginning with Server 7.2.8/7.6.7, when installing on a Linux system using cgroups v1, Server will set the memory.swappiness cgroups parameter to 0 for the couchbase-server service slice. This ensures best performance without affecting any other services that may be running on the system. For Linux systems using cgroups v2 (which is the default for the more recent releases of most Linux distributions), there is no memory.swappiness parameter for individual service slices. Therefore it is still highly recommended to set kernel swappiness to 0 globally on each node, as explained in the documentation: | Issue resolved | ## [](#release-727)Release 7.2.7 (March 2025) ### [](#fixed-issues-2)Fixed Issues Couchbase Server 7.2.7 was released in March 2025\. This maintenance release contains the following fixes. #### [](#storage-engine)Storage Engine | Issue | Description | Resolution | | ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [MB-63261](https://jira.issues.couchbase.com/browse/MB-63261) | An issue occurred caused by a race condition in the index recovery code path, which may result in item count mismatch and wrong query results. Prior to Release 7.6.0, this issue may occur during an Indexer restart. However, as part of the file-based rebalance process introduced in 7.6.0, a recovery of the index is performed after the index is moved, which increases the likelihood that this race condition might be reached. | The race condition has been addressed and the issue is resolved. | | [MB-64742](https://jira.issues.couchbase.com/browse/MB-64742) | A bug in the plasma tracking statistics incorrectly marked stale recovery points in the recovery log as valid data. This caused two problems: At low mutation rates, the log cleaning process ran slowly and couldn't effectively trim recovery point history. At higher mutation rates, the system worked around this issue because mutations would increase the fragmentation ratio enough to trigger the log cleaner, which could then trim recovery point history despite the tracking statistics bug. | The system now marks only the latest recovery point that exists in both the recovery log and data log. This change effectively limits the recovery point history list to a single entry in the recovery log. The plasma tracking statistics have been fixed to correctly identify older recovery points as stale data in the recovery log. These improvements allow the log cleaner to run efficiently even at low mutation rates. | #### [](#data-service-2)Data Service | Issue | Description | Resolution | | ------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- | | [MB-63827](https://jira.issues.couchbase.com/browse/MB-63827) | DCP connection metrics with connection names that do not conform to the server format are not exposed to Prometheus. | The metrics are aggregated and exposed with connection\_type="\_unknown". | #### [](#xdcr-2)XDCR | Issue | Description | Resolution | | ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [MB-64565](https://jira.issues.couchbase.com/browse/MB-64565) | If users did not want the replication to be automatically deleted upon either source or bucket deletion and/or recreation, they could set the skipReplSpecAutoGc replication setting to true upon replication creation. In the situation that the replication would have been deleted, it would have been automatically paused instead, and a persistent UI error message logged for viewing. Users are expected to manually execute the recovery action by deleting the replication and re-creating a newer one, if necessary. | In the situation that the replication has been deleted, it will be automatically paused instead, and a persistent UI error message logged for viewing. Users are then expected to manually execute the recovery action by deleting the replication and re-creating a newer one, if necessary. | ## [](#release-726)Release 7.2.6 (September 2024) Couchbase Server 7.2.6 was released in September 2024\. This maintenance release contains the following fixes. For details on new features and enhancements, see the [What's New page](../introduction/whats-new.md). ### [](#fixed-issues-3)Fixed Issues #### [](#cluster-manager)Cluster Manager | Issue | Description | Resolution | | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | | [MB-62219](https://jira.issues.couchbase.com/browse/MB-62219) | You could not rotate root certificates when a new root used the same private key as the old root. | Issue resolved. | | [MB-62413](https://jira.issues.couchbase.com/browse/MB-62413) | When a username is extracted from a client certificate, no check for the user existing locally on the cluster was made. | The cert user will only match if her username matches an existing record on the cluster. | #### [](#storage-engine-2)Storage Engine | Issue | Description | Resolution | | ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | | [MB-62678](https://jira.issues.couchbase.com/browse/MB-62678) | Resolved an issue where TTL-driven deletions via VBucket::deleteItem could generate invalid tombstones containing a document body. This issue occurred when TTL was triggered during the second phase of a 2-phase delete operation. | The fix ensures that when TTL triggers at CMD\_DEL, the document body is correctly removed and a valid tombstone is generated. | | [MB-62984](https://jira.issues.couchbase.com/browse/MB-62984) | When a Couchbase Data Service experiences a hard failover or crashes with data loss, DCP clients (like those used with Elasticsearch and Kafka) might receive incomplete or partial snapshots of the data. This incomplete data can lead to rare situations (edge cases) where the Data Service ends up crashing repeatedly. | Issue resolved. | | [MB-63286](https://jira.issues.couchbase.com/browse/MB-63286) | An issue occurred, caused by a race condition in the index recovery code path, which sometimes resulted in item count mismatches and incorrect query results. The issue sometimes occurred during an Indexer restart. | Issue resolved. | #### [](#xdcr-3)XDCR | Issue | Description | Resolution | | ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [MB-62005](https://jira.issues.couchbase.com/browse/MB-62005) | When none of the nodes in the remote reference DNS SRV entry is reachable, XDCR could be stuck working off of a stale list of nodes. | Now, XDCR will be able to re-bootstrap from the top DNS SRV entry | | [MB-62006](https://jira.issues.couchbase.com/browse/MB-62006) | Stale connectivity errors were not cleared. | Stale connectivity errors are now cleared correctly. | | [MB-62008](https://jira.issues.couchbase.com/browse/MB-62008) | XDCR on Non-KV nodes may have a goroutine stuck due to the lack of listeners on a service channel | Issue resolved. | | [MB-62097](https://jira.issues.couchbase.com/browse/MB-62097) | When the pipeline is unable to start, Prometheus metrics did not capture the errors and the error state. | The Prometheus stats will now correctly indicate the error situation as in error, as well as the number of errors. | | [MB-62104](https://jira.issues.couchbase.com/browse/MB-62104) | Connectivity node status map might not be synced with cachedRefNodesList after refresh | When there is a rebalance (topology change) on the target cluster, XDCR will have an updated node list to keep track of the connectivity statuses of the target cluster nodes. | | [MB-62150](https://jira.issues.couchbase.com/browse/MB-62150) | Deadlock caused by routingUpdater when the pipeline is stopping | The fix addresses the edge case whereby the routingUpdater raises a backfill-related event that gets stuck because of a race condition with closing the replication pipeline. | | [MB-62307](https://jira.issues.couchbase.com/browse/MB-62307) | Tombstones were not replicated if a binary filter is turned on. | Issue resolved. | | [MB-62384](https://jira.issues.couchbase.com/browse/MB-62384) | In very rare situations, a document with a very large CAS could be inserted into a bucket. It is then possible for XDCR to replicate this document with malformed a CAS to other clusters. | XDCR now has a built-in guardrail to prevent documents with malformed CAS beyond a certain drift threshold from being replicated, and to notify the user if this situation occurs via the UI and logs. | | [MB-62409](https://jira.issues.couchbase.com/browse/MB-62409) | Connection pre-check uses the hostname field in remoteRef to get the target nodes information from the target cluster. The feature had the following limitations: If the input for remote reference creation is a DNS SRV, Connection pre-check directly uses the input hostname to connect to the target. Connection pre-check does not auto-check if the intent of the user is to use alternate address and alternate ports. If such a configuration is set up for the target cluster, Connection pre-check always deals with non-alternate target cluster node addresses to perform connection checks. Connection pre-check for secure connection needs 18091 (or the secure mgmt port) as input. | The limitations have been removed: Remote ref creation will now automatically resolve records before proceeding to connect. Connection pre-check can now auto-check if the intent of the user is to use alternate address and alternate ports. Connection pre-checknow uses secure or non-secure mgmt port (8091 or 18091) irrespective of the user input (even if no port is provided). | | [MB-62464](https://jira.issues.couchbase.com/browse/MB-62464) | Pre-check only captures actual errors. | Pre-check enhanced such that latency can be displayed as part of the result. A warning is displayed if the latency is too high. | | [MB-62569](https://jira.issues.couchbase.com/browse/MB-62569) | When the target cluster performs a certificate rotation after a pre-check run, the subsequent pre-check call will fail due to its caching of the old certificates | Issue resolved. | #### [](#query-service-2)Query Service | Issue | Description | Resolution | | ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | | [MB-61564](https://jira.issues.couchbase.com/browse/MB-61564) | Incorrect return code when attempting to create an index that already exists. The system returns the error: 200: index already exists. | Issue resolved: the system will now return: 409: index already exists. | | [MB-62042](https://jira.issues.couchbase.com/browse/MB-62042) | When the input to STR\_TO\_TZ has 'Z' as the time zone, the output uses an hour-only format. (e.g., STR\_TO\_TZ("2024-01-01T00:00:00Z", "America/Los\_Angeles") → "2023-12-31T16:00:00-08")In version 6 and version 7.6+ the output is "2023-12-31T16:00:00-08:00". This affects comparisons as the strings differ. | The STR\_TO\_TZ function will return the output in the correct format: (e.g., 2023-12-31T16:00:00-08:00) | | [MB-63016](https://jira.issues.couchbase.com/browse/MB-63016) | If an index is defined with a CASE statement as an index key, and the CASE statement contains a not-equal expression, and the same CASE statement is used in the projection clause of a query, then the covering index scan is not done properly. | Issue resolved: we now use covering index scan appropriately. | | [MB-63091](https://jira.issues.couchbase.com/browse/MB-63091) | When a remote operation is performed – (e.g., obtaining completed\_requests entries from remote nodes when selecting from system:completed\_requests), the constructed creds parameter isn't properly URL-encoded. | Issue resolved; parameter is encoded correctly. | | [MB-63414](https://jira.issues.couchbase.com/browse/MB-63414) | If memory\_quota is set to a value and Query uses a non-covered array index, it can result in Request has exceeded memory quota error. | Issue resolved. | #### [](#eventing-service)Eventing Service | Issue | Description | Resolution | | ------------------------------------------------------------- | -------------------------------------------------- | ---------------------------------------------------------------- | | [MB-61877](https://jira.issues.couchbase.com/browse/MB-61877) | Incorrect CRC-64 encoded value for string argument | Fixed encoding when the input string contains a null terminator. | #### [](#analytics-service)Analytics Service | Issue | Description | Resolution | | ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------- | | [MB-61493](https://jira.issues.couchbase.com/browse/MB-61493) | When the Analytics Couchbase link is recovered after encountering a failure, the link status might falsely indicate that the service is still down. | Issue resolved. | | [MB-61764](https://jira.issues.couchbase.com/browse/MB-61764) | In certain circumstances, a query can fail with an internal error during compilation when an IN clause is used in a subquery in combination with other conditions and aggregation operations. The cause of the failure is due to encountering an intermediate query plan that the compiler does not account for. | Issue resolved. | ## [](#release-725)Release 7.2.5 (April 2024) Couchbase Server 7.2.5 was released in April 2024\. This maintenance release contains new features and fixes. ### [](#new-features-725)New Features and Enhancements #### [](#xdcr-4)XDCR | Feature | Description | | -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | | [MB-60892](https://issues.couchbase.com/browse/MB-60892) | XDCR will no longer roll back to 0 due to purge sequence number moving ahead of a replication's checkpoint. | | [MB-61303](https://issues.couchbase.com/browse/MB-61303) | Once faulty remote cluster credentials are fixed, XDCR will now be able to restart replications that depend on the repaired references more quickly. | #### [](#analytics)Analytics | Feature | Description | | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | [MB-60813](https://issues.couchbase.com/browse/MB-60813) | This release adds the median function to the builtin analytics functions. See [Builtin Functions](../../current/analytics/8%5Fbuiltin.md). | #### [](#index-manager)Index Manager | Feature | Description | | -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [MB-61310](https://issues.couchbase.com/browse/MB-61310) | During rebalance, Couchbase Server tracks its progress in moving active index partitions by comparing the sequence number of partitions it has moved to the sequence numbers in a view on the original node. It did not use this technique to track the progress of copying replica partitions. This change adds an argument to the api/managerOptions REST API call named enableReplicaCatchupOnRebalance. If you set this argument to true, Couchbase Server tracks the progress of copying replica partitions the same way it tracks active partitions. Enabling this option adds some overhead to the rebalance process. | ### [](#fixed-issues-725)Fixed Issues #### [](#cluster-manager-2)Cluster Manager | Issue | Description | Resolution | | -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [MB-43772](https://issues.couchbase.com/browse/MB-43772) | The response returned by the /metrics endpoint would fail validation via promtool check due to duplicate entries. | Issue resolved. | | [MB-60568](https://issues.couchbase.com/browse/MB-60568) | When running a VM on a XEN hypervisor, metrics were computed using the number of processors configured for the entire system. | The calculation now uses the number of logical processors online on the system. This correction affects the following metrics: sys\_cpu\_host\_cores\_available sys\_cpu\_utilization\_rate sys\_cpu\_host\_utilization\_rate | | [MB-61419](https://issues.couchbase.com/browse/MB-61419) | Blocked port prevents node addition to cluster. | Added timeout on port request to prevent the addition from being blocked. | #### [](#views)Views | Issue | Description | Resolution | | -------------------------------------------------------- | ------------------------------------------------------ | --------------- | | [MB-60744](https://issues.couchbase.com/browse/MB-60744) | Unauthorized user event is not logged in the audit log | Issue resolved. | #### [](#xdcr-5)XDCR | Issue | Description | Resolution | | -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | | [MB-60326](https://issues.couchbase.com/browse/MB-60326) | XDCR pipeline shutdown is stuck, causing a resource leak. | Issue resolved. | | [MB-61208](https://issues.couchbase.com/browse/MB-61208) | The developer injection code is getting triggered because the value from the settings map is nil, and as a result, the integer value returned is -1\. This is typecast to uint32 resulting in the incorrect value | Issue resolved. | | [MB-60616](https://issues.couchbase.com/browse/MB-60616) | When goxdcr process is killed in a paused replication state, changes\_left had a negative value. | Issue resolved. | | [MB-60859](https://issues.couchbase.com/browse/MB-60859) | During target cluster rebalance, XDCR will error out with invalid packets because of vBucket movements. | Issue resolved. VBucket movements will no longer cause packet errors. | | [MB-60930](https://issues.couchbase.com/browse/MB-60930) | MergeNewTasks of backfillSpec can append a null task in the task list | XDCR backfill pipeline will not contain null tasks, avoiding unnecessary trigger of backfill pipeline. | | [MB-61295](https://issues.couchbase.com/browse/MB-61295) | When the target memcached responds with non-temporary error status codes (e.g., EINVAL), the replication gets stuck at this point, and is not flagged in the UI. | XDCR will now notify users of non-temporary errors, and their occurrence will be counted under the appropriate replication UI element. | | [MB-61414](https://issues.couchbase.com/browse/MB-61414) | JSON documents are considered invalid when there are whitespace characters at the end of the document during filtering. | JSON documents with terminating whitespaces are now processed correctly and can be replicated with advanced filtering. | #### [](#query-service-3)Query Service | Issue | Description | Resolution | | -------------------------------------------------------- | -------------------------------------------------------- | --------------- | | [MB-60294](https://issues.couchbase.com/browse/MB-60294) | COUNT(\*) on system:indexes can return incorrect results | Issue resolved. | #### [](#index-service-2)Index Service | Issue | Description | Resolution | | -------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | | [MB-60972](https://issues.couchbase.com/browse/MB-60972) | Previously, an index scan would continue reading data until it had returned at least one row of data, even if it had been canceled or had timed out. These continued reads resulted in wasted CPU resources and potentially blocking other scans from starting. | Couchbase Server now stops an index scan from reading data after it has timed out or a client cancels it even if it has not produced a row of data. | | [MB-61043](https://issues.couchbase.com/browse/MB-61043) | A rebalance followed by a failover could result in partitions not being evenly distributed across all nodes by a later rebalance. | The rebalance process now detects the partition skew and fixes it. | | [MB-61435](https://issues.couchbase.com/browse/MB-61435) | An optimization that skips key-value lookups in some cases when inserting new keys could be incorrectly enabled for all indexes in buckets containing empty indexes. This issue could result in duplicate rows being added to indexes. | The optimization is no longer incorrectly applied to indexes, and duplicate rows are no longer added to indexes. | ### [](#known-issues)Known Issues #### [](#query-service-4)Query Service | Issue | Description | Workaround | | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- | | [MB-61564](https://issues.couchbase.com/browse/MB-61564) | An attempt to create a duplicate index returns 200/index already exists instead of 409/index already exists. | If using the existing index is acceptable, no action is required. Otherwise, the existing index should be deleted before attempting to create. | ## [](#release-724)Release 7.2.4 (January 2024) Couchbase Server 7.2.4 was released in January 2024. This maintenance release contains new features and fixes. ### [](#new-features-724)New Features and Enhancements * Prometheus now records information related to disk usage over time: * REST interface added to set the retention period of audit files * In response to [CVE-2023-5363](https://nvd.nist.gov/vuln/detail/CVE-2023-5363) and [CVE-2023-5678](https://nvd.nist.gov/vuln/detail/CVE-2023-5678), OpenSSL upgraded to version 3.1.4. > [!NOTE] > This update changes the available ciphers for TLS connections. If you have not updated your client applications to use recent TLS libraries, you may experience an inability to connect and TLS handshake failures. Before upgrading, we recommend testing compatibility in a separate environment – especially if you are unsure that your platform TLS (OpenSSL, Java Secure Socket Extensions, .NET Security Provider, etc.) has compatible ciphers. * Erlang upgraded to version 25. > [!NOTE] > The Erlang upgrade requires that users have installed Couchbase Server 7.1.0 or later, before upgrading to 7.2.4\. * Added `Memcached` alert. * Power BI Connector version 1.0 released. (See the [What's New in Version 7.2](../introduction/whats-new.md#power-bi-connector-1-0-release) for details.) ### [](#cluster-manager-3)Cluster Manager | Feature | Description | | --------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [MB-59237](https://issues.couchbase.com/browse/MB-59237/) | Prometheus now records information related to disk usage over time: Cumulative number of bytes read from CB Data volume over time. Cumulative number of bytes written to CB Data volume over time. Metrics tracked in Prometheus, similar to existing system metrics. Disk queue size over time (instantaneous sample of current size) Disk read latency. | | [MB-59503](https://issues.couchbase.com/browse/MB-59503/) | You can now have Couchbase Server prune rotated audit logs after a period of time. You set how long Couchbase Server should keep audit logs by using the new pruneAge parameter for the /settings/audit endpoint. The default value of 0 means that Couchbase Server does not prune audit logs. See [Configure Auditing](../rest-api/rest-auditing.md). | ### [](#data-service-3)Data Service | Feature | Description | | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | [MB-58925](https://issues.couchbase.com/browse/MB-58925/) | Erlang has been upgraded to version 25 in Couchbase Server 7.2.4. The Erlang upgrade requires that users have installed Couchbase Server 7.1.0 or later, before upgrading to 7.2.4\. | | [MB-59261](https://issues.couchbase.com/browse/MB-59261/) | Couchbase Server now issues an alert when the number of memcached connections exceeds 90% of the limit. | ### [](#fixed-issues-724)Fixed Issues ### [](#index-service-3)Index Service | Issue | Description | Resolution | | --------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- | | [MB-59646](https://issues.couchbase.com/browse/MB-59646/) | Indexes were not correctly created on nested arrays using the FLATTEN\_KEYs function because null or missing entries were not expanded. | Issue resolved. Null or missing entries are now expanded for nested arrays | ### [](#xdcr-6)XDCR | Issue | Description | Resolution | | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [MB-58758](https://issues.couchbase.com/browse/MB-58758) | Erroneous network conditions could lead to the checkpoint manager to become slow at stopping. | Ensure the checkpoint manager stops, even if it has trouble starting due to network issues. | | [MB-59339](https://issues.couchbase.com/browse/MB-59339) | Race condition in starting and stopping XDCR source nozzle could lead to memory leak. | Fixed race condition. | | [MB-59466](https://issues.couchbase.com/browse/MB-59446) | If Bandwidth Throttler is used, race condition may occur during pipeline shutdown where Out nozzle is unable to exit. | Fixed race condition during shutdown to ensure out nozzle closes properly. | | [MB-59476](https://issues.couchbase.com/browse/MB-59476) | Remote Cluster Service may be stuck and unable to update references modified by another node in the cluster | Resync will take place if remote cluster metadata is out of sync to prevent references from being stuck and becoming stale. | | [MB-59624](https://issues.couchbase.com/browse/MB-59624) | In low-priority replications, it is possible for a Data Service stream to end temporarily, which may not be handled correctly by XDCR, leading to hung replication. | XDCR will restart the pipeline if a data service stream is ended. This will ensure that replication will continue. | | [MB-59703](https://issues.couchbase.com/browse/MB-59703) | If a replication is idle without mutations, XDCR is unable to detect that a target bucket failover occurred. | Ensure target-side failover detection takes place even if the source has no incoming mutations. | | [MB-59850](https://issues.couchbase.com/browse/MB-59850) | In a slow running backfill replication, XDCR could be too aggressive in restarting pipelines. | Ensure XDCR does not restart backfill pipelines if some progress is observed periodically | | [MB-59888](https://issues.couchbase.com/browse/MB-59888) | When a target document is locked, and a non-optimistic LWW replication is taking place, XDCR will retrieve a locked CAS of maxUint. This will cause the source mutation to always lose, and lead to scenarios where a source mutation is not replicated even if it should have won conflict resolution. | XDCR will retry conflict resolution for the duration that the document is locked in a pessimistic replication, to ensure that a valid CAS is used for source-side conflict resolution. | ### [](#query-service-5)Query Service | Issue | Description | Resolution | | --------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [MB-57903](https://issues.couchbase.com/browse/MB-57903/) | When a query has nested correlation references, e.g., query1 contains a subquery query2, which in turn contains another subquery query3, and query3 is correlated with query1 (but query2 is not correlated), the nested correlation is not properly detected and the subquery (query2) is not properly marked as correlated. | Correlation references are detected and marked in different levels of sub-queries. Nested correlation references are properly propagated up such that all sub-queries are properly marked when correlated. | | [MB-58648](https://issues.couchbase.com/browse/MB-58648) | Prepared statement with a user-defined function can lead to a memory leak. Caused by the UDF being reloaded. | Issue resolved. | ### [](#known-issues-724)Known Issues #### [](#query-service-6)Query Service | Issue | Description | Workaround | | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- | | [MB-61564](https://issues.couchbase.com/browse/MB-61564) | An attempt to create a duplicate index returns 200/index already exists instead of 409/index already exists. | If using the existing index is acceptable, no action is required. Otherwise, the existing index should be deleted before attempting to create. | ## [](#release-723)Release 7.2.3 (November 2023) Couchbase Server Release 7.2.3 was released in November 2023 > [!IMPORTANT] > **Fixed Security Vulnerabilities** > > For complete details of fixed security vulnerabilities in Couchbase Enterprise Server, see the [Enterprise Security Alerts page](https://www.couchbase.com/alerts/). This release contains: * Fixes to issues ### [](#fixed-issues-4)Fixed Issues ### [](#xdcr-7)XDCR | Issue | Description | Resolution | | -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- | | [MB-59339](https://issues.couchbase.com/browse/MB-59339) | DCP nozzle race would leave gomemcached feed running and leak memory.Normally, if DCP nozzles are started and then stopped in sequence, there shouldn't be any UprFeed leaks. Hard-coded testing resulted in situations indicating that the leaking gomemcached feed wasn't closed. | Fixed: the feed is correctly synchronized and closed. | ## [](#release-722)Release 7.2.2 (September 2023) Couchbase Server 7.2.2 was released in September 2023 > [!IMPORTANT] > **Couchbase release 7.2.1 is no longer available for download.** > Customers upgrading from 7.2.0 should upgrade to 7.2.2, which contains all 7.2.1 fixes and several additional critical fixes. This release contains: * Fixes to issues ### [](#fixed-issues-5)Fixed issues #### [](#analytics-service-2)Analytics Service | Issue | Description | Resolution | | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [MB-58694](https://issues.couchbase.com/browse/MB-58694) | Some DCP messages were unnecessarily processed multiple times.In addition, if the Analytics Service had high CPU usage, unnecessary flushes of DCP state to storage could occur; this also contributed to additional high CPU usage. | DCP messages are now processed once, regardless of the configured dcpIdleQueueFlushThresholdMillis.High CPU usage will not trigger unnecessary flushes of DCP state. | | [MB-58723](https://issues.couchbase.com/browse/MB-58723) | Frames that contain only DCP data were unnecessarily processed by the complete ingestion pipeline, resulting in performance degradation. | The complete ingestion pipeline no longer processes frames that only contain DCP data.Instead, they are processed specifically by the ingestion operators that update DCP metadata, resulting in better performance. | #### [](#search-service)Search Service | Issue | Description | Resolution | | -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | | [MB-58450](https://issues.couchbase.com/browse/MB-58450) | An issue occurred with a node failover.If a user did not bring in a replacement node before the failover occurred, then lost active or lost replica search indexes that had partitions on the replaced node were not rebuilt. As a result, search requests returned partial/incomplete results. In addition, existing indexes with defined replica(s) became vulnerable to potential node failures. This issue is only pertinent to the 7.2.1 release, and does not affect older builds. | During rebalancing, a check is now made for missing partitions.If missing partitions are found, they are rebuilt before the rebalance is complete. | ## [](#release-721)Release 7.2.1 (September 2023) > [!IMPORTANT] > **Couchbase release 7.2.1 is no longer available for download.** > Customers upgrading from 7.2.0 should upgrade to 7.2.2, which contains all 7.2.1 fixes and several additional critical fixes. Couchbase Server 7.2.1 was released in September 2023. This release contains: * New features * Enhancements * A list of future reserved words in an upcoming Server release * Newly supported platforms * Fixes to issues ### [](#new-features)New Features This release includes the following new features. #### [](#xdcr-8)XDCR The following XDCR features are new: * XDCR replications, specified by means of the REST API, can now use the `filterBinary` flag. This specifies whether binary documents should be replicated. Detailed information on the [filterBinary flag](../rest-api/rest-xdcr-create-replication.md#filter-binary) is provided on the REST reference page, [Creating a Replication](../rest-api/rest-xdcr-create-replication.md). * Using the REST API, node-connectivity can now be checked, prior to the creation of an XDCR reference. See [Checking Connections](../rest-api/rest-xdcr-connection-precheck.md). * In Couchbase Server Version 7.2.1 and later, XDCR provides enhanced information on cluster-rebalance status. See [Rebalance Information](../manage/manage-xdcr/create-xdcr-replication.md#rebalance-information) ### [](#enhancements)Enhancements This release includes the following enhancements: * Bloom filters for the Indexing Service were not previously enabled by default. Bloom filters are now enabled by default. This change reduces the Index Service disk lookups when there are insert heavy workloads. Bloom filters are used by the index storage layer to reduce the disk i/o and improve the overall efficiency of the index service. You can disable bloom filters and opt out. ### [](#future-reserved-words)Future Reserved Words To give you enough time to prepare ahead, we are going to add the following reserved words for features in an upcoming Couchbase Server release: * SEQUENCE * CACHE * RESTART * MAXVALUE * MINVALUE * NEXT * PREV * PREVIOUS * NEXTVAL * PREVVAL * CYCLE * RECURSIVE * RESTRICT No action is required for upgrading to Server 7.2.1. ### [](#new-supported-platforms)New Supported Platforms See [Supported Platforms](../install/install-platforms.md) for the complete list of supported platforms. This release adds support for the following new platforms: * Alma Linux 9 * Rocky Linux 9 ### [](#fixed-issues-6)Fixed Issues This release contains the following fixes. #### [](#analytics-service-3)Analytics Service | Issue | Description | Resolution | | -------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [MB-56957](https://issues.couchbase.com/browse/MB-56957) | External collections could not be created using Azure Managed Identity. | Azure dependencies have been updated to correct this issue. | | [MB-57588](https://issues.couchbase.com/browse/MB-57588) | Query results could be unnecessarily converted twice to JSON when documents were large. | The Query result is now converted to JSON once for all documents. | | [MB-57615](https://issues.couchbase.com/browse/MB-57615) | When the Prometheus stats returned from Analytics exceeded four kilobytes, the status code was inadvertently set to 500 (Internal Error), and this resulted in a large number of warnings in the Analytics warning log. Couchbase Server discarded these statistics. | This has been fixed to properly return a 200 (OK) status code when the size of Prometheus stats exceeds 4KiB, allowing these stats to be recorded properly. The warning is not displayed. | #### [](#data-service-4)Data Service | Issue | Description | Resolution | | -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- | | [MB-39344](https://issues.couchbase.com/browse/MB-39344) | The last item in a replica checkpoint was not expelled. In scenarios such as large average item size, high numbers of replicas or low Bucket quota could result in a data-node entering an unrecoverable Out-of-Memory state. | ItemExpel has been enhanced to release all the items in a checkpoint when memory conditions allow. | | [MB-56084](https://issues.couchbase.com/browse/MB-56084) | A rollback loop affected legacy clients when collections were used and a tombstone newer than the last mutation in the default collection was purged. | The lastReadSeqno is now Incremented when the client is not collection-aware. | | [MB-56644](https://issues.couchbase.com/browse/MB-56644) | In rare cases, after a failover or memcached restart, a replica rollback while under memory pressure might have caused a crash in the Data Service. | Memory pressure recovery logic (Item expelling) is now skipped when replica rollback is in progress. | | [MB-56970](https://issues.couchbase.com/browse/MB-56970) | XDCR or restore from backup entered an endless loop if attempting to overwrite a document which was deleted or expired some time ago with a deleteWithMeta operation. This was due to a specific unanticipated state in memory which increased CPU usage, and connection became unusable for further operations. | deleteWithMeta is now resilient to temporary non-existent values with xattr datatype. | | [MB-57002](https://issues.couchbase.com/browse/MB-57002) | When using .NET SDK on Windows 10 client and client certs were enabled on CB Server, the Data-Service did not establish a connection and client bootstrap failed with a OpenSSL "session id context uninitialized" error. | Data-Service has been updated to disable TLS session resume. | | [MB-57064](https://issues.couchbase.com/browse/MB-57064) | GET\_META requests for deleted items fetched metadata in memory which was not evicted in value-eviction buckets. | Metadata items are now cleaned when the expiry pager runs. | | [MB-57106](https://issues.couchbase.com/browse/MB-57106) | DCP clients streamed in out-of-sequence-order \[OSO\] backfill snapshots under Magma observed duplicate documents received in the disk snapshot. This happened where the stream was paused and resumed when the resume point was wrongly set to a key already processed in the stream. | OSO backfill in Magma now sets the correct resume point after a pause. | | [MB-57304](https://issues.couchbase.com/browse/MB-57304) | Data Service rebalance duration was significantly impacted if other DCP clients created a large number of Streams, if those streams needed to be read from disk, due to the lack of prioritizing between rebalance and other DCP clients. | The number of backfills each DCP client can perform concurrently has been limited to allow fairer allocation of resources. | | [MB-57400](https://issues.couchbase.com/browse/MB-57400) | The computation count for the items remaining DCP/Checkpoint stats exposed to Prometheus was the O(N) function. Where N is the number of items in a checkpoint. This caused various performance issues including Prometheus stats timeouts when checkpoints accumulated a high number of items. | The computation count has been optimized and now is O(1). | | [MB-57609](https://issues.couchbase.com/browse/MB-57609) | A spurious auto-failover could happen when Magma compaction visited a TTL'd document that was already deleted. | Document not found does not now increment the number of read failures. | #### [](#index-service-4)Index Service | Issue | Description | Resolution | | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [MB-56339](https://issues.couchbase.com/browse/MB-56339) | During scaling, an GSI indexer rebalance froze and did not successfully complete. This was because an index snapshot was not correctly deleted and recreated. | A flag now handles snapshots to ensure they are correctly deleted or recreated when indexes are updated during rebalancing. | | [MB-57021](https://issues.couchbase.com/browse/MB-57021) | When alter index updated the replica count, new replicas were not built immediately when the original definition was {defer\_build: true}. Existing replicas were built and new replicas were built in the next processing iteration. | New replicas are now built when the replica count is updated for deferred indexes. The status of existing index instances is checked, and if ready, a new build of the instance is triggered. | | [MB-57777](https://issues.couchbase.com/browse/MB-57777) | When the indexer was unable to keep up with KV mutations, and there was a queue of mutations within the indexer, there was a large memory overhead from the bookkeeping of queued up mutations. | Indexer has been improved to optimize memory usage so that the bookkeeping overhead is reduced for queued up mutations. | #### [](#query-service-7)Query Service | Issue | Description | Resolution | | -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | | [MB-56533](https://issues.couchbase.com/browse/MB-56533) | Due to how nested dependencies were handled, a sudden rise in memory utilization of the query service on a node caused a memory alert issue. The node did not recover correctly following a restart. | Nested dependencies are now handled appropriately in the ADVISE statement. | | [MB-56563](https://issues.couchbase.com/browse/MB-56563) | A query with multiple filters on an index key, one of which was a parameter, could produce incorrect results. This was caused by incorrectly composing the exact index spans to support the query. | The way in which exact spans are set has been modified to correct this issue. | | [MB-56579](https://issues.couchbase.com/browse/MB-56579) | Covering FLATTEN\_KEYS() on an array index generated incorrect results. This was because a modified version of the ANY clause was applied after the index which meant false positives were retained and Distinct scan rows were eliminated. | The ANY filter is now applied on an index scan itself when covering an index scan with flatten keys. | | [MB-56683](https://issues.couchbase.com/browse/MB-56683) | Inter-service read timeout errors were not detected or handled accordingly. User requests consequently failed with timeout errors without retrying with a new connection. | The error handling and retry mechanism has been modified to handle these types of timeout issues and errors. | | [MB-56727](https://issues.couchbase.com/browse/MB-56727) | Under certain circumstances, a query with UNNEST used a covering index scan and incorrect results were returned. Reference to the UNNEST expression should have prevented the covering index from being used for the query as the index did not contain the entire array. | The logic to determine covering UNNEST scans has been changed to not use a covering index scan for such queries. | | [MB-56937](https://issues.couchbase.com/browse/MB-56937) | When an index scan had multiple spans, index selectivity was incorrectly calculated. | Index selectivity for multiple index spans is now correctly calculated. | | [MB-57024](https://issues.couchbase.com/browse/MB-57024) | Incorrect results were returned for a non-IndexScan on a constant false condition. This was due to incorrect handling of a FALSE WHERE clause. | The FALSE WHERE clause is now correctly handled. | | [MB-57029](https://issues.couchbase.com/browse/MB-57029) | Querying system:functions\_cache in a multi query node cluster returned incomplete results with warnings. The query result included entries in the local query node, but none from remote query nodes. This was due to a typographical error. | The typographical error has been corrected. | | [MB-57080](https://issues.couchbase.com/browse/MB-57080) | A panic in go\_json.stateInString under parsed value functions caused by incorrect concurrent access resulted in the state being freed whilst still in use. | The concurrent access issue has been resolved. | | [MB-57251](https://issues.couchbase.com/browse/MB-57251) | A Prepared statement might have resulted in an incorrect result in a multi-node environment. For example, a database with two query nodes. | Correlated subqueries from an encoded plan are now detected and marked. This ensures correct results are provided. | | [MB-57279](https://issues.couchbase.com/browse/MB-57279) | When a WITH clause (common table expression, or CTE) was used inside a subquery, and the WITH clause definition referenced the parent query, and was correlated, the query engine did not properly detect the correlation. This produced an incorrect result from the WITH clause evaluation because the result was not cached correctly. | Correlations inside WITH clause definitions are now properly detected. | | [MB-57316](https://issues.couchbase.com/browse/MB-57316) | cbq required a client authentication key file whenever a certificate authority file was used. | cbq now accepts a certificate authority file without a client key file enabling use with username and password credentials. | | [MB-57680](https://issues.couchbase.com/browse/MB-57680) | When appropriate optimizer statistics were used in Cost-Based Optimizer (CBO), for a query with ORDER BY, if there were multiple indexes available for the query, CBO unconditionally favored an index that provided ordering. Such indexes were not always the best ones to use. | CBO now allows cost-based comparison of indexes. | | [MB-57838](https://issues.couchbase.com/browse/MB-57838) | An ADVISE statement with multiple levels of UNNEST caused a syntax error in the CREATE INDEX statement from the Index Advisor. | ADVISE has been improved when there are queries with multiple levels of UNNEST. | #### [](#cluster-manager-4)Cluster Manager | Issue | Description | Resolution | | -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | [MB-57484](https://issues.couchbase.com/browse/MB-57484) | A Cluster Manager process crash meant the Delete Bucket memcached command was not always called before bucket files were deleted later in rebalance. This caused the memcached process to crash repeatedly causing data service downtime. | The Delete Bucket command is now called on memcached before a file is deleted during rebalance. This ensures mencached doesn't attempt to read the files. | #### [](#cross-datacenter-replication-xdcr)Cross Datacenter Replication (XDCR) | Issue | Description | Resolution | | -------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [MB-56601](https://issues.couchbase.com/browse/MB-56601) | Data streamed from the Data Service over XDCR should always be streamed in order by mutation id. However, in some scenarios, for efficiency, the Data Service streamed records that were not ordered by mutation id. In certain situations, this out-of-sequence-order \[OSO\] caused performance issues. | OSO mode is now available as a global override to be switched off for any currently deployed replications to avoid performance issues. | | [MB-56711](https://issues.couchbase.com/browse/MB-56711) | XDCR did not process documents with a JSON array and Extended Attributes (XATTRs). When a document contained XATTRs, XDCR checked for XATTRs in transactions, transaction filters were enabled, and XATTRs were not checked. | When documents contain arrays, XATTRs are now checked in the transaction XATTRs, and the document is not prevented from being parsed in an array. | | [MB-56741](https://issues.couchbase.com/browse/MB-56741) | Binary documents were replicated when an Advanced Filtering Expression was present. | A filter has been added which can be turned on to prevent all binary documents from being replicated. | | [MB-56773](https://issues.couchbase.com/browse/MB-56773) | It appeared that XDCR had stalled and an explanation was not provided. For rebalances on the source or target, the XDCR pipeline should be restarted, and data movement should continue. Before the pipeline was restated, there might have been fewer data movements as the rebalanced VBs were no longer streaming. | An ETA is now provided in the Server UI to show when the pipeline is due to be restarted. | | [MB-56799](https://issues.couchbase.com/browse/MB-56799) | Checkpoint Manager created checkpoint records out-of-sequence when many target nodes ran slowly. | Checkpoint Manager now creates checkpoints in sequence when target nodes are slow. | | [MB-56848](https://issues.couchbase.com/browse/MB-56848) | The bucket topology service sent a concurrent map iteration and map write panic to XDCR which caused a fatal error. | Validation has been improved to prevent the panic from happening. | | [MB-56938](https://issues.couchbase.com/browse/MB-56938) | Prometheus stats did not include a pipeline's status. | The pipeline status is now provided as part of a prometheus stat. | | [MB-57130](https://issues.couchbase.com/browse/MB-57130) | A Checkpoint Manager Initialization error caused two memory leak types. These were a backfill pipeline and a main pipeline memory leak. | The Pipeline Manager and backfill pipeline have both been modified to prevent the memory leaks. | | [MB-57183](https://issues.couchbase.com/browse/MB-57183) | XDCR Checkpoint Manager instances were not cleaned up under certain circumstances due to timing and networking issues when contacting target, or when an invalid backfill task was fed in as input. | Checkpoint Manager instances are now cleaned up. A flag has been added to check for invalid backfill tasks. | | [MB-57234](https://issues.couchbase.com/browse/MB-57234) | When a replication spec change was made to a non-Data Service node, delete replication hung and caused the node to return an incorrect replication configuration. | XDCR now checks that the node is running the Data Service and handles it correctly. | | [MB-57277](https://issues.couchbase.com/browse/MB-57277) | XDCR could fail due to multiple connection issues. For example, DNS issues or firewalls. For a number of databases, it was a difficult task to manually check every node to determine where the connection issue was. For multiple nodes in a database and in the target database, debugging the issue required many connection checks. | A connection pre-check feature has been added to XDCR which ensures all connections from source nodes to target nodes are valid. Credentials are now also checked. | | [MB-57412](https://issues.couchbase.com/browse/MB-57412) | Running ipv6 only mode + non-encrypted remote resulted in invalid IP addresses being returned, leading to connection issues. | A valid IP address is now returned. | | [MB-57462](https://issues.couchbase.com/browse/MB-57462) | StatsMgr stopping could hang due to watching for notifications resulting in stranded go-routines. | Go-routines are now stopped correctly. | | [MB-57562](https://issues.couchbase.com/browse/MB-57562) | When ipv4 only mode was used, and full encryption only had an alternate address configured where the internal address was unresolvable, XDCR resulted in an error when it contacted the target data nodes. | The specific scenario has been fixed so that replication can now proceed. | | [MB-57743](https://issues.couchbase.com/browse/MB-57743) | The Prometheus endpoint did not expose any XDCR error metrics. | XDCR error metrics are now exposed via Prometheus. | | [MB-57787](https://issues.couchbase.com/browse/MB-57787) | A legacy race condition where metadata store could cause a conflict was exposed as part of the binary filter improvements. | Legacy race conditions have all been resolved. | | [MB-58203](https://issues.couchbase.com/browse/MB-58203) | Under certain circumstances, when rebalancing, the target cluster could return an EACCESS error code that caused source XDCR to pause the pipeline. | This has been reversed. Instead of pausing the pipeline when rebalancing, XDCR now retries when an EACCESS error is encountered in XmemNozzle. XDCR counts and prints this activity in the log. | | [MB-58545](https://issues.couchbase.com/browse/MB-58545) | Checkpoint Manager could be stuck when stopping if it had not been started yet, resulting in memory leak. | Checkpoint Manager can now be stopped correctly even when it hasn't been started. | #### [](#metrics-and-monitoring)Metrics and Monitoring | Issue | Description | Resolution | | -------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | | [MB-56464](https://issues.couchbase.com/browse/MB-56464) | An issue occurred where the Cluster Manager instructed Prometheus to reload the configuration and the reload timeout impacted other requests. | The Cluster Manager has been improved to handle timeouts when instructing Prometheus to reload the configuration. | | [MB-56517](https://issues.couchbase.com/browse/MB-56517) | The Cluster Manager's computed utilization stats were inaccurate due to time interval discrepancies in components where data was collected. | The Cluster Manager now reports raw stats as Prometheus counters. | #### [](#storage)Storage | Issue | Description | Resolution | | -------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [MB-57157](https://issues.couchbase.com/browse/MB-57157) | Inconsistencies were observed where a single Magma bucket in a database took a long time to warm up. | The seq index scan has been optimized for tombstones of zero value size. Optimization is for look up by key, sequence iteration, and key iteration. Docs of 0 value size are placed in both key index and seq index. | | [MB-57714](https://issues.couchbase.com/browse/MB-57714) | Disk backfills were hanging permanently due to high memory consumption when large documents were streamed over many DCP streams concurrently. | Memory for a document read by a DCP stream is now released before switching to another stream. | ### [](#known-issues-721)Known Issues #### [](#search-service-2)Search Service | Issue | Description | Workaround | | -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [MB-58450](https://issues.couchbase.com/browse/MB-58450) | An issue occurs with node failover. If a user does not bring in a replacement node before the failover occurs, then lost active or lost replica search indexes that have partitions on the replaced node are not rebuilt.As a result, search requests return partial/incomplete results. In addition, existing indexes with defined replica(s) become vulnerable to another node failure. This issue is only pertinent to the **7.2.1** release, and does not affect older builds. | This situation can be prevented if a replacement node was brought into the cluster in place of the failed over node, before starting the rebalance operation. This problem should not affect on-line or off-line rebalances. If lost indexes are encountered, then, a manual update to the affected search index definition(s) will trigger a rebuild of the affected indexes.(The advice here is to toggle the replica count so that unaffected index partitions are re-used, and only the lost partitions are rebuilt.) | ## [](#release-720)Release 7.2 ### [](#new-features-and-enhancements)New Features and Enhancements ### [](#new-features-720)What's new in 7.2 * The following new platforms are supported: * Red Hat Enterprise Linux 9 * Oracle Linux 9 * SUSE Enterprise Linux 12 * SUSE Enterprise Linux 15 * Ubuntu 20 LTS (ARM64) * Ubuntu 22 LTS (x86, ARM64) * Amazon Linux 2023 (x86, ARM64) * macOS 12 Apple Silicon See [Supported Platforms](../install/install-platforms.md) for the complete list of supported platforms, and notes on deprecated platforms. * _New stats added:_ | cm\_auto\_failover\_count | The number of auto-failovers that have occurred. | | ------------------------------ | ----------------------------------------------------------- | | cm\_auto\_failover\_enabled | Indicates if auto-failover is enabled (1 = true, 0 = false) | | cm\_auto\_failover\_max\_count | The maximum number of auto-failovers before being disabled | Each stat contains a label named event (`initiated`, `completed`,`failed`, and `stopped`) and the number of occurrences for the labeled event. * _Examples added to Tools package._ The documentation references code examples built with the `cbq` command line tool. Since the examples are also used by Capella users, the `cbq` tool is now part of the tools package. * _Cost Based Optimizer for Analytics_ (_CBO_). The cost-based optimizer for Analytics chooses the optimal plan to execute an Analytics query. The cost-based optimizer gathers and utilizes samples from Analytics collections, and then queries the samples at query planning time to estimate the cost of each operation. The Analytics Service introduces new syntax for managing samples, and provides parameters and hints to help specify the behavior of the cost-based optimizer. See [Cost-Based Optimizer for Analytics](../analytics/5b%5Fcbo.md). * _Time Series Queries_. Time series data is any data which changes over time. It is usually collected frequently, in regular or irregular intervals, from a device or a process. The Query Service provides a standard format for time series data, which promotes compact storage and quick processing, and introduces a \_TIMESERIES function to query time series data. See [Time Series Data](../n1ql/n1ql-language-reference/time-series.md) and the [\_TIMESERIES Function](../n1ql/n1ql-language-reference/timeseries.md). * _Change History_. A change history can be maintained for collections in a bucket. Changes to documents within the collections are included in the change history. A maximum size for the change history can be specified in bytes or seconds. See [Change History](../learn/data/change-history.md). For information on establishing change-history default settings, at bucket-creation time, see [Creating and Editing Buckets](../rest-api/rest-bucket-create.md). For information on switching the change history on or off for a specific collection, see [Creating and Editing a Collection](../rest-api/creating-a-collection.md). To examine the change-history status for each collection in a bucket, see the [collections](../cli/cbstats/cbstats-collections.md) option for `cbstats`. To read the change history, use the [Kafka 4.1 Connector](#4.1@kafka-connector::index.adoc). * New alerts are provided for _change-history size threshold_ and _Index Service low residence threshold_. See [Setting Alerts](../rest-api/rest-cluster-email-notifications.md). * You can now configure block size for _Magma_ storage when you create a bucket. See [Creating and Editing Buckets](../rest-api/rest-bucket-create.md). * New metrics are provided for tracking XDCR _conflict resolution_ on the target cluster. See [Monitoring Conflict Resolution on the Target Cluster](../learn/clusters-and-availability/xdcr-conflict-resolution.md#monitoring-conflict-resolution). * Couchbase Server now checks node certificates to ensure a node-name is correctly identified with a Subject Alternative Name (SAN) when certificates are uploaded and when a node is added or joins a cluster. See [Node-Certificate Validation](../learn/security/certificates.md#node-certificate-validation). * The Analytics Service now supports external datasets on _Google Cloud Platform_ (GCP) storage. You can manage these datasets using the UI or the Analytics Links REST API. See [Managing Links](../analytics/manage-links.md) and [Analytics Links REST API](../analytics/rest-links.md). * When connecting from an external network, you can now use the `network=external` option to specify an alternate address when using `cbbackupmgr`, `cbimport`, and `cbexport`. See **Host Formats** information in [cbbackupmgr](../backup-restore/cbbackupmgr.md), [cbimport](../tools/cbimport.md), and [cbexport](../tools/cbexport.md). * You can now download the `cbbackupmgr`, `cbimport`, and `cbexport` tools from a tools package. This enables developers or testers to use the tools from machines on which Couchbase Server is not installed. See [Server Tools Packages](../cli/cli-intro.md#server-tools-packages). * _Capella_ databases use Certificate Authorities (CAs), to establish secure connections: these CAs are now automatically trusted when you use Couchbase Web Console or the REST API to establish _fully secure_ XDCR connections between Capella databases and Couchbase Enterprise Server 7.2+. See [Capella Trusted CAs](../manage/manage-xdcr/secure-xdcr-replication.md#capella-trusted-cas). * Couchbase Server has a new service discovery endpoint to help you configure the Prometheus event monitoring system. The old endpoint, named `/prometheus_sd_config.yaml` is now deprecated. The new endpoint is able to produce the same output as the old endpoint and has additional features. See [Configure Prometheus to Collect Couchbase Metrics](../manage/monitor/set-up-prometheus-for-monitoring.md). * You can now have Couchbase Server prune rotated audit logs after a period of time. You set how long Couchbase Server should keep audit logs by using the new `pruneAge` parameter for the `/settings/audit` endpoint. The default value of 0 means that Couchbase Server does not prune audit logs. See [Configure Auditing](../rest-api/rest-auditing.md). * Power BI Connector version 1.0 released. ([Power BI Connector documentation](../../../power-bi-connector/current/index.md)) You can download the installation package from the following location: | Binaries | [powerbi-connector-1.0.mez](https://packages.couchbase.com/releases/couchbase-powerbi-connector/1.0/couchbase-powerbi-connector-1.0.mez) | | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | Binaries SHAs | [powerbi-connector-1.0.mez.sha256](https://packages.couchbase.com/releases/couchbase-powerbi-connector/1.0/couchbase-powerbi-connector-1.0.mez.sha256) | * The new cluster-wide `enableReplicaCatchupOnRebalance` option lets you make the rebalance process track its progress when copying FTS replica index partitions the same way it tracks active partitions. See [enableReplicaCatchupOnRebalance](../fts/fts-advanced-settings-enableReplicaCatchupOnRebalance.md) for more information. * The _Search service_ now supports IP addresses as indexable types. ### [](#deprecated-features-and-platforms-720)Deprecated and Removed Features and Platforms * The following operating systems are no longer supported: * SUSE Linux Enterprise Server 12 versions earlier than SP2 * MacOS 10.15 Catalina * RHEL 7 * CentOS 7 * Oracle Linux 7 * Ubuntu 18 LTS * SUSE Linux Enterprise Server Version 12 is deprecated. * MacOS 11 Big Sur is deprecated. * Debian 10 is deprecated. See [Supported Platforms](../install/install-platforms.md) for the complete list of supported platforms. * TLS 1.0 and 1.1 are deprecated. See [Establishing the Minimum TLS-Version](../learn/security/on-the-wire-security.md#min-tls-version). ### [](#fixed-issues-720)Fixed Issues This release contains the following fixes. #### [](#cluster-manager-5)Cluster Manager | Issue | Description | | -------------------------------------------------------- | --------------------------------------------------------------------------------- | | [MB-54396](https://issues.couchbase.com/browse/MB-54396) | Reporting wrong fragmentation and data size stats. | | [MB-55769](https://issues.couchbase.com/browse/MB-55769) | Buckets page should load even if the browser machine is slow or bandwidth is low. | #### [](#cross-datacenter-replication-xdcr-2)Cross Datacenter Replication (XDCR) | Issue | Description | | -------------------------------------------------------- | ---------------------------------------------------------------------------- | | [MB-53065](https://issues.couchbase.com/browse/MB-53065) | Prolonged TMPFAIL or ENOMEM causes memory bloat. | | [MB-54332](https://issues.couchbase.com/browse/MB-54332) | Inter Cluster XDCR failing in Server 7.1.2 and Capella. | | [MB-55060](https://issues.couchbase.com/browse/MB-55060) | XDCR on non-KV node freezes when replication settings changed several times. | #### [](#query-service-8)Query Service | Issue | Description | | -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | | [MB-54034](https://issues.couchbase.com/browse/MB-54034) | Display the number of uses for prepared statements accurately. | | [MB-54040](https://issues.couchbase.com/browse/MB-54040) | \[SQL++\] insert does not trigger a memory quota exceeded. | | [MB-54043](https://issues.couchbase.com/browse/MB-54043) | Potential for request stall if stream operator fails to notify request that it has terminated. | | [MB-54044](https://issues.couchbase.com/browse/MB-54044) | Optimizer hints are not displayed in EXPLAIN statements for subqueries. | | [MB-54326](https://issues.couchbase.com/browse/MB-54326) | Disable impersonate if KV node does not support collections to prevent Query service errors when upgrading from 6.6.5. | | [MB-54514](https://issues.couchbase.com/browse/MB-54514) | ORDER BY after UNION requires explicitly aliased terms. | | [MB-54596](https://issues.couchbase.com/browse/MB-54596) | Covered FTS SEARCH() with memory\_quota fails. | | [MB-54705](https://issues.couchbase.com/browse/MB-54705) | Active requests and queued requests in SQL++ metrics are gauges, not counters. | | [MB-55864](https://issues.couchbase.com/browse/MB-55864) | Memory exceeded quota error with ARRAY\_AGG. | | [MB-57215](https://issues.couchbase.com/browse/MB-57215) | OBJECT\_ functions may return incorrect results. | #### [](#index-service-5)Index Service | Issue | Description | | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | | [MB-54348](https://issues.couchbase.com/browse/MB-54348) | When an index drop is immediately followed by bucket delete, the indexer can deadlock when a rare race condition occurs. | | [MB-55195](https://issues.couchbase.com/browse/MB-55195) | A scanning issue occurs when an index is on a node and the replica index is on a different node. | | [MB-55216](https://issues.couchbase.com/browse/MB-55216) | Index build hangs in mixed mode when the projector skips transaction records. | | [MB-55217](https://issues.couchbase.com/browse/MB-55217) | Index build stuck on "Check pending stream" during shard rebalance testing. | | [MB-55228](https://issues.couchbase.com/browse/MB-55228) | Report aggregated node level statistics information using prometheus. | | [MB-55218](https://issues.couchbase.com/browse/MB-55218) | Use streamId instead of index.Stream to determine stream catchup pending. | | [MB-55243](https://issues.couchbase.com/browse/MB-55243) | cbindex did not execute the build index and the performance test is stuck. | | [MB-55246](https://issues.couchbase.com/browse/MB-55246) | Change log level when using watchers to connect to indexer services in a cluster. | | [MB-55248](https://issues.couchbase.com/browse/MB-55248) | "FlushTs Not Snapshot Aligned" message incorrectly displayed in Log multiple times. | | [MB-55312](https://issues.couchbase.com/browse/MB-55312) | Nil value in the Node table causes a panic issue in the logs. | | [MB-55512](https://issues.couchbase.com/browse/MB-55512) | Orphaned watcher background thread in logs following a Server upgrade. | | [MB-55517](https://issues.couchbase.com/browse/MB-55517) | RedistributeIndexes flag should consider partitioned and non-partitioned indexes. | #### [](#storage-2)Storage | Issue | Description | | -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | | [MB-55426](https://issues.couchbase.com/browse/MB-55426) | Address plasma RP Version 16 bit overflow, and recovery and data logs. | | [MB-56016](https://issues.couchbase.com/browse/MB-56016) | Ensure rows that were previously compacted do not return when a crash and recovery occurs in the Magma storage engine. | #### [](#eventing-service-2)Eventing Service | Issue | Description | | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | [MB-53270](https://issues.couchbase.com/browse/MB-53270) | Use "\_txn:" so the Eventing service detects and rejects transaction documents. | | [MB-53393](https://issues.couchbase.com/browse/MB-53393) | Restoring Eventing Functions to new scope in the same bucket upgrades and overwrites the admin or global Function Scope. | | [MB-54315](https://issues.couchbase.com/browse/MB-54315) | Running "advancedGetOpWithCache" returns an incorrect meta.id on the second call when accessing a document twice. | | [MB-55193](https://issues.couchbase.com/browse/MB-55193) | FunctionOverload parser results in false positives when it incorrectly flags function names with reserved function names as their prefix. | | [MB-56748](https://issues.couchbase.com/browse/MB-56748) | Eventing Bucket Backed Cache in the Advanced Accessor couchbase.get() not efficient for very large documents. The final implementation returns small documents with a speed up is 20-25X while large documents are returned with a speed up of 400-500X when using {"cache": true}. | | [MB-56749](https://issues.couchbase.com/browse/MB-56749) | Eventing writes to the wrong keyspace (\_default.\_default) if the collection name is long (over 30 characters). | | [MB-56750](https://issues.couchbase.com/browse/MB-56750) | As of 7.2, the curl() call no longer performs URL encoding. Older functions with a language compatibility of 6.6.2 still work. In some cases, an eventing function created in 7.1 might require a parameter added to the curl() call "url\_encode\_version": "7.1.0" as the 7.1 release changed the 6.6.2 URL encoding method. | #### [](#backup-service)Backup Service | Issue | Description | | -------------------------------------------------------- | --------------------------------------------------------------------- | | [MB-54549](https://issues.couchbase.com/browse/MB-54549) | Backup and restore fails when a bucket name contains a "." character. | #### [](#views-2)Views | Issue | Description | | -------------------------------------------------------- | ---------------------------------------------------------------------------------- | | [MB-53646](https://issues.couchbase.com/browse/MB-53646) | View engine queries should filter out transaction documents inserted into buckets. | | [MB-54172](https://issues.couchbase.com/browse/MB-54172) | Ensure all data is returned when DCP stream starts in disk-only mode. | | [MB-54173](https://issues.couchbase.com/browse/MB-54173) | Handle json and raw compressed XATTR document types in the View engine. | ### [](#known-issues-720)Known Issues This release contains the following known issues. #### [](#couchbase-cli)Couchbase CLI | Issue | Description | Workaround | | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | [MB-56321](https://issues.couchbase.com/browse/MB-56321) | 7.1.0 couchbase-cli may authenticate using either a username or password, or a mTLS (client certificate). The CLI argument validation does not handle the case where no authentication is required. For example, node-init. This results in a false positive where couchbase-cli requires authentication flags to be provided. | Before a node is initialized, use placeholders for the username and password. After the node is initialized, a username and password must be supplied. | #### [](#search-service-3)Search Service | Issue | Description | Workaround | | -------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | [MB-56226](https://issues.couchbase.com/browse/MB-56226) | Intermittent crashes and errors happen on Full Text Search at query time in term dictionary and postings list. This happens when attempting to access invalid addresses or out-of-bounds data. For example, when term dictionary might be an empty byte slice. | For the errors, a retry logic on the application layer might help. However, there is no workaround for the intermittent crashes which Couchbase are investigating. | #### [](#analytics-service-4)Analytics Service | Issue | Description | Workaround | | -------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- | | [MB-56058](https://issues.couchbase.com/browse/MB-56058) | The first version of the cost-based optimizer (CBO) focuses on optimizing SPJ (select-project-join) queries, or multi-inner-join subgraphs of such queries. For more complex queries, e.g. queries involving outer joins or complex correlated subqueries, some parts of the query will be handled by CBO and other parts will not be. As a result, query plans currently displayed for such queries will be missing CBO-provided cost and cardinality estimates, instead showing those values as 0. Such queries will still have valid plans and will execute correctly, but their plans may not be as optimal as desired. | There is no workaround for this display issue. | Documentation for older versions of Couchbase software can be found in the [Documentation Archive](https://docs-archive.couchbase.com/home/index.html).