Upgrade OpenEBS using Kubera

Earlier, upgrading OpenEBS versions had to be carried out manually but now Kubera Director supports UI based upgrade, making the process of upgradation quick and easy.

STEP 1

Note down the namespace where openebs components are installed. The following document assumes the namespace to be openebs.

To know the current version of OpenEBS deployed on your cluster execute:

kubectl describe pods -n openebs | grep version

To verify that OpenEBS Control plane is in expected version, execute:

kubectl get pods -n openebs -l openebs.io/version=<current_version>

Example command, when version is 1.10.0:

kubectl get pods -n openebs -l openebs.io/version=1.10.0

NAME                                        READY STATUS  RESTARTS AGE
maya-apiserver-594699887-lg9c6              1/1   Running  0       39s
openebs-admission-server-544d8fb47b-8q5sm   1/1   Running  0       32s
openebs-localpv-provisioner-59f96b699-842zc 1/1   Running  0       31s
openebs-ndm-f7msw                           1/1   Running  0       34s
openebs-ndm-operator-58c94bf787-q95fw       1/1   Running  0       34s
openebs-ndm-pckrs                           1/1   Running  1       34s
openebs-ndm-vfnv4                           1/1   Running  0       35s
openebs-provisioner-5dfd95987b-g2cp7        1/1   Running  0       37s
openebs-snapshot-operator-5d58bd848b-2wlm7  2/2   Running  0       37s

Verify, apiserver is listed. If you have installed OpenEBS using helm charts, the apiserver might be named as openebs-apiserver.

STEP 2

Connect your K8s cluster.

You need to connect your K8s cluster to Director. Based on your setup refer the following
steps to connect to Kubera Director.
 

STEP 3

Upgrade control plane components

NOTE:

1. OpenEBS version should be >= 1.8.0
2. The components should have been installed using Kubera Director.

If any of the above is not true for your setup you need to manually upgrade the Control Plane components.

1. In the respective cluster, click on OpenEBS from the left sidebar. This brings you to a page that displays the list of Control Plane and NDM components. Ensure that all the components are in running state.
    
   
   
2. Next, click on .
   
   This opens up a pop-up window displaying the available version upgrades and also the changes from the current version. Click "Upgrade". 
   
   As soon as the upgrade begins the screen displays the components and their status of upgrade.
   
   

STEP 4

Upgrade Data Plane components

To upgrade desired OpenEBS volumes, it is recommended to upgrade the corresponding Pool(s) first.

Before starting OpenEBS Data Plane upgradation,  ensure all Control Plane components are in upgraded version and running. Click on OpenEBS on the left sidebar and verify. For example, if you want to upgrade OpenEBS to version 1.11.0, you need to ensure that all the Control Plane components have been upgraded to 1.11.0.

1. Upgrade cStor Pools:
   Upgrade of Pools can be done in two ways:
   
   1. Each Pool of a CSPC independently.
   2. CSPC directly.
   CSPC upgrade is recommended, as partial upgrades are not supported.

   Navigate to cStor Pool tab present on the top of the screen, select the Upgrade version from the dropdown menu and click the  icon

   NOTE: If there are multiple CSPCs and only a few have to be upgraded, choose the CSPCs directly rather than selecting pools as shown in the image. This surpasses the need to determine which pool is attached to which CSPC, hence making it more convenient.

   
   

    

   Once the upgrade starts, a pop-up appears having View live status button. Click on this button to monitor the upgrade.

    

   

   Live Status
   Once the cStor Pool is upgraded, you can verify the corresponding upgraded versions.
   
   
2. Upgrade Volumes:
   
   

   Before starting with OpenEBS volume upgrade, ensure that the corresponding cStor pools are upgraded.

   
   Select the upgrade version from the dropdown menu and click on  button.
   
   
   
   Once the upgrade starts, a pop-up appears having View live status button. Click on this button to monitor the upgrade.
   
   Live Status
   
   Once the cStor Volume(s) are upgraded, you can verify the corresponding upgraded versions. 
   

OpenEBS upgrade is Successful!!!!