From 34e6dcd213e7038cdb4d087d9b0c3093d8e49050 Mon Sep 17 00:00:00 2001 From: Raunak Jalan <41023976+RaunakJalan@users.noreply.github.com> Date: Mon, 23 Feb 2026 20:34:32 +0530 Subject: [PATCH 1/2] Update expanding-storage-cluster.md --- .../scaling/expanding-storage-cluster.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/docs/maintenance-operations/scaling/expanding-storage-cluster.md b/docs/maintenance-operations/scaling/expanding-storage-cluster.md index a324a2da..ce66670e 100644 --- a/docs/maintenance-operations/scaling/expanding-storage-cluster.md +++ b/docs/maintenance-operations/scaling/expanding-storage-cluster.md @@ -11,8 +11,18 @@ the cluster to ensure equal usage distribution. While these migration tasks are designed to be minimal, it is still recommended to expand the cluster at times when the storage cluster isn't under full utilization. -To start a new storage node, follow the storage node installation according to your chosen set-up: +!!! info + Add storage nodes in **pairs** (i.e., 2, 4, 6, … nodes at a time). + Expansions with an odd number of nodes are **not supported**. + +To add a new storage node, follow the installation steps for your chosen deployment method up to the point where nodes are added to the cluster, then continue here: - [Storage nodes in Kubernetes](../../deployments/kubernetes/index.md) - [Storage nodes on Linux](../../deployments/install-on-linux/install-sp.md) +After adding the **first** new storage node, the cluster transitions to **IN_EXPANSION** and starts background rebalancing. +Add the remaining node(s) required for the expansion (storage nodes must be added in **pairs**). +Once all newly added nodes are healthy/ready, finalize the expansion: + +```bash title="Finalize cluster expansion" +{{ cliname }} complete-expand From c34df6c6d6fd663d30cbf61a4d4cb32ed0ca52dd Mon Sep 17 00:00:00 2001 From: noctarius aka Christoph Engelbert Date: Mon, 23 Feb 2026 16:16:59 +0100 Subject: [PATCH 2/2] Fixed code example Add instructions to finalize cluster expansion after adding nodes. --- docs/maintenance-operations/scaling/expanding-storage-cluster.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/maintenance-operations/scaling/expanding-storage-cluster.md b/docs/maintenance-operations/scaling/expanding-storage-cluster.md index ce66670e..0fb81564 100644 --- a/docs/maintenance-operations/scaling/expanding-storage-cluster.md +++ b/docs/maintenance-operations/scaling/expanding-storage-cluster.md @@ -26,3 +26,4 @@ Once all newly added nodes are healthy/ready, finalize the expansion: ```bash title="Finalize cluster expansion" {{ cliname }} complete-expand +```