From 10d5e669e781a5afac747e14fe2ed3ebf0cfe762 Mon Sep 17 00:00:00 2001 From: Ray Offiah Date: Mon, 11 Aug 2025 10:44:29 +0100 Subject: [PATCH 1/3] [DOC-13459]: Create release note for Couchbase Server 7.6.8 Signed-off-by: Ray Offiah --- modules/release-notes/pages/relnotes.adoc | 2 + .../docs-server-7.6.8-release-note.adoc | 124 ++++++++++++++++++ 2 files changed, 126 insertions(+) create mode 100644 modules/release-notes/partials/docs-server-7.6.8-release-note.adoc diff --git a/modules/release-notes/pages/relnotes.adoc b/modules/release-notes/pages/relnotes.adoc index c62782b669..4d990d73f7 100644 --- a/modules/release-notes/pages/relnotes.adoc +++ b/modules/release-notes/pages/relnotes.adoc @@ -3,6 +3,8 @@ :description: Couchbase Server 7.6.x introduces multiple new features and fixes, as well as some deprecations and removals. :page-toclevels: 2 +include::partial$docs-server-7.6.8-release-note.adoc[] + include::partial$docs-server-7.6.7-release-note.adoc[] include::partial$docs-server-7.6.6-release-note.adoc[] diff --git a/modules/release-notes/partials/docs-server-7.6.8-release-note.adoc b/modules/release-notes/partials/docs-server-7.6.8-release-note.adoc new file mode 100644 index 0000000000..4d307ced54 --- /dev/null +++ b/modules/release-notes/partials/docs-server-7.6.8-release-note.adoc @@ -0,0 +1,124 @@ + + +[#release-768] +== Release 7.6.8 (October 2025) + +Couchbase Server 7.6.8 was released in October 2025. +This maintenance release contains fixes to issues. + +== Fixed Issues + + + + +=== Cluster Manager + +[#table-known-issues-768-cluster-manager, cols="10,40,40"] +|=== +|Issue | Description | Resolution + +| https://jira.issues.couchbase.com/browse/MB-67106/[MB-67106] + +a| The "Cache Miss Ratio" metric has been revised for clarification. It no longer refers to memory/disk caching but to read operations failing due to keys not being present in the bucket. We've renamed this to "Get Miss Ratio" to avoid confusion. The previous metrics, ep_cache_miss_rate and kv_ep_cache_miss_ratio, will be deprecated but retained temporarily. The UI will remove the term "cache," and a future update may introduce a "Disk Lookups" metric to track disk access operations. Deprecated stats will be phased out once a process for removal is established, with the eventual introduction of more relevant metrics directly through the KV-Engine. + +// Generated by [chatgpt:gpt-4o] + +| Issue resolved + +| https://jira.issues.couchbase.com/browse/MB-67758/[MB-67758] + +a| Auto-failover alerts now support UI pop-ups, improved in multiple builds, including couchbase-server-7.6.8-7006, 8.0.0-3554, 8.1.0-1021, enterprise-analytics-2.0.1-1205, and 2.1.0-1013. While testing, a five-node cluster showed pop-up alerts when nodes failed, confirming the feature's effectiveness. Disabling alerts as expected resulted in no pop-ups. These enhancements aim to improve user interaction and monitoring by displaying alerts directly on the UI during auto-failover scenarios, helping users respond swiftly to node failures. + +// Generated by [chatgpt:gpt-4o] + +| Issue resolved + +|=== + + +=== Data Service + +[#table-known-issues-768-data-service, cols="10,40,40"] +|=== +|Issue | Description | Resolution + +| https://jira.issues.couchbase.com/browse/MB-66876/[MB-66876] + +a| The `magma_min_value_block_size_threshold` has been adjusted from 64KB to INT_MAX for version 7.6.x to resolve an issue where buckets using the Magma storage engine did not apply block compression for documents larger than 64 KiB. This fix is included in build couchbase-server-7.6.7-6464. There's no change needed for version 8.0.0, as kv_engine overrides the config. It's noted that if `magma_per_document_compression_enabled` is set to false, `magma_min_value_block_size_threshold` should be set to infinity. This adjustment ensures that block compression applies as intended during persistence. + +// Generated by [chatgpt:gpt-4o] + +| Issue resolved + +| https://jira.issues.couchbase.com/browse/MB-67106/[MB-67106] + +a| The "Cache Miss Ratio" metric has been revised for clarification. It no longer refers to memory/disk caching but to read operations failing due to keys not being present in the bucket. We've renamed this to "Get Miss Ratio" to avoid confusion. The previous metrics, ep_cache_miss_rate and kv_ep_cache_miss_ratio, will be deprecated but retained temporarily. The UI will remove the term "cache," and a future update may introduce a "Disk Lookups" metric to track disk access operations. Deprecated stats will be phased out once a process for removal is established, with the eventual introduction of more relevant metrics directly through the KV-Engine. + +// Generated by [chatgpt:gpt-4o] + +| Issue resolved + +|=== + + + + +=== XDCR + +[#table-known-issues-768-xdcr, cols="10,40,40"] +|=== +|Issue | Description | Resolution + +| https://jira.issues.couchbase.com/browse/MB-66649/[MB-66649] + +a| The latest builds of Couchbase Server, 7.6.7-6414 and 7.6.7-6422, include updates from the goxdcr project focused on UX enhancements for the Trinity UI. These improvements serve as an alternative to backporting changes from MB-66140. The 6414 build incorporates the commit for these UX enhancements, while the 6422 build includes a fix for the TestPipelineOpSerializerReinit unit test. These updates aim to streamline user experience and ensure reliable functionality within the platform. + +// Generated by [chatgpt:gpt-4o] + +| Issue resolved + +|=== + + +=== Query Service + +[#table-known-issues-768-query-service, cols="10,40,40"] +|=== +|Issue | Description | Resolution + +| https://jira.issues.couchbase.com/browse/MB-67849/[MB-67849] + +a| 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 and adding corresponding unit tests. These modifications have been verified across multiple versions, ensuring accurate representation of large integers. Improvements have been applied consistently to maintain system integrity and performance. The changes also include two major commits focusing on overflow checks and additional unit testing to ensure robustness and reliability. The updates aim to prevent erroneous handling of large integer values within the database operations. + +// Generated by [chatgpt:gpt-4o] + +| Issue resolved + +|=== + + + + + + + + + + +=== Tools + +[#table-known-issues-768-tools, cols="10,40,40"] +|=== +|Issue | Description | Resolution + +| https://jira.issues.couchbase.com/browse/MB-60676/[MB-60676] + +a| In the latest release, an update has been implemented to prevent multiple scheduled jobs for the same repository from running concurrently across backup service nodes in a cluster. This resolves an issue where concurrent jobs resulted in failures. The update, aligning with commit MB-60676, ensures only one task per repository is executed at any time. The change has been validated on build 8.0.0-2920. Additionally, there is an update to the cbauth module as part of this release. These improvements aim to enhance job scheduling stability within the system. + +// Generated by [chatgpt:gpt-4o] + +| Issue resolved + +|=== + + From 14228e89489398bee95591f422c7db4505b6700b Mon Sep 17 00:00:00 2001 From: Ray Offiah Date: Fri, 15 Aug 2025 11:20:29 +0100 Subject: [PATCH 2/3] [DOC-13459]: Create release note for Couchbase Server 7.6.8 Signed-off-by: Ray Offiah --- modules/release-notes/pages/relnotes.adoc | 1 + .../docs-server-7.6.8-release-note.adoc | 29 ++++++++----------- 2 files changed, 13 insertions(+), 17 deletions(-) diff --git a/modules/release-notes/pages/relnotes.adoc b/modules/release-notes/pages/relnotes.adoc index 4d990d73f7..e7fd70e6c1 100644 --- a/modules/release-notes/pages/relnotes.adoc +++ b/modules/release-notes/pages/relnotes.adoc @@ -2,6 +2,7 @@ :page-aliases: analytics:releasenote :description: Couchbase Server 7.6.x introduces multiple new features and fixes, as well as some deprecations and removals. :page-toclevels: 2 +:stem: include::partial$docs-server-7.6.8-release-note.adoc[] diff --git a/modules/release-notes/partials/docs-server-7.6.8-release-note.adoc b/modules/release-notes/partials/docs-server-7.6.8-release-note.adoc index 4d307ced54..e258d5201f 100644 --- a/modules/release-notes/partials/docs-server-7.6.8-release-note.adoc +++ b/modules/release-notes/partials/docs-server-7.6.8-release-note.adoc @@ -19,17 +19,15 @@ This maintenance release contains fixes to issues. | https://jira.issues.couchbase.com/browse/MB-67106/[MB-67106] -a| The "Cache Miss Ratio" metric has been revised for clarification. It no longer refers to memory/disk caching but to read operations failing due to keys not being present in the bucket. We've renamed this to "Get Miss Ratio" to avoid confusion. The previous metrics, ep_cache_miss_rate and kv_ep_cache_miss_ratio, will be deprecated but retained temporarily. The UI will remove the term "cache," and a future update may introduce a "Disk Lookups" metric to track disk access operations. Deprecated stats will be phased out once a process for removal is established, with the eventual introduction of more relevant metrics directly through the KV-Engine. - -// Generated by [chatgpt:gpt-4o] +a| *Metric Rename – Cache Miss Ratio → Miss Ratio* +The _Cache Miss Ratio_ metric name suggested it measured memory or disk caching performance. In reality, as of version 7.6.2, it was redefined to measure the proportion of read (`get`) operations that fail because the requested key is not present in the bucket at all. To eliminate this confusion, the metric has been renamed to *Get Miss Ratio*. | Issue resolved | https://jira.issues.couchbase.com/browse/MB-67758/[MB-67758] -a| Auto-failover alerts now support UI pop-ups, improved in multiple builds, including couchbase-server-7.6.8-7006, 8.0.0-3554, 8.1.0-1021, enterprise-analytics-2.0.1-1205, and 2.1.0-1013. While testing, a five-node cluster showed pop-up alerts when nodes failed, confirming the feature's effectiveness. Disabling alerts as expected resulted in no pop-ups. These enhancements aim to improve user interaction and monitoring by displaying alerts directly on the UI during auto-failover scenarios, helping users respond swiftly to node failures. +a| {empty} -// Generated by [chatgpt:gpt-4o] | Issue resolved @@ -44,17 +42,15 @@ a| Auto-failover alerts now support UI pop-ups, improved in multiple builds, inc | https://jira.issues.couchbase.com/browse/MB-66876/[MB-66876] -a| The `magma_min_value_block_size_threshold` has been adjusted from 64KB to INT_MAX for version 7.6.x to resolve an issue where buckets using the Magma storage engine did not apply block compression for documents larger than 64 KiB. This fix is included in build couchbase-server-7.6.7-6464. There's no change needed for version 8.0.0, as kv_engine overrides the config. It's noted that if `magma_per_document_compression_enabled` is set to false, `magma_min_value_block_size_threshold` should be set to infinity. This adjustment ensures that block compression applies as intended during persistence. +a| {empty} -// Generated by [chatgpt:gpt-4o] | Issue resolved | https://jira.issues.couchbase.com/browse/MB-67106/[MB-67106] -a| The "Cache Miss Ratio" metric has been revised for clarification. It no longer refers to memory/disk caching but to read operations failing due to keys not being present in the bucket. We've renamed this to "Get Miss Ratio" to avoid confusion. The previous metrics, ep_cache_miss_rate and kv_ep_cache_miss_ratio, will be deprecated but retained temporarily. The UI will remove the term "cache," and a future update may introduce a "Disk Lookups" metric to track disk access operations. Deprecated stats will be phased out once a process for removal is established, with the eventual introduction of more relevant metrics directly through the KV-Engine. - -// Generated by [chatgpt:gpt-4o] +a| *Metric Rename – Cache Miss Ratio → Miss Ratio* +The _Cache Miss Ratio_ metric name suggested it measured memory or disk caching performance. In reality, as of version 7.6.2, it was redefined to measure the proportion of read (`get`) operations that fail because the requested key is not present in the bucket at all. To eliminate this confusion, the metric has been renamed to *Get Miss Ratio*. | Issue resolved @@ -71,9 +67,11 @@ a| The "Cache Miss Ratio" metric has been revised for clarification. It no longe | https://jira.issues.couchbase.com/browse/MB-66649/[MB-66649] -a| The latest builds of Couchbase Server, 7.6.7-6414 and 7.6.7-6422, include updates from the goxdcr project focused on UX enhancements for the Trinity UI. These improvements serve as an alternative to backporting changes from MB-66140. The 6414 build incorporates the commit for these UX enhancements, while the 6422 build includes a fix for the TestPipelineOpSerializerReinit unit test. These updates aim to streamline user experience and ensure reliable functionality within the platform. +a| 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. -// Generated by [chatgpt:gpt-4o] +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 @@ -88,9 +86,7 @@ a| The latest builds of Couchbase Server, 7.6.7-6414 and 7.6.7-6422, include upd | https://jira.issues.couchbase.com/browse/MB-67849/[MB-67849] -a| 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 and adding corresponding unit tests. These modifications have been verified across multiple versions, ensuring accurate representation of large integers. Improvements have been applied consistently to maintain system integrity and performance. The changes also include two major commits focusing on overflow checks and additional unit testing to ensure robustness and reliability. The updates aim to prevent erroneous handling of large integer values within the database operations. - -// Generated by [chatgpt:gpt-4o] +a| 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 stem:[2^63] or less than stem:[-2^63]). | Issue resolved @@ -113,9 +109,8 @@ a| The recent builds of Couchbase Server versions 7.2.7 through 8.1.0 and Enterp | https://jira.issues.couchbase.com/browse/MB-60676/[MB-60676] -a| In the latest release, an update has been implemented to prevent multiple scheduled jobs for the same repository from running concurrently across backup service nodes in a cluster. This resolves an issue where concurrent jobs resulted in failures. The update, aligning with commit MB-60676, ensures only one task per repository is executed at any time. The change has been validated on build 8.0.0-2920. Additionally, there is an update to the cbauth module as part of this release. These improvements aim to enhance job scheduling stability within the system. +a| {empty} -// Generated by [chatgpt:gpt-4o] | Issue resolved From 1ac338e7b2870b1ca281d7366b52f2c11b31d653 Mon Sep 17 00:00:00 2001 From: Ray Offiah Date: Fri, 15 Aug 2025 11:23:15 +0100 Subject: [PATCH 3/3] [DOC-13459]: Create release note for Couchbase Server 7.6.8 Restoring HEAD.yml Signed-off-by: Ray Offiah --- preview/HEAD.yml | 2 -- 1 file changed, 2 deletions(-) diff --git a/preview/HEAD.yml b/preview/HEAD.yml index 48c99d0187..896c1ba582 100644 --- a/preview/HEAD.yml +++ b/preview/HEAD.yml @@ -1,6 +1,4 @@ sources: - docs-server: - branches: [DOC-13396-Create-release-note-for-7.6.7-Release,DOC-13372-Create-release-note-for-docs-server-7.2.8] docs-devex: branches: release/7.6 cb-swagger: