A newer version of this documentation is available.

View Latest

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.5 (December 2022)

      Couchbase Server 7.0.5 was released in December 2022.

      Fixed Issues

      This section lists the notable fixes provided in this release.

      Data Service

      Issue Description

      MB-54591

      Summary: Lost wakeup in ActiveStream can result in DCP clients not receiving seqnos

      MB-53922

      Summary: Ephemeral purger can delete a StoredValue which is still referenced

      XDCR

      Issue Description

      MB-54415

      Summary: AdvFilter upgrade happens pre-emptively leading to missed documents

      MB-54366

      Summary: XDCR Metakv callbacks racing when remote cluster ref is added/changed

      MB-54317

      Summary: Prevent unnecessary V8 GC runs

      Tools

      Issue Description

      MB-54674

      Summary: cbcollect_info pauses reading /proc/<PID>/smaps

      Query Service

      Issue Description

      MB-54327

      Summary: Turn off impersonation if the KV node does not support it

      MB-54236

      Summary: Potential for request stall if stream operator fails to notify request that it has terminated

      MB-53793

      Summary: Wrong results when filter has conditional query parameters

      MB-53628

      Summary: Panic while calling math/rand’s Intn(..)

      Index Service

      Issue Description

      MB-54685

      Summary: Rebalance hangs if indexes are being built when one database is deleted and new database is created

      MB-54561

      Summary: Optimise projector CPU during XATTR processing

      MB-54336

      Summary: Watcher fails to connect on clientAuth

      MB-54025

      Summary: cbindex fails to execute build index

      MB-53842

      Summary: Use streamId instead of index.Stream to determine stream catchup pending

      Eventing Service

      Issue Description

      MB-54542

      Summary: Backup/Restore fails when bucket name contains "." character

      MB-54263

      Summary: Fix 7.0.4 issue where previously processed source bucket mutations were suppressed after undeploy-deploy cycle of an Eventing function

      Release 7.0.4 (June 2022)

      Couchbase Server 7.0.4 was released in June 2022. This maintenance release contains fixes to issues.

      Fixed Issues

      This section lists the notable fixes provided in this release.

      Cluster Manager

      Issue Description

      MB-51752

      Summary: cbcollect fails to gather projector profiles when TLS is enforced

      MB-51981

      Summary: Prometheus continues to consume an ever increasing amount of disk space after 1GB

      Data Service

      Issue Description

      MB-51530

      Summary: impersonated user with role data_writer[test:_default:default] is not able to create document in default collection

      XDCR

      Issue Description

      MB-51385

      Summary: Compressed binary documents with xattrs are not replicated

      MB-51407

      Summary: XDCR cannot handle data larger than 20MB

      Query Service

      Issue Description

      MB-52281

      Summary: Incorrect result when Element references an alias in the query

      MB-51431

      Summary: Avoid circular link in annotated value hierarchy

      MB-51447

      Summary: select executing a function executing a select returns the same results

      MB-51453

      Summary: IN/NOT IN filters not using Hash for evaluation

      MB-51455

      Summary: Aggregates wrongly pushed

      MB-51578

      Summary: Error 4321 generated when OR clause has a ($parameter is null) arm

      MB-51581

      Summary: JOIN query not covered

      MB-51739

      Summary: LEFT JOIN breaks with between operator on non-existing attribute

      MB-52281

      Summary: adhoc query index selection issue with LIKE as index condition and query parameters

      Index Service

      Issue Description

      MB-50861

      Summary: Query log has flood with messages

      MB-51023

      Summary: ns_server stop responding after continuous CRUD on bucket and collections

      MB-52000

      Summary: Alter Index failure when nodes have un encrypted ports in encryption mode all

      Search Service

      Issue Description

      MB-50946

      Summary: bleveMaxClauseCount reset to 1024 after restart

      Analytics Service

      Issue Description

      MB-51482

      Summary: Node is not upgraded and stuck trying to register with CC

      MB-51488

      Summary: Ignore byte order marks when parsing external data

      MB-51700

      Summary: Analytics Service keeps crashing when one of the Analytics Service nodes is failed over

      Eventing Service

      Issue Description

      MB-51585

      Summary: Limit ownership_history to last 'N' in metadata bucket

      MB-51496

      Summary: Eventing functions lose auth on save

      MB-51497

      Summary: Warning if variable name contains builtin api name

      MB-51231

      Summary: Memory leak when performing undeploy and pause operation

      MB-51379

      Summary: Rollback handling - Retry with previous uuid on rollback message

      MB-51688

      Summary: Refresh connectionpool on every encryption-level change

      MB-51390

      Summary: Handler stuck in pausing state after online upgrade and enforcing TLS

      MB-51687

      Summary: Some bucket operations are failing with LCB_ERR_SSL_CANTVERIFY after online upgrade to 7.0.x

      MB-51386

      Summary: Concurrent attempts to restart a crashed consumer process can cause rebalance & life cycle ops to fail or get stuck

      Known Issues

      This section highlights the notable known issues in this release.

      Install and Upgrade

      Issue Description

      MB-52313

      Summary: Analytics Service crashes during upgrade on Windows

      Query Service

      Issue

      Description

      MB-51629

      Summary: Large negative integers with 19 significant digits but still below the limits of 64-bit int storage were treated as floating point and thus were subject to precision loss.

      Workaround: Store large negative integers in strings, noting the limits on processing as strings.

      Release 7.0.3 (December 2021)

      Couchbase Server 7.0.3 was released in December 2021. This maintenance release contains a new feature and an important security fix.

      New Features

      This section highlights the notable new features and improvements in this release.

      • The Search Service has disk utilization improvements: in some cases, it uses up to 90% less disk space. For the potential savings to take effect, the index will need to be rebuilt; or at least will need to ingest data for the segments to be merged and rebuilt on the disk.

      Fixed Issues

      This section highlights the notable issues fixed in this release.

      This release fixes a high severity vulnerability related to Log4j 2. All users using the Couchbase Analytics Service should upgrade to this release as soon as possible.

      You can find more information in the blog post: What to Know About the Log4j Vulnerability CVE-2021-44228

      Analytics

      • This release updates Log4J to 2.15. This update fixes CVE-2021-44228.

      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.

      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 — see Configure HSTS.

      • 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 Eventing Service now supports node-to-node encryption. See Node-to-Node Encryption.

      • The Query Workbench now supports various charts (pie, diagram, scatter etc.) for displaying data. See Query Workbench.

      • The Search Service introduces rebalance based on file transfer; whereby, during rebalance, new partitions are optionally created by means of file transfer, rather than partition build; thereby enhancing performance. See the documentation provided for rebalancing the Search Service.

      Deprecation

      Debian 9 is now deprecated.

      Fixed Issues

      This section highlights the notable issues fixed in this release.

      Cluster Manager

      Issue Description

      MB-48438

      Summary: Include bucketType in pools/default/b/<bucket-name> REST API

      Data Service

      Issue Description

      MB-38978

      Summary: STAT "dcp" and "dcpagg" adversely affect front-end operation latency

      MB-48179

      Summary: SyncDeletes do not update maxDelRevSeqno, which can cause rev ids to go backwards

      MB-48713

      Summary: rev ids going backwards - non-sync-write delete

      Query Service

      Issue Description

      MB-46876

      Summary: AT_PLUS queries with collections are not working

      Index Service

      Issue Description

      MB-46725

      Summary: Rebalance button not enabled post Quorum Loss failover even when indexing has partitioned indexes

      MB-46350

      Summary: UI shows 104k mutations remaining when creating indexes on empty bucket

      MB-47047

      Summary: Internal Server error is raised while performing backup on a index node using cbbackupmgr

      MB-47631

      Summary: num_rollbacks_to_zero stats not changing for the rollback to zero

      MB-47635

      Summary: Optimise cluster info cache access in metadata_provider and request_handler

      MB-47684

      Summary: num_rollbacks_to_zero stats not changing for the rollback to zero

      MB-47760

      Summary: Panic caused by extraneous unlocking

      MB-47878

      Summary: Increase polling interval in pollForDeletedBuckets in projector

      MB-48336

      Summary: Rollback stats will now be persisted in case of indexer crash

      Search Service

      Eventing Service

      Issue Description

      MB-46351

      Summary: dcp_stream_boundary remains as "from_prior" after upgrade

      MB-46647

      Summary: default value for language_compatibility should be 6.6.2 instead 6.5.0

      MB-47867

      Summary: Always emit the first exception to the application log then summarize

      MB-48103

      Summary: handler stuck in deploying state

      MB-48104

      Summary: Connection::isPacketAvailable(): Invalid packet header detected. Cookies: []

      MB-48118

      Summary: Performance: crash dump generated

      MB-48195

      Summary: REST calls fail after changing encryption level to "all"

      MB-48337

      Summary: Mix Mode: No error when we add new function

      MB-48487

      Summary: panic observed in debugger tests

      MB-48488

      Summary: Resume time increased by 34%

      MB-48572

      Summary: Service 'eventing' exited with status 2.

      Cross Data Center Replication (XDCR)

      Issue Description

      MB-47157

      Summary: XDCR - make health_check_interval configurable

      MB-47246

      Summary: Switch to new javascript evaluator

      MB-47521

      Summary: XDCR - collect remote clusters and replication info as part of cbcollect

      MB-47777

      Summary: XDCR - backfill_request_handler could hang forever

      MB-47778

      Summary: XDCR - backfill replication spec reloading could misload spec from wrong data

      MB-47779

      Summary: XDCR - backfill req handler may not get correct throughSeqnos if pipeline is paused

      MB-47900

      Summary: XDCR - throughSeqnoTracker bg scanner may run for a long time

      MB-48105

      Summary: unknown remote cluster

      MB-48016

      Summary: XDCR with full encryption may fail, with the message certificate relies on legacy Common Name field, use SANs or temporarily enable Common Name matching with GODEBUG=x509ignoreCN=0, statusCode=0.

      MB-48211

      Summary: XDCR - File descriptor leak in XDCR

      Tools, Web Console (UI), and REST API

      Issue Description

      MB-47001

      Summary: Add Charts to Query Workbench

      MB-48081

      Summary: cbbackupmgr start and end validations is a bit too aggressive

      Install and Upgrade

      Issue Description

      MB-47806

      Summary: 7.0 Windows installer always rollbacks during install

      MB-48783

      Summary: Offline upgrade from 7.0.0 or 7.0.1 on Debian and Ubuntu package install corrupts config files

      Storage

      Issue Description

      MB-46490

      Summary: More memory overhead for non-collection index

      MB-47205

      Summary: closeForRecovery does not release gCtx

      MB-47355

      Summary: Compact parent page after page-split

      MB-47354

      Summary: compact when marshalling full page over purge ratio

      MB-47429

      Summary: Detect missing log file segment during initialization

      MB-47503

      Summary: Recovered instances do not compact

      MB-47986

      Summary: Log specific index stats at regular interval

      MB-47990

      Summary: lss_rea_bytes and bytes_written do not always match perf html report

      MB-47992

      Summary: Plasma Stats Compact Counter not updated on CompactFullMarshal

      MB-48356

      Summary: MVCCPurger may stop running if doProceed check fails

      MB-47987

      Summary: instMap in StatsLogger.run() should not be indexed by PlasmaId

      Views

      Issue Description

      MB-47094

      Summary: Slow processing of audit messages might lead to increase in RSS memory

      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

      MB-47678

      Summary: Fixed an error encountered when running Flex index queries on a setup that used alternate addresses.

      Prometheus

      Issue Description

      MB-47502

      Summary: Fixed a memory leak in Prometheus.

      Search Service

      Issue Description

      MB-47457

      Summary: Fixed the Search Service’s incorrect use of the node’s alternate address.

      Cluster Manager

      Issue Description

      MB-47087

      Summary: Fixed the failure of rebalance out following multi-node graceful failover.

      Release 7.0.0 (July 2021)

      Couchbase Server 7.0 was released in July 2021.

      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 Manage On-the-Wire Security. The minimum TLS can be configured through the CLI or through the REST-API.

      • 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 at Couchbase Server Editions. The Community Edition license enables free deployment of Couchbase Community Edition for departmental-scale deployments of up to five-node databases. The Community Edition license has recently been changed to disallow use of XDCR. XDCR is now an exclusive Enterprise Edition feature.

      New Supported Platforms

      This release adds support for the following platforms:

      • macOS Big Sur for development only

      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_password is 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 VIEW in 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

      MB-46646

      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:

      1. Run DISCONNECT LINK if the remote link is still connected.

      2. Run ALTER LINK to update the link to point to a surviving node. This step is needed even if the previously specified host is still in the cluster as it resets the topology maintained in the metadata.

      3. Run CONNECT LINK to reconnect the link.

      MB-45996

      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.

      MB-44849

      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 CONNECT LINK manually.

      Data Service

      Issue Description

      MB-47267

      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.

      MB-38978

      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

      MB-45973

      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).

      MB-45785

      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

      MB-46725

      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 couchbase-cli rebalance -c 127.0.0.1:8091 -u Administrator -p xxxxxx

      Install and Deploy

      Issue Description

      MB-47806

      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 C:\Program Files. You must change the installation directory to something under your user’s home directory.

      If you must install into C:\Program Files, and cannot log in to the built-in Administrator account (this account is disabled by default on Windows 10), the workaround is to take the following steps:

      1. Click the Start button and type cmd.

      2. Right-click on Command Prompt and select Run as administrator.

      3. At the command prompt, cd into the directory with the downloaded .msi and type call couchbase-server-enterprise_7.0.0-windows_amd64.msi.

      Query Service

      Issue Description

      MB-46876

      Summary: AT_PLUS queries do not work with collections when using scan_vectors.

      Views

      Issue Description

      MB-47094

      Summary: When request auditing is enabled in a Couchbase cluster, under very high Views query workload, the view-engine audit message queue may grow unbounded causing the view-engine to crash.

      Workaround: Disable auditing when Views are present in the cluster.

      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.

      Release 6.6.5 (January 2022)

      Couchbase Server 6.6.5 was released in January 2022. This maintenance release includes bug fixes in multiple components.

      Additionally, this release makes the following changes:

      • Log4J is updated to version 2.17.1.

      • Node-to-Node Encryption is now supported by the Eventing Service.

      Fixed Issues

      This section highlights the notable issues fixed in this release.

      Cluster Manager

      Issue Description

      MB-47613

      Summary: Add bucket names and UUIDs to pools/default

      MB-49271

      Summary: ns_server should generate DCP connection names that are no longer than allowed by memcached

      MB-49323

      Summary: Reconfigure of interfaces does not work for multiple entries sharing hostname and port and using an optional flag

      Data Service

      Issue Description

      MB-34280

      Summary: Memcached should disallow DCP connections with names greater than 200 characters

      MB-48713

      Summary: [Ephemeral] Rev id going backwards for SyncWrite add

      MB-49321

      Summary: Reconfigure of interface does not work going from * to specific IP and vice versa

      MB-49323

      Summary: Reconfigure of interfaces does not work for multiple entries sharing hostname and port and using optional flag

      MB-50078

      Summary: Enforce TLS: Established plaintext connections are not closed when plaintext listening socket is closed

      Cross Data Center Replication (XDCR)

      Issue Description

      MB-47672

      Summary: XDCR hitting pools/nodes endpoint should be coordinated

      MB-48134

      Summary: Remove staged transaction xattr and replicate data

      MB-48212

      Summary: File descriptor leak in XDCR

      MB-48801

      Summary: Compressed binary documents with xattrs are not replicated

      Eventing Service

      Issue Description

      MB-48289

      Summary: Fix eventing-producer RSS bloat when eventing-consumers are re-spawned continuously

      MB-49600

      Summary: Concurrent attempts to restart a crashed consumer process can cause rebalance & life cycle ops to fail or get stuck

      Index Service

      Issue Description

      MB-47674

      Summary: Provide configurable option to disable logging numDocsPending stat for projector

      Fixed Security Vulnerabilities

      For complete details of fixed security vulnerabilities in Couchbase Enterprise Server, see the Enterprise Security Alerts page.