Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
26 commits
Select commit Hold shift + click to select a range
64d4e12
first commit
rao-shwe May 9, 2025
3c1cefb
smart-batching
rao-shwe May 9, 2025
1756d91
added-file-based-rebalance-note
rao-shwe May 9, 2025
66e43d7
Added all contents except flow diagrams
rao-shwe Nov 10, 2025
41fd729
minor changes
rao-shwe Nov 11, 2025
4042ab0
Minor grammar edit in smart batching section
rao-shwe Nov 12, 2025
05c37e1
rewrote and rearranged contents
rao-shwe Nov 25, 2025
3efae0d
Added corrected and formatted examples
rao-shwe Nov 25, 2025
8734ca3
A few arrangements
rao-shwe Nov 25, 2025
4b0854a
Interlinked a few sections for easy readability
rao-shwe Nov 25, 2025
5f642cf
Edited the last heading
rao-shwe Nov 25, 2025
e6225f0
testing images
rao-shwe Nov 26, 2025
65bbe68
test 2 of images
rao-shwe Nov 26, 2025
172325f
Added all flow diagrams
rao-shwe Nov 26, 2025
1b2f326
Additional info and updated images
rao-shwe Nov 26, 2025
8285e28
Added empty node batching info
rao-shwe Nov 26, 2025
202b94d
Minor edit
rao-shwe Nov 26, 2025
af869a3
Implemented technical review comments from Engg team
rao-shwe Nov 27, 2025
5d4d4f1
A minor grammar edit
rao-shwe Nov 27, 2025
1d0e23b
Moved again Swap Rebalance to a proer location
rao-shwe Nov 27, 2025
fe004f2
Added the last 3 sub-sections and implemnted comments from gdocs
rao-shwe Nov 28, 2025
5b77a5b
Fixed minor formatting issues and rewrote a Note
rao-shwe Nov 28, 2025
5bb9aa7
Added links to connect sections with each other
rao-shwe Nov 28, 2025
2ac03d0
Minor formatting fixes
rao-shwe Nov 28, 2025
2c3507f
Fixed some bookmark and image issues
rao-shwe Nov 28, 2025
8d4de11
Retry rebalance and impression of mode index movement
rao-shwe Dec 1, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions modules/ROOT/nav.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -69,6 +69,7 @@ include::third-party:partial$nav.adoc[]
** xref:learn:clusters-and-availability/size-limitations.adoc[Size Limits]
** xref:learn:clusters-and-availability/nodes.adoc[Nodes]
*** xref:learn:clusters-and-availability/rebalance.adoc[Rebalance]
**** xref:learn:clusters-and-availability/rebalance-and-index-service.adoc[Index Rebalance]
*** xref:learn:clusters-and-availability/removal.adoc[Removal]
*** xref:learn:clusters-and-availability/failover.adoc[Failover]
**** xref:learn:clusters-and-availability/graceful-failover.adoc[Graceful]
Expand Down
2 changes: 1 addition & 1 deletion modules/install/pages/upgrade-feature-availability.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ _Not usable in mixed mode_ indicates that cluster-upgrade must be fully complete
|===
| Feature | Whether Usable in Mixed Mode

| xref:learn:clusters-and-availability/rebalance.adoc#index-rebalance-methods[File-based Index Rebalancing]
| xref:learn:clusters-and-availability/rebalance-and-index-service.adoc#index-rebalance-methods[]
| You cannot enable file-based index rebalancing until all nodes have upgraded to version 7.6 or later.

| xref:learn:data/scopes-and-collections.adoc[Scopes & Collections]
Expand Down
2 changes: 1 addition & 1 deletion modules/introduction/partials/new-features-76.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -150,7 +150,7 @@ See xref:manage:monitor/set-up-prometheus-for-monitoring.adoc[Configure Promethe

* You can choose to have the rebalance process move an index's files between nodes instead of rebuilding them from scratch.
This setting improves rebalance performance as moving the files is faster than rebuilding them.
See xref:learn:clusters-and-availability/rebalance.adoc#index-rebalance-methods[Index Rebalance Methods].
See xref:learn:clusters-and-availability/rebalance-and-index-service.adoc#index-rebalance-methods[].

=== Search Service

Expand Down
2 changes: 1 addition & 1 deletion modules/introduction/partials/new-features-76_2.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,7 @@ For details, see xref:n1ql:n1ql-language-reference/createindex.adoc[CREATE INDEX
* In Couchbase Server Versions 7.6.0 and 7.6.1, enabling file-based index rebalance prevented you from controlling which Index Service nodes contain an index.
Version 7.6.2 removes this restriction.
You can now use the `WITH <node>` clause of the `CREATE INDEX` {sqlpp} statement when your cluster has file-based index rebalancing enabled.
See xref:learn:clusters-and-availability/rebalance.adoc#index-rebalance-methods[Index Rebalance Methods] for more information.
See xref:learn:clusters-and-availability/rebalance-and-index-service.adoc#index-rebalance-methods[] for more information.
+
NOTE: You still cannot use the `WITH <node>` clause with the `ALTER INDEX` statement when your cluster has file-based index rebalancing enabled.

Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
9 changes: 5 additions & 4 deletions modules/learn/pages/clusters-and-availability/failover.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -27,9 +27,11 @@ Graceful failover _must_ be manually initiated. Hard failover _can_ be manually
Hard failover can also be initiated automatically by Couchbase Server: this is known as _automatic_ failover.
The Cluster Manager detects the unavailability of a node, and duly initiates a _hard_ failover, without administrator intervention.


Note that when a node is failed over (as opposed to _removed_), some replica vBuckets are lost from the surviving nodes; since some are promoted to _active_ status, and are not replaced with new replica-copies.
By contrast, xref:learn:clusters-and-availability/removal.adoc[removal] creates new copies of those replica vBuckets that would otherwise be lost. This maintains the cluster's previous level of data-availability; but results in greater competition for memory resources, across the surviving nodes.
NOTE: When a node is failed over, some replica vBuckets on the remaining nodes are promoted to active status but are not recreated as new replicas.
As a result, the cluster temporarily loses those replica copies.
+
In contrast, when a node is removed, the cluster automatically restores any replica vBuckets that would otherwise be lost during xref:learn:clusters-and-availability/removal.adoc[removal].
This preserves the cluster’s data availability level, but increases memory resource usage on the surviving nodes.

Ideally, after any failover, xref:learn:clusters-and-availability/rebalance.adoc[rebalance] should be performed.
This is especially important when a Data Service node has been failed over, since the rebalance will ensure an optimal ratio of active to replica vBuckets across all the remaining Data Service nodes.
Expand Down Expand Up @@ -180,7 +182,6 @@ For example, Couchbase Server considers a node running Analytics, Indexing, and
If one is available, Couchbase Service always chooses an the cluster's xref:learn:clusters-and-availability/cluster-manager.adoc#master-services[Master Services] to host the active Master Service.
Arbiter nodes do not run any services, and are therefore perfect candidates for hosting the Master Service.


[#node-removal]
== Node Removal

Expand Down
Loading