Skip to content

Commit 7cdac33

Browse files
committed
DOC-3706 Quorum node copy edits and examples
1 parent e0529b9 commit 7cdac33

File tree

1 file changed

+23
-11
lines changed

1 file changed

+23
-11
lines changed

content/operate/rs/clusters/quorum-node.md

Lines changed: 23 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -5,30 +5,42 @@ categories:
55
- docs
66
- operate
77
- rs
8-
description: To reduce infrastucture costs, you can set up a quorum-only node with minimal resources.
8+
description: To reduce infrastructure costs, you can set up a quorum-only node with minimal resources.
99
linktitle: Set up a quorum node
1010
weight: 30
1111
---
1212

13-
Clusters require an odd number of nodes to maintain [quorum](https://en.wikipedia.org/wiki/Quorum_(distributed_computing)) and avoid [split-brain](https://en.wikipedia.org/wiki/Split-brain_(computing)) scenarios when making decisions. If you need to add another node to a cluster for quorum but want to provision less resources to reduce infrastructure costs, you can set up a quorum node instead of a regular node.
13+
Clusters require an odd number of nodes to maintain [quorum](https://en.wikipedia.org/wiki/Quorum_(distributed_computing)) and avoid [split-brain](https://en.wikipedia.org/wiki/Split-brain_(computing)) scenarios when making decisions. If you need to add another node to a cluster for quorum but want to provision fewer resources and reduce infrastructure costs, you can set up a quorum node instead of a regular node.
1414

15-
Quorum nodes only participate in voting for cluster quorum decisions and can act as a tiebreaker.
16-
17-
Because quorum nodes do not host database shards or endpoints, they have lower resource requirements. A quorum node should have at least 2 cores and 8 GB of RAM. See [hardware requirements]({{<relref "/operate/rs/installing-upgrading/install/plan-deployment/hardware-requirements">}}) for more details and considerations.
15+
Quorum nodes participate in cluster quorum decisions and can act as a tiebreaker. However, they do not host database shards or endpoints, which reduces their resource requirements. A quorum node should have at least 2 cores and 8 GB of RAM. See the [hardware requirements]({{<relref "/operate/rs/installing-upgrading/install/plan-deployment/hardware-requirements">}}) for more details and considerations.
1816

1917
## Enable quorum_only setting
2018

21-
1. Run `rladmin status node` and find a node with no shards:
19+
1. Run [`rladmin status nodes`]({{<relref "/operate/rs/references/cli-utilities/rladmin/status#status-nodes">}}) and find a node with no shards.
20+
21+
In the following example, nodes without shards have `0/100` for the `SHARDS` column.
2222

2323
```bash
24-
rladmin status node
24+
$ rladmin status nodes
25+
CLUSTER NODES:
26+
NODE:ID ROLE ADDRESS EXTERNAL_ADDRESS HOSTNAME SHARDS CORES FREE_RAM PROVISIONAL_RAM VERSION STATUS
27+
node:1 master 192.0.2.0 3d99db1fdf4b 0/100 2 6.33GB/7.79GB 4.93GB/6.39GB 7.8.6-36 OK
28+
node:2 slave 198.51.100.0 b87cc06c830f 2/100 2 6.44GB/7.79GB 1.04GB/6.39GB 7.8.6-36 OK
29+
*node:3 slave 203.0.113.0 fc7a3d332458 0/100 2 6.45GB/7.79GB 4.93GB/6.39GB 7.8.6-36 OK
2530
```
2631

2732
2. Enable `quorum_only` for the node using [`rladmin tune node`]({{<relref "/operate/rs/references/cli-utilities/rladmin/tune#tune-node">}}):
2833
```bash
29-
rladmin tune node <quorum-node-id> quorum_only enabled
34+
$ rladmin tune node <node-id> quorum_only enabled
3035
```
3136

32-
3. Rerun `rladmin status node` to verify. The quorum node will show:
33-
- `0/0` shards
34-
- `0KB/0KB` provisional RAM
37+
3. Rerun `rladmin status nodes` to verify the quorum node shows `0/0` for `SHARDS` and `0KB/0KB` for `PROVISIONAL_RAM`.
38+
39+
```sh
40+
$ rladmin status nodes
41+
CLUSTER NODES:
42+
NODE:ID ROLE ADDRESS EXTERNAL_ADDRESS HOSTNAME SHARDS CORES FREE_RAM PROVISIONAL_RAM VERSION STATUS
43+
node:1 master 192.0.2.0 3d99db1fdf4b 0/100 2 6.33GB/7.79GB 4.93GB/6.39GB 7.8.6-36 OK
44+
node:2 slave 198.51.100.0 b87cc06c830f 2/100 2 6.44GB/7.79GB 1.04GB/6.39GB 7.8.6-36 OK
45+
*node:3 slave 203.0.113.0 fc7a3d332458 0/0 2 6.45GB/7.79GB 0KB/0KB 7.8.6-36 OK
46+
```

0 commit comments

Comments
 (0)