content/operate/rs/references/cli-utilities/rladmin/node/enslave.md
Changes the resources of a node to replicas.
node enslaveChanges all of the node's endpoints and shards to replicas.
rladmin node <ID> enslave
[demote_node]
[retry_timeout_seconds <seconds>]
| Parameter | Type/Value | Description |
|---|---|---|
| node | integer | Changes all of the node's endpoints and shards to replicas |
| demote_node | If the node is a primary node, changes the node to replica | |
| retry_timeout_seconds | integer | Retries on failure until the specified number of seconds has passed. |
Returns OK if the roles were successfully changed. Otherwise, it returns an error.
Use [rladmin status shards]({{< relref "/operate/rs/references/cli-utilities/rladmin/status#status-shards" >}}) to verify that the roles were changed.
$ rladmin status shards node 2
SHARDS:
DB:ID NAME ID NODE ROLE SLOTS USED_MEMORY STATUS
db:6 tr02 redis:14 node:2 master 0-4095 3.2MB OK
db:6 tr02 redis:16 node:2 master 4096-8191 3.12MB OK
db:6 tr02 redis:18 node:2 master 8192-12287 3.16MB OK
db:6 tr02 redis:20 node:2 master 12288-16383 3.12MB OK
$ rladmin status nodes
CLUSTER NODES:
NODE:ID ROLE ADDRESS EXTERNAL_ADDRESS HOSTNAME SHARDS CORES FREE_RAM PROVISIONAL_RAM VERSION STATUS
*node:1 slave 192.0.2.12 198.51.100.1 3d99db1fdf4b 1/100 6 14.43GB/19.54GB 10.87GB/16.02GB 6.2.12-37 OK
node:2 master 192.0.2.13 198.51.100.2 fc7a3d332458 4/100 6 14.43GB/19.54GB 10.88GB/16.02GB 6.2.12-37 OK
node:3 slave 192.0.2.14 b87cc06c830f 5/120 6 14.43GB/19.54GB 10.83GB/16.02GB 6.2.12-37 OK
$ rladmin node 2 enslave demote_node
Performing enslave_node action on node:2: 100%
OK
$ rladmin status nodes
CLUSTER NODES:
NODE:ID ROLE ADDRESS EXTERNAL_ADDRESS HOSTNAME SHARDS CORES FREE_RAM PROVISIONAL_RAM VERSION STATUS
*node:1 master 192.0.2.12 198.51.100.1 3d99db1fdf4b 1/100 6 14.72GB/19.54GB 10.91GB/16.02GB 6.2.12-37 OK
node:2 slave 192.0.2.13 198.51.100.2 fc7a3d332458 4/100 6 14.72GB/19.54GB 11.17GB/16.02GB 6.2.12-37 OK
node:3 slave 192.0.2.14 b87cc06c830f 5/120 6 14.72GB/19.54GB 10.92GB/16.02GB 6.2.12-37 OK
$ rladmin status shards node 2
SHARDS:
DB:ID NAME ID NODE ROLE SLOTS USED_MEMORY STATUS
db:6 tr02 redis:14 node:2 slave 0-4095 2.99MB OK
db:6 tr02 redis:16 node:2 slave 4096-8191 3.01MB OK
db:6 tr02 redis:18 node:2 slave 8192-12287 2.93MB OK
db:6 tr02 redis:20 node:2 slave 12288-16383 3.06MB OK
node enslave endpoints_onlyChanges the role for all endpoints on a node to replica.
rladmin node <ID> enslave endpoints_only
[retry_timeout_seconds <seconds>]
| Parameter | Type/Value | Description |
|---|---|---|
| node | integer | Changes all of the node's endpoints to replicas |
| retry_timeout_seconds | integer | Retries on failure until the specified number of seconds has passed. |
Returns OK if the roles were successfully changed. Otherwise, it returns an error.
Use [rladmin status endpoints]({{< relref "/operate/rs/references/cli-utilities/rladmin/status#status-endpoints" >}}) to verify that the roles were changed.
$ rladmin status endpoints
ENDPOINTS:
DB:ID NAME ID NODE ROLE SSL
db:5 tr01 endpoint:5:1 node:1 single No
db:6 tr02 endpoint:6:1 node:3 all-master-shards No
$ rladmin node 1 enslave endpoints_only
Performing enslave_node action on node:1: 100%
OK
$ rladmin status endpoints
ENDPOINTS:
DB:ID NAME ID NODE ROLE SSL
db:5 tr01 endpoint:5:1 node:3 single No
db:6 tr02 endpoint:6:1 node:3 all-master-shards No
node enslave shards_onlyChanges the role for all shards of a node to replica.
rladmin node <ID> enslave shards_only
[retry_timeout_seconds <seconds>]
| Parameter | Type/Value | Description |
|---|---|---|
| node | integer | Changes all of the node's shards to replicas |
| retry_timeout_seconds | integer | Retries on failure until the specified number of seconds has passed. |
Returns OK if the roles were successfully changed. Otherwise, it returns an error.
Use [rladmin status shards]({{< relref "/operate/rs/references/cli-utilities/rladmin/status#status-shards" >}}) to verify that the roles were changed.
$ rladmin status shards node 3
SHARDS:
DB:ID NAME ID NODE ROLE SLOTS USED_MEMORY STATUS
db:5 tr01 redis:12 node:3 master 0-16383 3.04MB OK
db:6 tr02 redis:15 node:3 master 0-4095 4.13MB OK
db:6 tr02 redis:17 node:3 master 4096-8191 4.13MB OK
db:6 tr02 redis:19 node:3 master 8192-12287 4.13MB OK
db:6 tr02 redis:21 node:3 master 12288-16383 4.13MB OK
$ rladmin node 3 enslave shards_only
Performing enslave_node action on node:3: 100%
OK
$ rladmin status shards node 3
SHARDS:
DB:ID NAME ID NODE ROLE SLOTS USED_MEMORY STATUS
db:5 tr01 redis:12 node:3 slave 0-16383 2.98MB OK
db:6 tr02 redis:15 node:3 slave 0-4095 4.23MB OK
db:6 tr02 redis:17 node:3 slave 4096-8191 4.11MB OK
db:6 tr02 redis:19 node:3 slave 8192-12287 4.19MB OK
db:6 tr02 redis:21 node:3 slave 12288-16383 4.27MB OK