{ "id": "enslave", "title": "rladmin node enslave", "url": "https://redis.io/docs/latest/operate/rs/7.8/references/cli-utilities/rladmin/node/enslave/", "summary": "Changes a node's resources to replicas.", "content": "\nChanges the resources of a node to replicas.\n\n## `node enslave`\n\nChanges all of the node's endpoints and shards to replicas.\n\n``` sh\nrladmin node \u003cID\u003e enslave\n [demote_node]\n [retry_timeout_seconds \u003cseconds\u003e]\n```\n\n### Parameters\n\n| 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. |\n\n### Returns\n\nReturns `OK` if the roles were successfully changed. Otherwise, it returns an error.\n\nUse [`rladmin status shards`]() to verify that the roles were changed.\n\n### Example\n\n```sh\n$ 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\n```\n\n## `node enslave endpoints_only`\n\nChanges the role for all endpoints on a node to replica.\n\n``` sh\nrladmin node \u003cID\u003e enslave endpoints_only\n [retry_timeout_seconds \u003cseconds\u003e]\n```\n\n### Parameters\n\n| 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. |\n\n### Returns\n\nReturns `OK` if the roles were successfully changed. Otherwise, it returns an error.\n\nUse [`rladmin status endpoints`]() to verify that the roles were changed.\n\n### Example\n\n```sh\n$ 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 \n```\n\n## `node enslave shards_only`\n\nChanges the role for all shards of a node to replica.\n\n``` sh\nrladmin node \u003cID\u003e enslave shards_only\n [retry_timeout_seconds \u003cseconds\u003e]\n```\n\n### Parameters\n\n| 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. |\n\n### Returns\n\nReturns `OK` if the roles were successfully changed. Otherwise, it returns an error.\n\nUse [`rladmin status shards`]() to verify that the roles were changed.\n\n### Example\n\n```sh\n$ 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\n```\n", "tags": ["docs","operate","rs"], "last_updated": "2026-04-01T08:10:08-05:00" }