{
  "schema_version": 2,
  "id": "operate/rs/databases/configure/db-upgrade",
  "title": "Change database upgrade configuration",
  "url": "https://redis.io/docs/latest/operate/rs/databases/configure/db-upgrade/",
  "summary": "Configure cluster-wide policies that affect default database upgrades.",
  "tags": [
    "docs",
    "operate",
    "rs"
  ],
  "last_updated": "2026-10-02T16:06:07+01:00",
  "page_type": "content",
  "content_hash": "f5d2aacc252ae802652c50992a1cbf80b34a75d3dee437b860b73985deb5721d",
  "sections": [
    {
      "id": "overview",
      "title": "Overview",
      "role": "overview",
      "text": "Database upgrade configuration includes cluster-wide policies that affect default database upgrades."
    },
    {
      "id": "edit-upgrade-configuration",
      "title": "Edit upgrade configuration",
      "role": "content",
      "text": "To edit database upgrade configuration using the Cluster Manager UI:\n\n1. On the **Databases** screen, select ![Toggle actions button](https://redis.io/docs/latest/images/rs/buttons/button-toggle-actions-vertical.png#no-click) to open a list of additional actions.\n\n1. Select **Upgrade configuration**.\n\n1. Change database [upgrade configuration settings](#upgrade-config-settings).\n\n1. Select **Save**."
    },
    {
      "id": "upgrade-config-settings",
      "title": "Upgrade configuration settings",
      "role": "content",
      "text": ""
    },
    {
      "id": "database-shard-parallel-upgrade",
      "title": "Database shard parallel upgrade",
      "role": "content",
      "text": "To change the number of shards upgraded in parallel during database upgrades, use one of the following methods:\n\n- Cluster Manager UI – Edit **Database shard parallel upgrade** in [**Upgrade configuration**](#edit-upgrade-configuration)\n\n- [rladmin tune cluster](https://redis.io/docs/latest/operate/rs/references/cli-utilities/rladmin/tune#tune-cluster): \n    \n    [code example]\n\n- [Update cluster policy](https://redis.io/docs/latest/operate/rs/references/rest-api/requests/cluster/policy#put-cluster-policy) REST API request:\n\n    [code example]"
    },
    {
      "id": "resp3-support",
      "title": "RESP3 support",
      "role": "content",
      "text": "The cluster-wide option `resp3_default` determines the default value of the `resp3` option, which enables or deactivates RESP3 for a database, upon upgrading a database to version 7.2 or later. `resp3_default` is set to `enabled` by default.\n\nTo change `resp3_default` to `disabled`, use one of the following methods:\n\n- Cluster Manager UI – Edit **RESP3 support** in [**Upgrade configuration**](#edit-upgrade-configuration)\n\n- [rladmin tune cluster](https://redis.io/docs/latest/operate/rs/references/cli-utilities/rladmin/tune#tune-cluster): \n    \n    [code example]\n\n- [Update cluster policy](https://redis.io/docs/latest/operate/rs/references/rest-api/requests/cluster/policy#put-cluster-policy) REST API request:\n\n    [code example]"
    }
  ],
  "examples": [
    {
      "id": "database-shard-parallel-upgrade-ex0",
      "language": "sh",
      "code": "rladmin tune cluster parallel_shards_upgrade { all | <integer> }",
      "section_id": "database-shard-parallel-upgrade"
    },
    {
      "id": "database-shard-parallel-upgrade-ex1",
      "language": "sh",
      "code": "PUT /v1/cluster/policy \n    { \"parallel_shards_upgrade\": <integer> }",
      "section_id": "database-shard-parallel-upgrade"
    },
    {
      "id": "resp3-support-ex0",
      "language": "sh",
      "code": "rladmin tune cluster resp3_default { enabled | disabled }",
      "section_id": "resp3-support"
    },
    {
      "id": "resp3-support-ex1",
      "language": "sh",
      "code": "PUT /v1/cluster/policy \n    { \"resp3_default\": <boolean> }",
      "section_id": "resp3-support"
    }
  ]
}