{
  "id": "placement",
  "title": "rladmin placement",
  "url": "https://redis.io/docs/latest/operate/rs/7.8/references/cli-utilities/rladmin/placement/",
  "summary": "Configures the shard placement policy for a database.",
  "content": "\nConfigures the shard placement policy for a specified database.\n\n``` sh\nrladmin placement\n        db { db:\u003cid\u003e | \u003cname\u003e }\n        { dense | sparse }\n```\n\n\n`rladmin placement db` is deprecated and will be removed in a future version. Use [`rladmin tune db`]() with the `shards_placement` parameter instead.\n\n\n### Parameters\n\n| Parameter | Type/Value                     | Description                                                                                   |\n|-----------|--------------------------------|-----------------------------------------------------------------------------------------------|\n| db        | db:\\\u003cid\\\u003e\u003cbr /\u003e name           | Configures shard placement for the specified database                                         |\n| dense     |                                | Places new shards on the same node as long as it has resources                                |\n| sparse    |                                | Places new shards on the maximum number of available nodes within the cluster                 |\n\n### Returns\n\nReturns the new shard placement policy if the policy was changed successfully. Otherwise, it returns an error.\n\nUse [`rladmin status databases`]() to verify that the failover completed.\n\n### Example\n\n``` sh\n$ rladmin status databases\nDATABASES:\nDB:ID  NAME       TYPE   STATUS   SHARDS   PLACEMENT    REPLICATION    PERSISTENCE    ENDPOINT                                \ndb:5   tr01       redis  active   1        dense        enabled        aof            redis-12000.cluster.local:12000         \n$ rladmin placement db db:5 sparse\nShards placement policy is now sparse\n$ rladmin status databases\nDATABASES:\nDB:ID  NAME       TYPE   STATUS   SHARDS   PLACEMENT    REPLICATION    PERSISTENCE    ENDPOINT                                \ndb:5   tr01       redis  active   1        sparse       enabled        aof            redis-12000.cluster.local:12000         \n```\n",
  "tags": ["docs","operate","rs"],
  "last_updated": "2026-04-01T08:10:08-05:00"
}