Skip to content

Commit 06cc273

Browse files
committed
updated xdcr compatibility matrix and added relevant Notes
1 parent 4b6ef99 commit 06cc273

1 file changed

Lines changed: 57 additions & 48 deletions

File tree

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

Lines changed: 57 additions & 48 deletions
Original file line numberDiff line numberDiff line change
@@ -281,62 +281,71 @@ Detailed information is provided in xref:manage:manage-xdcr/monitor-xdcr-replica
281281

282282
The following table indicates XDCR compatibility between different versions of Couchbase Enterprise Server, used for source and target clusters.
283283

284-
[cols="6,3,3,3,3,3,3"]
284+
[cols="4,4,4,4"]
285285
|===
286286
| *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-
| ✓
287+
| *8.0.x*
288+
| *7.6.6* and later
289+
| *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*
301290

302-
| 7.2.x
303-
| ✓
304-
| ✓
305-
| ✓
306-
| ✓
307-
| ✓
291+
| 8.0.x
308292
| ✓
293+
| ✓*
294+
| ✓**
309295

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

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

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

334-
| 6.6.x
335-
| ✓
336-
| ✓
337-
| ✓
338-
| ❌
339-
| ✓
305+
| 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
306+
| ✓**
307+
308+
No ECCV
309+
| ✓**
310+
311+
No ECCV
340312
| ✓
341313

342314
|===
315+
316+
[NOTE]
317+
====
318+
XDCR Compatibility with vBucket Configuration::
319+
320+
Starting in Couchbase Server 8.0, Magma storage backend buckets use 128 vBuckets.
321+
In earlier versions, all buckets use 1024 vBuckets, except on macOS.
322+
+
323+
When creating XDCR replications between the Couchbase Server clusters, the number of vBuckets must be compatible as follows:
324+
325+
* From pre-8.0 to 8.0:
326+
+
327+
The source and destination buckets must have the same number of vBuckets.
328+
For example, when replicating from a 7.x cluster to an 8.x cluster, create the target 8.x bucket with 1024 vBuckets.
329+
330+
* From 8.0 to pre-8.0:
331+
+
332+
The vBucket counts do not need to match.
333+
However, the vBucket count mismatch, in the source and target buckets of an XDCR topology, does not support the bi-directional replication.
334+
335+
* Between 8.0 and later versions:
336+
+
337+
Replications are supported even if the buckets have different vBucket counts.
338+
339+
Cross-Cluster Versioning (ECCV) Compatibility::
340+
341+
Starting in Couchbase Server 7.6.6, buckets include the `enableCrossClusterVersioning` (ECCV) property, which is set to `false` (disabled) by default.
342+
+
343+
If you set ECCV to `true` (enabled) on a bucket, then you must set ECCV to `true` on all buckets participating in the XDCR replication topology.
344+
Otherwise, dependent features may not function.
345+
+
346+
As the Couchbase Server versions earlier than 7.6.6 do not support the `enableCrossClusterVersioning` bucket property,
347+
those buckets cannot participate in a replication topology containing ECCV-enabled buckets.
348+
+
349+
Couchbase Server does not automatically validate ECCV consistency across clusters.
350+
If you want to enable ECCV, then before creating or modifying XDCR replications, you must manually verify that ECCV is enabled on all participating buckets.
351+
====

0 commit comments

Comments
 (0)