{
  "id": "failover",
  "title": "rladmin failover",
  "url": "https://redis.io/docs/latest/operate/rs/7.8/references/cli-utilities/rladmin/failover/",
  "summary": "Fail over primary shards of a database to their replicas.",
  "content": "\nFails over one or more primary (also known as master) shards of a database and promotes their respective replicas to primary shards.\n\n``` sh\nrladmin failover\n        [db { db:\u003cid\u003e | \u003cname\u003e }]\n        shard \u003cid1 ... idN\u003e\n        [immediate]\n```\n\n### Parameters\n\n| Parameter | Type/Value                     | Description                                                                                   |\n|-----------|--------------------------------|-----------------------------------------------------------------------------------------------|\n| db        | db:\\\u003cid\\\u003e\u003cbr /\u003e name           | Fail over shards for the specified database                                                   |\n| shard     | one or more primary shard IDs  | Primary shard or shards to fail over                                                          |\n| immediate |                                | Perform failover without verifying the replica shards are in full sync with the master shards |\n\n### Returns\n\nReturns `Finished successfully` if the failover completed. Otherwise, it returns an error.\n\nUse [`rladmin status shards`]() to verify that the failover completed.\n\n### Example\n\n``` sh\n$ rladmin status shards\nSHARDS:\nDB:ID  NAME        ID         NODE     ROLE     SLOTS     USED_MEMORY    STATUS\ndb:5   tr01        redis:12   node:1   slave    0-16383   3.02MB         OK     \ndb:5   tr01        redis:13   node:2   master   0-16383   3.09MB         OK     \n$ rladmin failover shard 13\nExecuting shard fail-over: OOO.\nFinished successfully\n$ rladmin status shards\nSHARDS:\nDB:ID  NAME        ID         NODE     ROLE     SLOTS     USED_MEMORY    STATUS\ndb:5   tr01        redis:12   node:1   master   0-16383   3.12MB         OK     \ndb:5   tr01        redis:13   node:2   slave    0-16383   2.99MB         OK\n```\n",
  "tags": ["docs","operate","rs"],
  "last_updated": "2026-04-01T08:10:08-05:00"
}