Skip to content

Commit 6505afd

Browse files
authored
Update XDCR compatibility matrix for 8-0 (#3953)
1 parent 1b53b26 commit 6505afd

File tree

3 files changed

+94
-50
lines changed

3 files changed

+94
-50
lines changed

modules/learn/pages/buckets-memory-and-storage/vbuckets.adoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,8 @@ The number of vBuckets depends on the bucket's storage backend (the system that
2424
* Buckets that use the Couchstore storage engine use 1024 vBuckets on Linux and Windows.
2525
* Buckets that use Magma storage engine can use either 128 or 1024 vBuckets on Linux and Windows.
2626
You choose the number of vBuckets when you create the bucket.
27+
If you're using XDCR, review the xref:learn:clusters-and-availability/xdcr-overview.adoc#xdcr-compatibility[XDCR Compatibility] information
28+
on vBuckets for Server versions earlier than 8.0.
2729
2830
The system distributes vBuckets evenly across the memory and storage resources of nodes that run the xref:services-and-indexes/services/data-service.adoc[Data Service].
2931
The bucket's data is distributed evenly across its vBuckets.

modules/learn/pages/clusters-and-availability/xdcr-enable-crossclusterversioning.adoc

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,26 @@ Therefore, you must not enable `enableCrossClusterVersioning` casually.
1212
When you set the bucket property `enableCrossClusterVersioning` (ECCV) to `true`, for each document processed by XDCR, XDCR stores additional metadata for the document in the extended attributes.
1313
This metadata is also called Hybrid Logical Vector (HLV), which is a set of Hybrid Logical Clock (HLC) information.
1414

15+
[NOTE]
16+
====
17+
Cross Cluster Versioning (ECCV) Compatibility with Couchbase Server Versions::
18+
19+
Starting in Couchbase Server 7.6.6, buckets include the `enableCrossClusterVersioning` (ECCV) property, which is set to `false` (disabled) by default.
20+
+
21+
If you set ECCV to `true` (enabled) on a bucket in an XDCR replication topology,
22+
then you must set ECCV to `true` on all buckets participating in the XDCR replication topology.
23+
Otherwise, dependent features may not function.
24+
+
25+
As the Couchbase Server versions earlier than 7.6.6 do not support the `enableCrossClusterVersioning` bucket property,
26+
those buckets cannot participate in a replication topology containing ECCV-enabled buckets.
27+
+
28+
XDCR does not automatically validate ECCV property consistency across buckets.
29+
If you want to prevent a bucket without ECCV from participating in an XDCR replication topology, then before creating or modifying XDCR replications,
30+
you must manually verify that ECCV is disabled for all participating buckets.
31+
+
32+
For more information about XDCR compatibility between different versions of Couchbase Server Enterprise edition, see xref:learn:clusters-and-availability/xdcr-overview.adoc#xdcr-compatibility[XDCR Compatibility].
33+
====
34+
1535
[#hlv-data-maintained-in-xattr]
1636
== Hybrid Logical Vector (HLV) Data Maintained in the Extended Attributes
1737

modules/learn/pages/clusters-and-availability/xdcr-overview.adoc

Lines changed: 72 additions & 50 deletions
Original file line numberDiff line numberDiff line change
@@ -267,7 +267,7 @@ If either a source or a target bucket needs to be flushed after a replication ha
267267
[#xdcr-and-bucket-expiration]
268268
== XDCR and Expiration
269269

270-
Buckets, collections, and documents have a _TTL_ setting, which determines the maximum expiration times of individual items.
270+
Buckets, collections, and documents have a TTL setting, which determines the maximum expiration times of individual items.
271271
This is explained in detail in xref:learn:data/expiration.adoc[Expiration].
272272
For specific information on how TTL is affected by XDCR, see the section xref:learn:data/expiration.adoc#bucket-expiration-and-xdcr[Expiration and XDCR].
273273

@@ -278,65 +278,87 @@ Detailed information is provided in xref:manage:manage-xdcr/monitor-xdcr-replica
278278

279279
[#xdcr-compatibility]
280280
== XDCR Compatibility
281+
[.edition]#{enterprise}#
281282

282-
The following table indicates XDCR compatibility between different versions of Couchbase Enterprise Server, used for source and target clusters.
283+
The following table indicates XDCR compatibility between different versions of Couchbase Server Enterprise edition, used for source and target clusters.
283284

284-
[cols="6,3,3,3,3,3,3"]
285+
[cols="4,4,4,4"]
285286
|===
286287
| *Enterprise Server Version*
287-
| *7.6.x*
288-
| *7.2.x*
289-
| *7.1.4*, *7.1.3*, *7.1.2*, *7.1.1*
290-
| *7.1.0*
291-
| *7.0.x*
292-
| *6.6.x*
293-
294-
| 7.6.x
295-
| ✓
296-
| ✓
297-
| ✓
298-
| ✓
299-
| ✓
300-
| ✓
288+
| *8.0.x*
289+
| *7.6.6 and later versions*
290+
| *7.6.5*, *7.6.4*, *7.6.3*, *7.6.2*, *7.6.1*, *7.6.0*, *7.2.x*, *7.1.x*, *7.0.x*
301291

302-
| 7.2.x
303-
| ✓
304-
| ✓
305-
| ✓
306-
| ✓
307-
| ✓
292+
| 8.0.x
308293
| ✓
294+
| ✓*
295+
| ✓**
309296

310-
| 7.1.4, 7.1.3, 7.1.2, 7.1.1
311-
| ✓
312-
| ✓
313-
| ✓
314-
| ✓
315-
| ✓
316-
| ✓
297+
No ECCV
317298

318-
| 7.1.0
319-
| ✓
320-
| ✓
321-
| ✓
322-
| ✓
323-
| ✓
324-
| ❌
299+
| 7.6.6 and later
300+
| ✓*
301+
| ✓*
302+
| ✓**
325303

326-
| 7.0.x
327-
| ✓
328-
| ✓
329-
| ✓
330-
| ✓
331-
| ✓
332-
| ✓
304+
No ECCV
333305

334-
| 6.6.x
335-
| ✓
336-
| ✓
337-
| ✓
338-
| ❌
339-
| ✓
306+
| 7.6.5, 7.6.4, 7.6.3, 7.6.2, 7.6.1, 7.6.0, 7.2.x, 7.1.x, 7.0.x
307+
| ✓**
308+
309+
No ECCV
310+
| ✓**
311+
312+
No ECCV
340313
| ✓
341314

342315
|===
316+
317+
[NOTE]
318+
====
319+
XDCR Compatibility with vBucket Configuration (for both * and **)::
320+
321+
Starting in Couchbase Server 8.0, Magma storage backend buckets can have either 128 or 1024 vBuckets.
322+
In earlier versions, all buckets had 1024 vBuckets, except on macOS.
323+
+
324+
When creating XDCR replications between the Couchbase Server clusters, make sure of the compatibility of number of vBuckets with the Couchbase Server version as follows:
325+
326+
+
327+
--
328+
* From pre-8.0 to 8.0:
329+
+
330+
The source and destination buckets must have the same number of vBuckets.
331+
For example, when replicating from a 7.x cluster to an 8.x cluster, create the target 8.x bucket with 1024 vBuckets.
332+
333+
* From 8.0 to pre-8.0:
334+
+
335+
The vBucket counts do not need to match.
336+
However, the vBucket count mismatch, in the source and target buckets of an XDCR topology, does not support the bi-directional replication.
337+
338+
* Between 8.0 and later versions:
339+
+
340+
Replications are supported even if the buckets have different vBucket counts.
341+
--
342+
+
343+
For more information about Magma storage, see xref:learn:buckets-memory-and-storage/storage-engines.adoc[Storage Engines].
344+
+
345+
For more information about vBuckets, see xref:learn:buckets-memory-and-storage/vbuckets.adoc[vBuckets].
346+
347+
348+
Cross Cluster Versioning (ECCV) Compatibility (for ** only)::
349+
350+
Starting in Couchbase Server 7.6.6, buckets include the `enableCrossClusterVersioning` (ECCV) property, which is set to `false` (disabled) by default.
351+
+
352+
If you set ECCV to `true` (enabled) on a bucket in an XDCR replication topology,
353+
then you must set ECCV to `true` on all buckets participating in the XDCR replication topology.
354+
Otherwise, dependent features may not function.
355+
+
356+
As the Couchbase Server versions earlier than 7.6.6 do not support the `enableCrossClusterVersioning` bucket property,
357+
those buckets cannot participate in a replication topology containing ECCV-enabled buckets.
358+
+
359+
XDCR does not automatically validate ECCV property consistency across buckets.
360+
If you want to prevent a bucket without ECCV from participating in an XDCR replication topology, then before creating or modifying XDCR replications,
361+
you must manually verify that ECCV is disabled for all participating buckets.
362+
+
363+
For more information about ECCV, see xref:learn:clusters-and-availability/xdcr-enable-crossclusterversioning.adoc[XDCR enableCrossClusterVersioning].
364+
====

0 commit comments

Comments
 (0)