Environment

• Yugabyte Platform - 2.2 or higher

Issue

Yugabyte Support has provided you a patched version of the Yugabyte database that you need to deploy. 

• IMPORTANT: This is not an attempt to upgrade the platform. Only the database software will be upgraded using this process - Yugabyte Platform will be unmodified.

Resolution

Overview

This procedure will guide you through uploading the new database version to your Yugabyte Platform so that it is available to the Platform to be applied to your universes, new or existing.

Steps

The following steps must be run with sudo if you are not logged in as the root user.

1. Create a directory, on the Yugabyte Platform host, where you can safely download the patch 

# mkdir /tmp/downloads

2. With the URL provided to you from Yugabyte Support, download the patch into the newly created directory.

$ cd /tmp/downloads
$ wget https://downloads.yugabyte.com/yugabyte-2.2.5.0-linux.tar.gz

3. Once the file is available on the Yugabyte Platform host, a directory for the patched software will need to be created.

NOTE: It is important that it conforms to the following naming convention:

/opt/yugabyte/releases/{$version-$build}/yugabyte-{$version-$build}-centos-x86_64.tar.gz

# cd /opt/yugabyte/releases
# mkdir 2.2.5.0-b1

4. Copy, or move the downloaded patch into the {$version-$build} directory

 # mv /tmp/downloads/yugabyte-2.2.5.0-linux.tar.gz ./2.2.5.0-b1/yugabyte-2.2.5.0-b1-centos-x86_64.tar.gz

5. With the patch in the correct location, log into the Yugabyte Admin Console (Yugaware) and navigate to the releases page.

NOTE: This will be located in the top right corner, under the drop down options under your user icon 

6. Once on the releases page, select the refresh button in the top right of the screen and Yugabyte Platform will automatically detect the patch. 

At this point you should now see your release listed in the UI. 

7. Now, you can upgrade the universe software version by going to the appropriate universe, then selecting More -> Upgrade Software

You can select the appropriate server version in the dropdown.