Skip to content

Commit 14d7102

Browse files
AV25242RichardSmedley
AV25242
and
RichardSmedley
authored
added special note for mixed mode mitigation (#251)
* added special note for mixed mode mitigation * known issue DOC-9915 Co-authored-by: Richard Smedley <rgsmedley@gmail.com>
1 parent 0957132 commit 14d7102

1 file changed

Lines changed: 48 additions & 2 deletions

File tree

‎modules/project-docs/pages/sdk-release-notes.adoc‎

Lines changed: 48 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -116,9 +116,16 @@ https://docs.couchbase.com/sdk-api/couchbase-net-client-3.2.9[API Reference] |
116116
https://www.nuget.org/packages/CouchbaseNetClient/3.2.9[Nuget]
117117

118118
=== Special Note
119-
* Between bug fixes and performance improvements, the ChannelConnectionPool will be made the default in a future release. Give it a try now with `ClusterOptions.Experiments.ChannelConnectionPools = true;`
119+
120+
* During a rebalance upgrade from 6.x (or any earlier version) to 7x, in mixed mode (where you are communicating with Couchbase Server whilst some but not all nodes are upgraded), there is a known issue where data may be written to the wrong location.
121+
The solution is to either upgrade to 3.2.9, or to quiesce application processing so there are no writes until you have upgraded all nodes.
122+
If you encounter a similar situation during migration and need help with mitigation, please contact our support team.
123+
124+
* Between bug fixes and performance improvements, the `ChannelConnectionPool` will be made the default in a future release.
125+
Give it a try now with `ClusterOptions.Experiments.ChannelConnectionPools = true;`
120126

121127
=== Fixed Issues
128+
122129
* https://issues.couchbase.com/browse/NCBC-3174[NCBC-3174]: Out of Retries misclassified as Operation Timed Out
123130

124131
* https://issues.couchbase.com/browse/NCBC-3176[NCBC-3176]: ExponentialBackoff only ever increases globally
@@ -139,7 +146,8 @@ https://www.nuget.org/packages/CouchbaseNetClient/3.2.9[Nuget]
139146

140147
* https://issues.couchbase.com/browse/NCBC-3163[NCBC-3163]: Bucket name escaping in QueryIndexManager.GetAllIndexesAsync
141148

142-
* https://issues.couchbase.com/browse/NCBC-3171[NCBC-3171]: Documents may be written to the wrong location during write operations to a mixed-mode cluster running 7.0.3 and < 7.x
149+
* https://issues.couchbase.com/browse/NCBC-3171[NCBC-3171]: Documents may be written to the wrong location in a mixed-mode cluster set-up.
150+
See the <<special-note,Special Note>> for more details.
143151

144152
* https://issues.couchbase.com/browse/NCBC-3172[NCBC-3172]: .NET SDK fails to connect to correct node in custom port (cluster_run) multi-node setup
145153

@@ -165,6 +173,11 @@ https://www.nuget.org/packages/CouchbaseNetClient/3.2.8[Nuget]
165173
NOTE: .NET Core 2.1 support has been dropped from the SDK, as of 3.2.5.
166174
This corresponds to Microsoft's decision to EOL .NET Core 2.1 on August 21, 2021.
167175

176+
=== Known Issues
177+
178+
* https://issues.couchbase.com/browse/NCBC-3171[NCBC-3171]: Documents may be written to the wrong location in a mixed-mode cluster set-up.
179+
See the <<special-note,Special Note>> for more details.
180+
168181
=== Fixed Issues
169182

170183
* https://issues.couchbase.com/browse/NCBC-3091[NCBC-3091]:
@@ -226,6 +239,11 @@ https://www.nuget.org/packages/CouchbaseNetClient/3.2.7[Nuget]
226239
NOTE: .NET Core 2.1 support has been dropped from the SDK, as of 3.2.5.
227240
This corresponds to Microsoft's decision to EOL .NET Core 2.1 on August 21, 2021.
228241

242+
=== Known Issues
243+
244+
* https://issues.couchbase.com/browse/NCBC-3171[NCBC-3171]: Documents may be written to the wrong location in a mixed-mode cluster set-up.
245+
See the <<special-note,Special Note>> for more details.
246+
229247
=== Fixed Issues
230248

231249
* https://issues.couchbase.com/browse/NCBC-3085[NCBC-3085]:
@@ -300,6 +318,11 @@ https://www.nuget.org/packages/CouchbaseNetClient/3.2.6[Nuget]
300318
NOTE: .NET Core 2.1 support has been dropped from the SDK, as of 3.2.5.
301319
This corresponds to Microsoft's decision to EOL .NET Core 2.1 on August 21, 2021.
302320

321+
=== Known Issues
322+
323+
* https://issues.couchbase.com/browse/NCBC-3171[NCBC-3171]: Documents may be written to the wrong location in a mixed-mode cluster set-up.
324+
See the <<special-note,Special Note>> for more details.
325+
303326
=== Fixed Issues
304327

305328
* https://issues.couchbase.com/browse/NCBC-2647[NCBC-2647]:
@@ -420,6 +443,11 @@ https://www.nuget.org/packages/CouchbaseNetClient/3.2.5[Nuget]
420443
NOTE: .NET Core 2.1 support has been dropped from the SDK, as of 3.2.5.
421444
This corresponds to Microsoft's decision to EOL .NET Core 2.1 on August 21, 2021.
422445

446+
=== Known Issues
447+
448+
* https://issues.couchbase.com/browse/NCBC-3171[NCBC-3171]: Documents may be written to the wrong location in a mixed-mode cluster set-up.
449+
See the <<special-note,Special Note>> for more details.
450+
423451
=== Fixed Issues
424452

425453
* https://issues.couchbase.com/browse/NCBC-2851[NCBC-2851]:
@@ -501,6 +529,7 @@ Fixes to problematic OpenTelemetry tracing registration.
501529
A consumer may now register with an OpenTelemetry provider which
502530
is being managed outside the SDK.
503531

532+
504533
== Version 3.2.4 (2 November 2021)
505534

506535
Version 3.2.4 is the fourth release of the 3.2 series.
@@ -511,6 +540,9 @@ https://www.nuget.org/packages/CouchbaseNetClient/3.2.4[Nuget]
511540

512541
=== Known Issues
513542

543+
* https://issues.couchbase.com/browse/NCBC-3171[NCBC-3171]: Documents may be written to the wrong location in a mixed-mode cluster set-up.
544+
See the <<special-note,Special Note>> for more details.
545+
514546
* https://issues.couchbase.com/browse/NCBC-2851[NCBC-2851]:
515547
TimeoutExceptions continue after rebound in Failover/Eject tests.
516548

@@ -556,6 +588,9 @@ https://www.nuget.org/packages/CouchbaseNetClient/3.2.3[Nuget]
556588

557589
=== Known Issues
558590

591+
* https://issues.couchbase.com/browse/NCBC-3171[NCBC-3171]: Documents may be written to the wrong location in a mixed-mode cluster set-up.
592+
See the <<special-note,Special Note>> for more details.
593+
559594
* https://issues.couchbase.com/browse/NCBC-2851[NCBC-2851]:
560595
TimeoutExceptions continue after rebound in Failover/Eject tests.
561596

@@ -591,6 +626,12 @@ https://www.nuget.org/packages/CouchbaseNetClient/3.2.2[Nuget]
591626

592627
This is a re-release of 3.2.1 with exactly the same commits due to a packaging bug in 3.2.1. The only difference is the version and package fix.
593628

629+
=== Known Issues
630+
631+
* https://issues.couchbase.com/browse/NCBC-3171[NCBC-3171]: Documents may be written to the wrong location in a mixed-mode cluster set-up.
632+
See the <<special-note,Special Note>> for more details.
633+
634+
594635
== Version 3.2.1 (9 September 2021) DO NOT USE - USE 3.2.2 INSTEAD
595636

596637
Version 3.2.1 is the second release of the 3.2 series.
@@ -601,6 +642,8 @@ https://www.nuget.org/packages/CouchbaseNetClient/3.2.1[Nuget]
601642

602643
=== Known Issues
603644

645+
* https://issues.couchbase.com/browse/NCBC-3171[NCBC-3171]: Documents may be written to the wrong location in a mixed-mode cluster set-up.
646+
See the <<special-note,Special Note>> for more details.
604647
* https://issues.couchbase.com/browse/NCBC-2851[NCBC-2851]:
605648
TimeoutExceptions continue after rebound in Failover/Eject tests.
606649

@@ -625,6 +668,9 @@ https://www.nuget.org/packages/CouchbaseNetClient/3.2.0[Nuget]
625668

626669
=== Known Issues
627670

671+
* https://issues.couchbase.com/browse/NCBC-3171[NCBC-3171]: Documents may be written to the wrong location in a mixed-mode cluster set-up.
672+
See the <<special-note,Special Note>> for more details.
673+
628674
* https://issues.couchbase.com/browse/NCBC-2851[NCBC-2851]:
629675
TimeoutExceptions continue after rebound in Failover/Eject tests.
630676

0 commit comments

Comments
 (0)