Back to Yugabyte Db

Upgrade universes with a new version of YugabyteDB

docs/content/v2024.1/yugabyte-platform/manage-deployments/upgrade-software.md

2026.1.0.0-b292.6 KB
Original Source

The YugabyteDB release that is powering a universe can be upgraded to get new features and fixes included in the release.

{{< note title="Upgrading YugabyteDB on deprecated operating systems" >}}

If your universe is running on a deprecated OS, you will need to update your OS before you can upgrade to the next major YugabyteDB release. Refer to Patch and upgrade the Linux operating system.

{{< /note >}}

{{< note title="Upgrading universes in xCluster deployments" >}} When upgrading universes in xCluster Replication or xCluster Disaster Recovery:

  • Use the same version of YugabyteDB on both the source/DR primary and target/DR replica.
  • Upgrade and finalize the target/DR replica before upgrading and finalizing the source/DR primary. {{< /note >}}

When performing a database upgrade, do the following:

  1. Upgrade YugabyteDB Anywhere. You cannot upgrade a universe to a version of YugabyteDB that is later than the version of YugabyteDB Anywhere.

    For information on which versions of YugabyteDB are compatible with your version of YugabyteDB Anywhere, refer to Compatibility with YugabyteDB.

  2. Prepare to upgrade a universe. Depending on the upgrade you are planning, you may need to make changes to your automation or upgrade your Linux operating system.

  3. View and import releases. Before you can upgrade your universe to a specific version of YugabyteDB, verify that the release is available in YugabyteDB Anywhere and, if necessary, import the release.

  4. Upgrade the universe. Perform a rolling upgrade on a live universe deployment.

{{<index/block>}}

{{<index/item title="Prepare to upgrade" body="Review changes that may affect your automation." href="../upgrade-software-prepare/" icon="/images/section_icons/quick_start/install.png">}}

{{<index/item title="Manage releases" body="View and import the latest releases of YugabyteDB." href="../ybdb-releases/" icon="/images/section_icons/quick_start/install.png">}}

{{<index/item title="Upgrade a universe" body="Perform a rolling upgrade on a live universe deployment." href="../upgrade-software-install/" icon="/images/section_icons/quick_start/install.png">}}

{{</index/block>}}