v2.25 Preview Preview release - not for production v2024.2 LTS Stable release with long-term support v2024.1 STS Stable release with standard-term support v2.20 LTS Stable release with long-term support Unsupported versions

Prepare to upgrade YugabyteDB Anywhere

For information on which versions of YugabyteDB are compatible with your version of YugabyteDB Anywhere, see YugabyteDB Anywhere releases.

High availability

If you are upgrading a YugabyteDB Anywhere installation with high availability enabled, follow the instructions provided in Upgrade instances.

Operating system

If you are running YugabyteDB Anywhere on a deprecated OS, you need to update your OS before you can upgrade YugabyteDB Anywhere to the next major release.

Python

YugabyteDB Anywhere v25.1 and later requires Python v3.10-3.12. If you are running YugabyteDB Anywhere on a system with Python earlier than 3.10, you will need to update Python on your system before you can upgrade YugabyteDB Anywhere to v25.1 or later.

cron-based universes

cron and root-level systemd have been deprecated in favor of user-level systemd with node agent for management of universe nodes.

In particular, cron-based universes will no longer be supported in YugabyteDB Anywhere v2025.2 (LTS release planned for end of 2025) and later. Before you will be able to upgrade to v2025.2 or later, all your universes must be using systemd. YugabyteDB Anywhere will automatically upgrade universes that use a cloud provider configuration to systemd.

However, on-premises cron-based universes must be upgraded manually. To do this, in YugabyteDB Anywhere v2024.2.2 or later, navigate to the universe and choose Actions>Upgrade to Systemd.

Node provisioning

Legacy provisioning workflows have been deprecated. Provision nodes for on-premises universes using the node-agent-provision.sh script. Refer to Automatically provision on-premises nodes.

YugabyteDB Anywhere v2025.2 (LTS release planned for end of 2025) and later require universes have node agent running on their nodes. Before you will be able to upgrade to v2025.2 or later, all your universes must be using node agent.

To upgrade a universe to node agent, first make sure the universe is not cron-based and if necessary update the universe to systemd. Then navigate to the universe and click Actions>Install Node Agent. If installation fails on a node, make sure the node satisfies the prerequisites and re-try the install.

xCluster

If you have upgraded YugabyteDB Anywhere to version 2.12 or later and xCluster replication for your universe was set up via yb-admin instead of the UI, follow the instructions provided in Synchronize replication after upgrade.