Release Notes for Couchbase Server 7.0
Couchbase Server 7.0 introduces scopes and collections, which provide new database organization structures within Couchbase. It also brings new capabilities to the Query Service in addition to support for scopes and collections.
Take a look at What’s New? for a list of new features and improvements in this release.
Release 7.0.2 (October 2021)
Couchbase Server 7.0.2 was released in October 2021. This maintenance release contains new features and fixes to issues.
New Features
This section highlights the notable new features and improvements in this release.
-
TLS can be specified as mandatory for all internal and external cluster-communications — see Manage On-the-Wire Security.
-
HSTS (HTTP Strict Transport Security) can now be enabled.
-
A cluster’s address family can be absolutely restricted to either IPv4 or IPv6 — see Manage Address Families.
-
A node’s alternate address can now be used to identify a target cluster for XDCR — see Create a Reference.
-
Standard index storage now supports indexes for both Couchbase buckets and Ephemeral buckets — see Storage Settings.
-
The Eventing Service now supports a bucket-backed caching capability, to improve performance for repetitive Data Service lookups.
-
The Query Workbench now supports various charts (pie, diagram, scatter etc.) for displaying data. See Query Workbench.
Fixed Issues
This section highlights the notable issues fixed in this release.
Cluster Manager
| Issue | Description |
|---|---|
Summary: Include bucketType in pools/default/b/<bucket-name> REST API |
Data Service
| Issue | Description |
|---|---|
Summary: STAT "dcp" and "dcpagg" adversely affect front-end operation latency |
|
Summary: Vbucket stats call to KV can timeout during delta node recovery preparation |
|
Summary: rev ids going backwards - non-sync-write delete |
Index Service
| Issue | Description |
|---|---|
Summary: Rebalance button not enabled post Quorum Loss failover even when indexing has partitioned indexes |
|
Summary: UI shows 104k mutations remaining when creating indexes on empty bucket |
|
Summary: Internal Server error is raised while performing backup on a index node using cbbackupmgr |
|
Summary: num_rollbacks_to_zero stats not changing for the rollback to zero |
|
Summary: Optimise cluster info cache access in metadata_provider and request_handler |
|
Summary: num_rollbacks_to_zero stats not changing for the rollback to zero |
|
Summary: Panic caused by extraneous unlocking |
|
Summary: Increase polling interval in pollForDeletedBuckets in projector |
|
Summary: Rollback stats will now be persisted in case of indexer crash |
Search Service
| Issue | Description |
|---|---|
Summary: Apply RBAC only for target collections in a multi-collection index |
Eventing Service
| Issue | Description |
|---|---|
Summary: dcp_stream_boundary remains as "from_prior" after upgrade |
|
Summary: default value for language_compatibility should be 6.6.2 instead 6.5.0 |
|
Summary: Always emit the first exception to the application log then summarize |
|
Summary: handler stuck in deploying state |
|
Summary: Connection::isPacketAvailable(): Invalid packet header detected. Cookies: [] |
|
Summary: Performance: crash dump generated |
|
Summary: REST calls fail after changing encryption level to "all" |
|
Summary: Mix Mode: No error when we add new function |
|
Summary: panic observed in debugger tests |
|
Summary: Resume time increased by 34% |
|
Summary: Service 'eventing' exited with status 2. |
Cross Data Center Replication (XDCR)
| Issue | Description |
|---|---|
Summary: XDCR - make health_check_interval configurable |
|
Summary: Switch to new javascript evaluator |
|
Summary: XDCR - collect remote clusters and replication info as part of cbcollect |
|
Summary: XDCR - backfill_request_handler could hang forever |
|
Summary: XDCR - backfill replication spec reloading could misload spec from wrong data |
|
Summary: XDCR - backfill req handler may not get correct throughSeqnos if pipeline is paused |
|
Summary: XDCR - throughSeqnoTracker bg scanner may run for a long time |
|
Summary: unknown remote cluster |
|
Summary: XDCR with full encryption may fail, with the message |
|
Summary: XDCR - File descriptor leak in XDCR |
Tools, Web Console (UI), and REST API
| Issue | Description |
|---|---|
Summary: Add Charts to Query Workbench |
|
Summary: cbbackupmgr start and end validations is a bit too aggressive |
Install and Upgrade
| Issue | Description |
|---|---|
Summary: 7.0 Windows installer always rollbacks during install |
|
Summary: Offline upgrade from 7.0.0 or 7.0.1 on Debian and Ubuntu package install corrupts config files |
Storage
| Issue | Description |
|---|---|
Summary: More memory overhead for non-collection index |
|
Summary: closeForRecovery does not release gCtx |
|
Summary: Compact parent page after page-split |
|
Summary: compact when marshalling full page over purge ratio |
|
Summary: Detect missing log file segment during initialization |
|
Summary: Recovered instances do not compact |
|
Summary: Log specific index stats at regular interval |
|
Summary: lss_rea_bytes and bytes_written do not always match perf html report |
|
Summary: Plasma Stats Compact Counter not updated on CompactFullMarshal |
|
Summary: MVCCPurger may stop running if doProceed check fails |
|
Summary: instMap in StatsLogger.run() should not be indexed by PlasmaId |
Release 7.0.1 (September 2021)
Couchbase Server 7.0.1 was released in September 2021. This maintenance release contains bug fixes.
Fixed Issues
This section highlights the notable issues fixed in this release.
Operator
| Issue | Description |
|---|---|
Summary: Fixed an error encountered when running Flex index queries on a setup that used alternate addresses. |
Search Service
| Issue | Description |
|---|---|
Summary: Fixed the Search Service’s incorrect use of the node’s alternate address. |
Release 7.0.0 (July 2021)
Couchbase Server 7.0 was released in July 2021.
Quick Links: Major Changes in Behavior from Previous Releases | New Supported Platforms | Known Issues | Fixed Issues | Common Vulnerabilities and Exposures
Major Changes in Behavior from Previous Releases
-
With the introduction of scopes and collections, Couchbase Server stores documents in a collection, which are contained in a scope, which is in a bucket. A default scope and default collection is used when a named scope and collection is not available or has not yet been created. When you upgrade to version 7.0 from a previous version, your documents and indexes will be available in the default scope and default collection. The migration guide provides information on how to migrate your data from a previous version of Couchbase to take advantage of named scopes and collections.
-
Global secondary indexes need to be created for each collection.
-
-
Added support for out-of-order execution of operations in Data Service.
When a Data Service request cannot be completed immediately, this enhancement enables looking ahead in the connection’s queue and starting work on the next request. Out-of-order execution behavior is enabled by default and you can choose to disable it. See Java SDK documentation for further information.
-
Global secondary indexes now supports concurrent creation of indexes.
-
The Internet Engineering Task Force (IETF) have formally deprecated both the TLS 1.0 and 1.1 protocols along with a wider industry movement to use newer, more secure standards. Keeping in line with these changes, we strongly recommend that clients which use TLS encryption use TLS 1.2 or higher, and have updated the default minimum TLS version for all Couchbase Server 7.0 clusters to TLS 1.2. Currently supported SDKs already support the TLS 1.2 standard, so in most cases no application changes are required.
If you do need to configure the minimum TLS to a lower version (not recommended), follow the instructions provided in https://docs.couchbase.com/server/current/manage/manage-security/manage-tls.html#set-the-minimum-tls-version.
-
Updated license for Community Edition
Couchbase Server comes in two editions: Enterprise Edition and Community Edition. You can find details on the differences between the two and licensing information on the Couchbase Server Editions page.
-
Enterprise Edition — The Enterprise Edition license provides for free for development and testing for Couchbase Enterprise Edition. A paid subscription for production deployment is required. Please refer to the pricing page for details on Couchbase’s Enterprise Edition.
-
Community Edition — The Community Edition license provides for free deployment of Couchbase Community Edition for departmental-scale deployments of up to five node clusters. It has recently been changed to disallow use of XDCR, which is now an exclusive Enterprise Edition feature.
-
New Supported Platforms
This release adds support for the following platforms:
-
Debian 11.x
See Supported Platforms for the complete list of supported platforms.
Deprecated Features and Platforms
Deprecated and Removed Platforms
The following platforms are deprecated and will be removed in a future release:
-
CentOS 8
-
macOS 10.14 (Mojave)
-
Microsoft Windows Server 2016
The following platforms are removed and no longer available:
-
Ubuntu 16.04 LTS
Deprecated and Removed Features
-
The tree view has been removed from the Query Workbench.
-
The 'cbdocloader' tool used to load sample datasets is deprecated in this release. You can use the 'cbimport' tool with the '--format sample' flag as the 'cbimport' tool provides an equivalent feature set and is collection-aware.
-
The MOSS index type, available in the full-text search service, is deprecated in this release.
-
Support for passwordless buckets,typically buckets from previously upgraded clusters (pre-5.x), is deprecated.
-
The old bucket
sasl_passwordis deprecated in this release. -
The search_query() function is deprecated. We recommend that you use Search() functions instead to run full text search queries directly within a N1QL query. Refer to https://blog.couchbase.com/n1ql-and-search-how-to-leverage-fts-index-in-n1ql-query/ for information on changing the syntax to leverage the Search() function.
-
Views are deprecated in Couchbase Server 7.0+.
Views support in Couchbase Server will be removed in a future release only when the core functionality of the View engine is covered by other services. Views will continue to work in all buckets but only in the default scope and default collection.
There is no current impact to the View engine, Views REST API, or any direct MapReduce View implementations as described in View and Query Examples, where you can still create Views from the Query Workbench.
-
View indexes in N1QL have been removed in this release.
Starting from this release, you can no longer use
CREATE INDEX USING VIEWin N1QL. Note that this change only disallows the ability to create indexes using views. -
The Data-Service histogram 'batch_read' has been removed. Use the existing 'bg_load' histogram instead to monitor background fetch durations.
Known Issues
This section highlights some of the known issues in this release.
Analytics Service
| Issue | Description |
|---|---|
Summary: Quorum failover on a remote cluster requires manual intervention. Not performing these manual steps causes the results to vary based on which nodes the Analytics service is talking to, and the state of those nodes. Workaround: Following a quorum failover on a remote cluster, perform the following manual steps:
|
|
Summary: The Analytics service may run out of heap space when ingesting maximum size documents (20MB) with minimally-sized Analytics memory quota as some memory that is consumed during ingestion is not released until the link is disconnected. Workaround: Use smaller documents, increase the Analytics service memory quota, or disconnect the link before running queries to avoid this issue. |
|
Summary: A Remote Collection that gets disconnected due to the loss of permissions is not reconnected if the permissions are re-established. Workaround: Re-establish the connection by running |
Data Service
| Issue | Description |
|---|---|
Summary: Clusters with a large number of high capacity persistent buckets, delta node recovery may timeout, due to large persistent bucket’s warmup tasks being scheduled before the initial tasks of warmup for other buckets. Workaround: Increase the number of reader threads to reduce the likelihood of smaller bucket’s warmup tasks being delayed from running. |
|
Summary: Under certain circumstances, such as running a cbcollect_info, requests may take longer than normal. Depending on the system workload and size, this may be even a few seconds, which can trigger the default timeout value from SDKs. Workaround: We recommend that you avoid gathering these stats or cbcollect_info during higher workload. |
Eventing Service
| Issue | Description |
|---|---|
Summary: After upgrading a cluster with a single Data node from version 6.6 to 7.0, Eventing timers are not triggered as expected after a swap rebalance to version 7.0. Note that this does not impact clusters with 2 or more data nodes, or when there are no deployed or paused Eventing Functions with timers. Workaround: Undeploy all Eventing Functions that use timers, or add a second Data node before upgrading to version 7.0 (which can be subsequently be removed after the upgrade is complete). |
|
Summary: A race condition exists where an Eventing Function with a Feed Boundary set to "From now" sometimes ignores it’s checkpoint and resumes processing form Everything. This issue only impacts the UI and can occur when a user rapidly invokes pause, edit, or resume in succession. Workaround: The issue can be avoided by using the REST APIs to pause and resume Eventing Functions in production. |
Index Service
| Issue | Description |
|---|---|
Summary: In the case of an unsafe failover that removes one or more index nodes from the cluster, the Rebalance button on the UI may not be enabled even though some indexes or index partitions are not available because the remaining index node(s) did not have any of their replicas. Workaround: Issue a rebalance command via CLI |
Install and Deploy
| Issue | Description |
|---|---|
Summary: When installing Couchbase Server on Windows, you must be logged into an account with Administrator privileges. For Couchbase Server 7.0.1 and earlier versions, if you are logged in to an account other than the built-in Administrator account, an error is thrown during installation if you attempt to install into a directory under If you must install into
|
Query Service
| Issue | Description |
|---|---|
Summary: AT_PLUS queries do not work with collections when using scan_vectors. |
Fixed Issues
The Couchbase JIRA filter Couchbase Server 7.0.0 Notable Fixed Issues lists the notable issues fixed in this release. Note that you need to log in to Couchbase JIRA to be able to view the results of this JIRA filter.
Common Vulnerabilities and Exposures
This section lists common vulnerabilities and exposures that are fixed in this release.
See Couchbase Alerts for the complete list of common vulnerabilities and exposures.
-
CVE-2021-35943