Project: YugabyteDB (App Definition and Development / Database)
File: upgrade-yp-replicated.md

title: Upgrade YugabyteDB Anywhere using Replicated headerTitle: Upgrade YugabyteDB Anywhere linkTitle: Upgrade installation description: Use Replicated to upgrade YugabyteDB Anywhere menu: v2.18_yugabyte-platform: identifier: upgrade-yp-2-replicated parent: upgrade weight: 80 type: docs <ul class="nav nav-tabs-alt nav-tabs-yb"> <li> <a href="../upgrade-yp-installer/" class="nav-link"> <i class="fa-solid fa-building"></i>YBA Installer</a> </li> <li> <a href="../upgrade-yp-replicated/" class="nav-link active"> <i class="fa-solid fa-cloud"></i>Replicated</a> </li> <li> <a href="../upgrade-yp-kubernetes/" class="nav-link"> <i class="fa-regular fa-dharmachakra" aria-hidden="true"></i>Kubernetes</a> </li> </ul> {{< note title="Replicated end of life" >}} YugabyteDB Anywhere will end support for Replicated installation at the end of 2024. You can migrate existing Replicated YugabyteDB Anywhere installations using YBA Installer. To perform the migration, you must first upgrade your installation to v2.20.1.3 or later using Replicated. {{< /note >}} If your installation was installed via , use Replicated to upgrade your YugabyteDB Anywhere to a newer version. If you are upgrading a YugabyteDB Anywhere installation with high availability enabled, follow the instructions provided in . To start the upgrade, log in to the Replicated Admin Console via <https://:8800> and then perform the following: Navigate to Dashboard and click View release history to open Release History, as shown in the following illustration: Find the required release version; if the required version is not in the list, click Check for updates to refresh the list of releases available in the channel to which you are subscribed. Click the corresponding Install. If the required release version is in a different channel (for example, you want to upgrade from 2.4.n release family to 2.6.n), start by updating the channel, as follows: Click the gear icon and select View License, as per the following illustration: In the License view, click change for Release Channel, as per the following illustration: Note that if you do not have permissions to access the new release channel, you should contact {{% support-platform %}}. Click Sync License. Navigate back to Release History, locate the release you need, and then click the corresponding Install. If you are performing an upgrade to YugabyteDB Anywhere version 2.14 or later, the process can take some time depending on the amount of data present in YugabyteDB Anywhere. If you have upgraded YugabyteDB Anywhere to version 2.12 or later and for your universe was set up via `yb-admin` instead of the UI, follow the instructions provided in . You can upgrade your airgapped installation of YugabyteDB Anywhere to a newer version as follows: Manually obtain and move the binary Replicated license file `<filename>.rli` to the `/home/{username}/` directory. Manually obtain and move the YugabyteDB Anywhere airgapped package to the `/opt/yugabyte/releases/<newversiondir>` directory. For example, if you are upgrading to the latest YugabyteDB Anywhere stable version, you would start by executing the following command to obtain the package: ```sh wget https://downloads.yugabyte.com/releases/{{<yb-version version="v2.18">}}/yugaware-{{<yb-version version="v2.18" format="build">}}-linux-x86_64.airgap ``` Then you would create the `/opt/yugabyte/releases/yugaware-{{<yb-version version="v2.18" format="build">}}/` directory and move (or SCP) the `yugaware-{{<yb-version version="v2.18" format="build">}}-linux-x86_64.airgap` file into that directory. Log in to the Replicated Admin Console at <https://:8800/> and navigate to Settings to load the new license file, as per the following illustration: Change the two directories to match the ones you used. For example, enter `/opt/yugabyte/releases/yugaware-{{<yb-version version="v2.18" format="build">}}/` in the Update Path field and `/home/{user}/` in the License File field. Replicated detects updates based on the updated path information and applies them in the same way it does for connected YugabyteDB Anywhere installations. Proceed with the YugabyteDB Anywhere upgrade process by following instructions provided in . Upgrade your YugabyteDB universe by following instructions provided in .