{ "schema_version": 2, "id": "operate/rs/references/cli-utilities/rladmin/node/enslave", "title": "rladmin node enslave", "url": "https://redis.io/docs/latest/operate/rs/references/cli-utilities/rladmin/node/enslave/", "summary": "Changes a node's resources to replicas.", "tags": [ "docs", "operate", "rs" ], "last_updated": "2026-09-24T10:14:21+01:00", "page_type": "content", "content_hash": "a8072e1cb7ca0fe65ee39d7812538c5ac0f5575cb7d53a42ceeb2c888137b272", "sections": [ { "id": "overview", "title": "Overview", "role": "overview", "text": "Changes the resources of a node to replicas." }, { "id": "node-enslave", "title": "`node enslave`", "role": "content", "text": "Changes all of the node's endpoints and shards to replicas.\n\n[code example]" }, { "id": "parameters", "title": "Parameters", "role": "parameters", "text": "| Parameter | Type/Value | Description |\n|-----------------------|--------------------------------|-------------------------------------------------------------------------------------------|\n| node | integer | Changes all of the node's endpoints and shards to replicas |\n| demote_node | | If the node is a primary node, changes the node to replica |\n| retry_timeout_seconds | integer | Retries on failure until the specified number of seconds has passed. |" }, { "id": "returns", "title": "Returns", "role": "returns", "text": "Returns `OK` if the roles were successfully changed. Otherwise, it returns an error.\n\nUse [`rladmin status shards`](https://redis.io/docs/latest/operate/rs/references/cli-utilities/rladmin/status#status-shards) to verify that the roles were changed." }, { "id": "example", "title": "Example", "role": "example", "text": "[code example]" }, { "id": "node-enslave-endpoints_only", "title": "`node enslave endpoints_only`", "role": "content", "text": "Changes the role for all endpoints on a node to replica.\n\n[code example]" }, { "id": "parameters-1", "title": "Parameters", "role": "parameters", "text": "| Parameter | Type/Value | Description |\n|-----------------------|--------------------------------|-------------------------------------------------------------------------------------------|\n| node | integer | Changes all of the node's endpoints to replicas |\n| retry_timeout_seconds | integer | Retries on failure until the specified number of seconds has passed. |" }, { "id": "returns-1", "title": "Returns", "role": "returns", "text": "Returns `OK` if the roles were successfully changed. Otherwise, it returns an error.\n\nUse [`rladmin status endpoints`](https://redis.io/docs/latest/operate/rs/references/cli-utilities/rladmin/status#status-endpoints) to verify that the roles were changed." }, { "id": "example-1", "title": "Example", "role": "example", "text": "[code example]" }, { "id": "node-enslave-shards_only", "title": "`node enslave shards_only`", "role": "content", "text": "Changes the role for all shards of a node to replica.\n\n[code example]" }, { "id": "parameters-2", "title": "Parameters", "role": "parameters", "text": "| Parameter | Type/Value | Description |\n|-----------------------|--------------------------------|-------------------------------------------------------------------------------------------|\n| node | integer | Changes all of the node's shards to replicas |\n| retry_timeout_seconds | integer | Retries on failure until the specified number of seconds has passed. |" }, { "id": "returns-2", "title": "Returns", "role": "returns", "text": "Returns `OK` if the roles were successfully changed. Otherwise, it returns an error.\n\nUse [`rladmin status shards`](https://redis.io/docs/latest/operate/rs/references/cli-utilities/rladmin/status#status-shards) to verify that the roles were changed." }, { "id": "example-2", "title": "Example", "role": "example", "text": "[code example]" } ], "examples": [ { "id": "node-enslave-ex0", "language": " sh", "code": "rladmin node enslave\n [demote_node]\n [retry_timeout_seconds ]", "section_id": "node-enslave" }, { "id": "example-ex0", "language": "sh", "code": "$ rladmin status shards node 2\nSHARDS:\nDB:ID NAME ID NODE ROLE SLOTS USED_MEMORY STATUS\ndb:6 tr02 redis:14 node:2 master 0-4095 3.2MB OK\ndb:6 tr02 redis:16 node:2 master 4096-8191 3.12MB OK\ndb:6 tr02 redis:18 node:2 master 8192-12287 3.16MB OK\ndb:6 tr02 redis:20 node:2 master 12288-16383 3.12MB OK\n$ rladmin status nodes\nCLUSTER NODES:\nNODE:ID ROLE ADDRESS EXTERNAL_ADDRESS HOSTNAME SHARDS CORES FREE_RAM PROVISIONAL_RAM VERSION STATUS\n*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\nnode: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\nnode:3 slave 192.0.2.14 b87cc06c830f 5/120 6 14.43GB/19.54GB 10.83GB/16.02GB 6.2.12-37 OK\n$ rladmin node 2 enslave demote_node\nPerforming enslave_node action on node:2: 100%\nOK\n$ rladmin status nodes\nCLUSTER NODES:\nNODE:ID ROLE ADDRESS EXTERNAL_ADDRESS HOSTNAME SHARDS CORES FREE_RAM PROVISIONAL_RAM VERSION STATUS\n*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\nnode: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\nnode:3 slave 192.0.2.14 b87cc06c830f 5/120 6 14.72GB/19.54GB 10.92GB/16.02GB 6.2.12-37 OK\n$ rladmin status shards node 2\nSHARDS:\nDB:ID NAME ID NODE ROLE SLOTS USED_MEMORY STATUS\ndb:6 tr02 redis:14 node:2 slave 0-4095 2.99MB OK\ndb:6 tr02 redis:16 node:2 slave 4096-8191 3.01MB OK\ndb:6 tr02 redis:18 node:2 slave 8192-12287 2.93MB OK\ndb:6 tr02 redis:20 node:2 slave 12288-16383 3.06MB OK", "section_id": "example" }, { "id": "node-enslave-endpoints_only-ex0", "language": " sh", "code": "rladmin node enslave endpoints_only\n [retry_timeout_seconds ]", "section_id": "node-enslave-endpoints_only" }, { "id": "example-1-ex0", "language": "sh", "code": "$ rladmin status endpoints\nENDPOINTS:\nDB:ID NAME ID NODE ROLE SSL \ndb:5 tr01 endpoint:5:1 node:1 single No \ndb:6 tr02 endpoint:6:1 node:3 all-master-shards No \n$ rladmin node 1 enslave endpoints_only\nPerforming enslave_node action on node:1: 100%\nOK\n$ rladmin status endpoints\nENDPOINTS:\nDB:ID NAME ID NODE ROLE SSL \ndb:5 tr01 endpoint:5:1 node:3 single No \ndb:6 tr02 endpoint:6:1 node:3 all-master-shards No", "section_id": "example-1" }, { "id": "node-enslave-shards_only-ex0", "language": " sh", "code": "rladmin node enslave shards_only\n [retry_timeout_seconds ]", "section_id": "node-enslave-shards_only" }, { "id": "example-2-ex0", "language": "sh", "code": "$ rladmin status shards node 3\nSHARDS:\nDB:ID NAME ID NODE ROLE SLOTS USED_MEMORY STATUS \ndb:5 tr01 redis:12 node:3 master 0-16383 3.04MB OK \ndb:6 tr02 redis:15 node:3 master 0-4095 4.13MB OK \ndb:6 tr02 redis:17 node:3 master 4096-8191 4.13MB OK \ndb:6 tr02 redis:19 node:3 master 8192-12287 4.13MB OK \ndb:6 tr02 redis:21 node:3 master 12288-16383 4.13MB OK \n$ rladmin node 3 enslave shards_only\nPerforming enslave_node action on node:3: 100%\nOK\n$ rladmin status shards node 3\nSHARDS:\nDB:ID NAME ID NODE ROLE SLOTS USED_MEMORY STATUS \ndb:5 tr01 redis:12 node:3 slave 0-16383 2.98MB OK \ndb:6 tr02 redis:15 node:3 slave 0-4095 4.23MB OK \ndb:6 tr02 redis:17 node:3 slave 4096-8191 4.11MB OK \ndb:6 tr02 redis:19 node:3 slave 8192-12287 4.19MB OK \ndb:6 tr02 redis:21 node:3 slave 12288-16383 4.27MB OK", "section_id": "example-2" } ] }