Release Notes for Couchbase Server 5.5.x

Couchbase Server 5.5.x is a significant update of the Couchbase Data Platform. This release specifically highlights agility, performance, and manageability and includes enhancements to existing services as well as new server and SDK components.

Take a look at What’s New? for a list of new features and improvements that are available in this release.

Release 5.5.1

Couchbase Server 5.5.1, released in August 2018, is the first maintenance release in the 5.5.x series for Couchbase Server.

Fixed Issues

Data Service

Issue Description

MB-30868

Fixed an issue where the logs collected from the UI did not use the same salt across all nodes even though they were collected at the same time.

MB-30610

Fixed an issue where the Memcached process was unable to start if IPv6 protocol stack was disabled.

Index Service

Issue Description

MB-30870

During warmup, one of the indexes with low number of items triggered an issue and caused the internal garbage collector to run forever. Thus causing the entire index service to stall during warmup. This issue was observed when using Plasma storage engine.

MB-30823

Fixed an issue where the index service crashed with a "slice bounds out of range" error.

MB-30672

Fixed an issue where upgrading from 4.x to 5.x version of Couchbase Server caused an outage for GSI standard indexes. This was observed during rolling upgrade from ForestDB to Plasma. When the last ForestDB index service node was taken out of the cluster, the cluster compatibility mode changed to Plasma and the index service restarted.

Installation

Issue Description

MB-30413

Uninstalling Couchbase Server on a Debian-based systemd distribution such as Ubuntu 16 using "apt-get remove" and then running "systemctl status couchbase-server" reported that the service still exists but is "masked". This means the service was explicitly disabled in such a way that it could not be started, automatically or by hand. As a result, subsequent installations of any version of Couchbase Server failed as the service was rendered unstartable.

Tools, Web Console (UI) and REST API

Issue Description

MB-30636

Fixed an issue where an unexpected token error was seen when accessing the Web Console in Couchbase Server version 5.5.0.

MB-30589

Fixed an issue where the warning message on the Web Console showed an incorrect flag for the removal of dedicated bucket port as --remove-port instead of --remove-bucket-port.

Release 5.5.0

Couchbase Server 5.5.0 was released in July 2018.

Major Behavior Changes

Issue Description

MB-28778

The default number of Data Service worker threads has been increased; from 3/4 of the number of available CPU threads, to 7/8 of the number of available CPU threads (minimum of 4 in both cases). This makes better use of the available CPU resource, particularly on larger systems, as such users may see an increase in CPU utilization on such systems.

MB-28417

The permissions assigned to the cluster_admin role have been downgraded. As a result, The cluster_admin role no longer has FTS write permissions used to create FTS searches.

Workaround: Add the fts_admin role as required.

MB-27173

Prior to 5.5, the mctimings command defined the request start as the time when the 24 byte request header had been read by the Data Service. However, many requests contain a body which also needs to be read before a request can be processed. As such, the reported duration didn’t accurately reflect how long the server actually spent processing a request, if it was still waiting for the body to be received from the network.

In 5.5, the definition of request start has been changed to be when the header and body have both been read. This has the effect of more accurately reflecting the time spent by the Data Service in servicing a request, as the time the body spends in transit over the network is no longer included. As a result command timings for affected request will have shorter durations compared to how they were measured before 5.5.

MB-27060

The Couchbase Server 5.5 Windows installer package no longer bundles the DLL dbghelp.dll which is required by Breakpad to produce dumps on Windows platforms. Starting version 5.5, Breakpad will pick the DLL (dbghelp.dll) that is shipped with the OS.

New Supported Platforms

This release adds support for the Debian 9 platform. See Supported Platforms for the complete list of supported platforms.

Deprecated Features and Platforms

The following functionality is deprecated, will be deprecated or is unsupported.

  • Server side Moxi or buckets with custom server side Moxi ports are deprecated and may be removed from the product in the future.

  • The ability to create a bucket with a Moxi port has been deprecated. The CLI commands have been updated to remove Moxi ports for bucket create and bucket edit operations.

Known Issues

Administration/Cluster Management

Issue Description

MB-23074

Summary: Performance issues may be observed when running Couchbase Server on CentOS 7.3 with kernel 3.10.0-514.6.

MB-17571

Summary: On an undersized node, the default memory quota assigned to all the selected services by the server might result in a failure.

Workaround: Adjust the memory allocations appropriately to work around this issue.

Data Service

Issue Description

MB-30610

Summary: Memcached process unable to start if IPv6 protocol stack has been disabled. Workaround: There are two generally accepted methods to disable IPv6 on recent Linux distributions:

  1. Disable the entire IPv6 protocol stack - typically by adding a boot-time grub parameter: ipv6.disable=1.

  2. Disable assignment of IPv6 addresses to interfaces - either by setting the boot-time grub parameter: ipv6.disable_ipv6=1, or dynamically by setting the appropriate net.ipv6.conf sysctl properties.

Only the first method to disable IPv6 will cause Memcached to not start correctly. As a workaround you can disable IPv6 using the second method instead.

MB-30074

Summary: The data node is in a pending state after memcached crashes.

MB-29809

Summary: The last_modified can be incorrect if a bucket was upgraded and contains old documents.

MB-29227

Summary: Couchbase Server can get into a livelock state due to high checkpoint memory usage.

Eventing Service

Issue Description

MB-29841

Summary: The debugger is unable to apply the source map generated by the transpiler. A recent update in the Chrome browser version 66.0.3359.181 is causing this issue. Since Google doesn’t allow previous versions of Chrome to be downloaded, you can download previous versions of Chromium. The debugger works fine with source maps on Chromium version 63.0.3239.0.

Note: Our fix for Chromium is tagged to 69.0.3466.0~157. As per the Chrome release calendar, 69.x is set to release on September 4th 2018. The fix has been merged to Chrome Canary and is available at https://www.google.com/chrome/browser/canary.html

MB-29360

Summary: Multiple mutations are observed for a single document update when using Sync Gateway, leading to the OnUpdate handler being triggered multiple times.

MB-29308

Summary: The eventing service may mark redacted data incorrectly.

MB-29271

Summary: When a rebalance is in progress the Eventing service hangs when memcached is killed on data and eventing nodes.

MB-28555

Summary: The Eventing service currently does not provide the ability to specify a port range. Instead, the OS arbitrarily allocates a port for the Chrome Debugger.

MB-28414

Summary: The eventing service misses some mutations with non-default vBuckets (535,1001 etc).

MB-28120

Summary: The eventing service rebalance progress jumps from 24% to Finish.

MB-28010

Summary: The execution_stats.on_update_failure are not counted in the Failures stats displayed in the Web Console.

MB-27814

Summary: When there are multiple functions being deployed, undeployment does not happen until all functions are deployed.

MB-27559

Summary: Benign panics can be seen in the eventing service logs during undeployment.

Full-text Search Service

Issue Description

MB-29967

Summary: In some circumstances, the Search engine uses more memory than its defined quota.

MB-28847

Summary: The memory usage during index build overshoots the RAM quota.

MB-27429

Summary: Scorch indexes were found to contain duplicate pindexes.

MB-25714

Summary: On Windows platform, a very high memory/CPU usage may be observed when search service is indexing.

Indexing Service

Issue Description

MB-30207

Summary: An error is seen during a SUM aggregate pushdown when the entry value is greater than MaxInt64.

MB-30011

Summary: The rebalance progress in percentage during GSI swap rebalance doesn’t always increase linearly.

MB-19869

Summary: Rebalance fails when taking out failed over nodes running views, in certain circumstances.

Install and Upgrade

Issue Description

MB-30354

Summary: Upgrading from 4.x to 5.x version of Couchbase Server causes an outage for GSI standard indexes. This is observed during rolling upgrade from ForestDB to Plasma. When the last ForestDB index service node is taken out of the cluster, the cluster compatibility mode changes to Plasma and index service restarts.

MB-30227

Summary: In-place (offline) upgrades Server on Windows from 5.0.x or 5.1.x to later releases will fail.

Workaround: Manually uninstall 5.0.x / 5.1.x from your Windows machines prior to installing 5.5.0 or later Server releases.

Query Service

Issue Description

MB-29391, MB-29393

Summary: Large numeric values are reported incorrectly. For example, the modulo operation or a scan for min int64 value returns an incorrect result in case of int64.

Security

Issue Description

MB-26421

Summary: The default "administrator" user doesn’t show up in list of local users displayed on the Web Console under the Security -> Users tab.

Tools, Web Console (UI), and REST API

Issue Description

MB-30589

Summary: The UI displays an incorrect flag in the warning message about the removal of dedicated port for a bucket. It displays --remove-port instead of --remove-bucket-port.

Analytics Service (Developer Preview)

Issue Description

MB-30007

Summary: It is possible for a CONNECT BUCKET statement to fail temporarily with the error message "The vbucket belongs to another server(0x7)" when rebalancing Data nodes.

Workaround: Retry the operation.

MB-29542

Summary: The Analytics stats for failed record count was incorrect.

MB-28544

Summary: The UNION ALL operation does not work for all query types. For example, a query of the form shown below is not parsed correctly.

(SELECT ... FROM ... WHERE ...)
UNION ALL
  (SELECT ... FROM ... WHERE ...)

Workaround: Remove the parentheses around the first subquery block.

SELECT ... FROM ... WHERE ...
UNION ALL
  (SELECT ...
    FROM ...
    WHERE ...)

Fixed Issues

Data Service

Issue Description

MB-29227

Couchbase Server could get into a livelock state due to high checkpoint memory usage.

MB-29205

There were a number of issues in Couchbase Server which caused rebalance to fail from time to time. These have been fixed.

MB-29040

Rebalance failed with an "Invalid Format specified for DCP_DELETION" error when data or eventing nodes were swapped in and out of a cluster.

MB-28868

The index service went through a race condition in the storage engine which led to a crash. The crash was most likely to happen if the index service was restarted with existing build indexes and they continued to process mutations after the index service restarted.

MB-28468

The full-text search service repeatedly attempted to setup DCP streams to non-existing vBuckets.

Eventing Service

Issue Description

MB-29235

The Eventing service did not retry bucket operation failures that were determined by the appropriate LCB macro to be retriable.

MB-29147

Rebalance of KV/Eventing nodes can hang if the cluster contains Eventing nodes due to stale authentication info with the GoCB SDK.

MB-28968

Rebalance of data or eventing nodes would hang if the cluster contained Eventing nodes.

MB-28779

If the handler code was not idempotent, the destination bucket contained more docs than expected after a rebalance.

MB-28775

On Windows, orphan processes with .rbf extension were found to be running even after uninstalling Couchbase Server.

MB-28667

Under some circumstances, like a function undergoing bootstrap or buckets referenced by the function (source, metadata, destination) get flushed or deleted, the function could not be undeployed.

MB-28550

After restoring from an enterprise backup of eventing functions, eventing service would not process mutations in the destination cluster.

MB-28520

Deployment fails if the size of the handler code is greater than 1MB.

MB-28315

Redeploying a function resulted in the application log being truncated instead of appending to the existing log.

MB-27679

The Eventing service can crash when processing documents in source buckets with size is greater than 1 MB.

MB-27491

Failed rebalance, when retried, could hang.

MB-27454

Rebalance-in of a data(KV) node after recovery from failover may hang if eventing service is processing mutations.

Index Service

Issue Description

MB-29405

Rebalance would hang during index service rebalance.

MB-28139

If the index files were corrupted, the index service would continue to crash and required a failover or a manual deletion of the corrupted index files to recover.

Query Service

Issue Description

MB-27815

The array indexing plan incorrectly included filter covers.

MB-27360

Fixed an issue on Windows platform where a query with more than 1000 characters could be pasted into the cbq shell only the up to 3 times. Subsequent paste operations resulted in a partial query being pasted.

MB-25901

Fixed an issue where the ORDER BY operator proceeded to sort even after being stopped and could lead to crashes.

Tools, Web Console (UI), and REST API

Issue Description

MB-29980

The logic to confirm unsafe stop rebalance operation on the Web Console has been resurrected.

MB-28337

Cbbackup, cbtransfer and cbrecovery can incorrectly timeout and in rare cases cause data corruption.

MB-27719

The cbrecovery command threw an exception when recovering data from a cluster that had failed over nodes.

Analytics Service (Developer Preview)

Issue Description

MB-27280

It was possible for a rebalance of the Analytics nodes to always fail if:

  • a bucket was in the disconnected state, and

  • the Analytics nodes were at different DCP states.

In that case a common DCP state (required for rebalancing) could not be achieved as no new DCP mutations were received by the Analytics nodes.

Release Notes for Older 5.x Versions