Skip to content

Commit 5dbde09

Browse files
committed
[DOC-13372]: Simplify release note for Magma storage bug (MB-67762)
Signed-off-by: Ray Offiah <[email protected]>
1 parent 0dcae02 commit 5dbde09

File tree

1 file changed

+61
-1
lines changed

1 file changed

+61
-1
lines changed

modules/release-notes/partials/MB-67762.adoc

Lines changed: 61 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,5 +2,65 @@
22
a| https://jira.issues.couchbase.com/browse/MB-67762[MB-67762]
33

44
a| There is an integer overflow bug in buckets using the Magma storage engine.
5+
This bug can potentially cause a subset of mutations
6+
to become invisible to read operations after approximately 500 billion to 2 trillion mutations per bucket.
7+
8+
Compaction needs to be run for the couchbase buckets which are exposed to the bug as reported by the diagnostic script.
9+
10+
[discrete]
11+
===== {counter: seq}. Upgrade Couchbase Server
12+
Upgrade the Couchbase Server on all nodes. You can perform the upgrade using one of two methods ONLY:
13+
14+
* A graceful failover of each node
15+
* An offline upgrade of the Couchbase Server
16+
17+
[discrete]
18+
===== {counter: seq}. Backup Data
19+
Backup Magma data files for nodes with any vulnerable vBucket after gracefully failing over the node or taking the node offline.
20+
To back up Magma data files, copy the /data/bucket directory to a backup location. Note that the copy should be performed after stopping couchbase server to maintain the consistency of the data files:
21+
22+
For clusters identified as being vulnerable, use the following steps to resolve the issues.
23+
24+
[discrete]
25+
===== {counter: seq}. Stop Creating New index
26+
27+
Stop building any index while applying the resolution steps.
28+
29+
[discrete]
30+
===== {counter: seq}. Run Bucket Compaction
31+
32+
Compaction needs to be run for the couchbase buckets which are exposed to the bug as reported by the diagnostic script.
33+
34+
[discrete]
35+
===== {counter: seq}. Upgrade Couchbase Server
36+
37+
Upgrade the Couchbase Server on all nodes. You can perform the upgrade using one of two methods ONLY:
38+
39+
* A graceful failover of each node
40+
* An offline upgrade of the Couchbase Server
41+
42+
[discrete]
43+
===== {counter: seq}. Backup Data
44+
45+
Backup Magma data files for nodes with any vulnerable vBucket after gracefully failing over the node or taking the node offline. To back up Magma data files, copy the /data/bucket directory to a backup location. Note that the copy should be performed after stopping couchbase server to maintain the consistency of the data files:
46+
47+
[source,shellscript]
48+
----
49+
# service couchbase-server stop
50+
51+
# cp -rp /data/bucketname /backup_data/
52+
----
53+
54+
[discrete]
55+
===== {counter: seq}. Perform Delta Recovery and Restart Couchbase Server
56+
57+
Once this step is complete, any documents previously hidden in the vulnerable window will immediately become accessible.
58+
59+
[discrete]
60+
===== {counter: seq}. Reclaim Wasted Disk Space
61+
62+
This step addresses potential storage bloat caused by old document versions not being garbage-collected. To reclaim this disk space, you can perform swap rebalance on the _nodes that the diagnostic script identified_ as being impacted.
63+
== Perform Delta Recovery and Restart Couchbase Server
64+
65+
Once this step is complete, any documents previously hidden in the vulnerable window will immediately become accessible.
566

6-
a| For details, please refer to https://jira.issues.couchbase.com/browse/MB-67762[MB-67762]

0 commit comments

Comments
 (0)