Replicated End of Life

30 Apr 2024
Product Affected Versions Fixed In
YB Anywhere all v2.18, v2.20+

Critical Considerations

Obtain a YugabyteDB Anywhere (YBA) Installer license before attempting any migration. Contact Yugabyte Support to request a license.

Description

YugabyteDB Anywhere will end support for Replicated installation at the end of 2024. This means updates will no longer be available, preventing YBA and YugabyteDB database upgrades, in perpetuity.

Mitigation

Migrate your YBA installation from Replicated by performing the following steps:

  1. Upgrade YBA instances to the latest v2.18 or v2.20 using Replicated.
  2. Migrate from the Replicated-based install of YBA to a YBA Installer-based install of YBA using the Migration Steps.

Details

To guarantee interoperability, upgrading to a YBA version greater than or equal to latest v2.18 may require additional actions, such as first upgrading the database cluster(s) version (also known as universes), or performing an upgrade to Docker.

For more details, refer to YBA version compatibility with YugabyteDB.

Important

Do not upgrade your YBA to a version that no longer supports your currently running YugabyteDB database versions.

If there are no version compatibility issues, YBA upgrades should be performed before any additional upgrades to the database.

When performing step 1 of the mitigation, review the prerequisites for Replicated-based installs to avoid any potential upgrade issues.

Yugabyte recommends upgrading YBA and YugabyteDB database to the latest v2.20 LTS.

Acceptable upgrade path (Satisfactory)

Important YugabyteDB release considerations

  • v2.14 database releases reach End of Maintenance in July 2024, End of Life in January 2025.
  • v2.16 database releases reach End of Life in June 2024.
  • v2.18 database releases reach End of Life in November 2024.

For more details, refer to Releases.

Scenario 1

Suppose you are running a YBA earlier than the latest v2.18, with universes running YuagbyteDB database earlier than the latest v2.14.

If you want to upgrade YBA to the latest v2.18 or v2.20, and only upgrade database nodes to v2.14, do the following:

  1. Check Replicated prerequisites.
  2. Upgrade YBA to the latest version of your current branch (using Replicated).
  3. Upgrade YBA to the latest v2.18 (using Replicated).
  4. Upgrade YugabyteDB database nodes to latest v2.14.
  5. Migrate YBA off Replicated, to YBA Installer.
  6. Plan the upgrade of database nodes prior to EOL in January 2025.

Scenario 2

Suppose you are running a YBA earlier than the latest v2.18, with universes running YugabyteDB at v2.14, v2.16, or v2.18.

If you want to upgrade YBA to the latest v2.18 or 2.20, and leave your database on its current version, do the following:

  1. Check Replicated prerequisites.
  2. Upgrade YBA to the latest version of your current branch (using Replicated).
  3. Upgrade YBA to the latest v2.18 or v2.20 (using Replicated).
  4. Migrate YBA off Replicated, to YBA Installer.
  5. Plan the upgrade of database nodes prior to EOL for the respective versions. For more details, refer to Releases.

Minimum requirements (Sub-optimal)

Important YugabyteDB release considerations

  • v2.14 database releases reach End of Maintenance in July 2024, End of Life in January 2025.
  • v2.16 database releases reach End of Life in June 2024.
  • v2.18 database releases reach End of Life in November 2024. For more details, refer to Releases.

Scenario

Suppose you are running YBA v2.14, with universes running YugabyteDB nodes on v2.12.

To upgrade YBA to the latest v2.18 or v2.20, and only upgrade your database to the latest v2.14, do the following:

  1. Check Replicated prerequisites.
  2. Upgrade YBA to the latest v2.14 (using Replicated).
  3. Upgrade YugabyteDB database to the latest v2.14.
  4. Upgrade YBA to the latest v2.18 or v2.20 (using Replicated).
  5. Migrate YBA off Replicated, to YBA Installer.