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 or yugabundle. 

# mkdir /tmp/downloads

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

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

-  OR -

$ cd /tmp/downloads
$ wget https://downloads.yugabyte.com/yugabundle-2.2.5.0-b25.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

For the Yugabyte package:

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

For the Yugabundle extract the contents of the Yugabundle so that we have the

# tar xvf yugabundle-2.2.5.0-b25.tar.gz
# ls yugabyte-2.2.5.0-b25/
-rw-r--r-- 1 devops-2.2.5.0-b25-centos-x86_64.tar.gz
-rw-r--r-- 1 yugabyte-2.2.5.0-b25-centos-x86_64.tar.gz
-rw-r--r-- 1 yugaware-2.2.5.0-b25-centos-x86_64.tar.gz
# cd /opt/yugabyte/releases
# mkdir 2.2.5.0-b25

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

For the Yugabyte package, you will need to rename with the correct suffix: 

 # 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

For theYugabundle package, you can mv the package to the correct location, as the name includes the correct suffix:

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

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.