20. Upgrading Robin Cloud Native Storage

You can upgrade your Robin Cloud Native Storage (CNS) cluster from your current version to a later CNS version. After you upgrade your cluster, you can use the latest Robin CNS features.

This section describes the steps to upgrade the Robin CNS cluster.

Note

If you are upgrading Kubernetes on your cluster nodes, you must upgrade it sequentially, one node after the other.

20.1. Robin Upgrade Path Matrix

The following is the upgrade path for Robin CNS.

  • Robin v5.3.8-595 to Robin v5.3.14-72

Note

This is a reference document only for performing upgrades to the next higher version.

20.2. Pre Robin Upgrade Checklist

  • All nodes within the Kubernetes cluster must be in the healthy state.

  • Make sure that no control plane operations, including those associated with applications and volumes, are performed by any user(s) until the entire upgrade process is completed.

20.3. Upgrade using Robin installer

You can upgrade your Robin CNS cluster using the Robin installer. You must run the Robin installer command on the node from which you can access the CNS cluster using the kubectl command.

20.3.1. Upgrade on Google GKE

You can upgrade your Robin CNS cluster installed on Google GKE.

Complete the following steps to upgrade the Robin CNS cluster on Google GKE:

Note

If you have already downloaded the Robin installation tar file, proceed to step 7.

  1. Access the get.robin.io website.

  2. In the DOWNLOAD FOR FREE box, enter your business email address and click Sign in to Download.

  3. Check the email ID you provided for the passwordless login link and click the link.

  4. After logging in to the get.robin.io website, hover over to the Deploy on Google GKE/Anthos box and click Download and Install.

  5. In the Deploy on Google GKE/Anthos window, copy either the wget or curl command.

  6. Access your Robin CNS cluster and run the copied command on the node from which you can access your cluster using the kubectl command to download the installation tar file:

    $ wget "http://get.robin.io/download/storage?id=<USERID>&type=gke" -O robin-install.tar

  7. After downloading the installation tar file, run the following command to untar the contents into a new directory:

    $ mkdir -p ./robin-upgrade && tar -xf robin-install.tar -C ./robin-upgrade

  8. Run the following command to make the newly created directory your current working directory:

    $ cd <directory name>

  9. Run the following command to upgrade Robin CNS:

    $ ./install-robin.sh --version=<version number> --upgrade --cluster-name=<cluster_name> --zone-name=<zone_name>

    Example

    $ ./install-robin.sh --version=5.3.14-72 --upgrade --cluster-name=nightly-cluster --zone-name=us-central1
Validating Kubernetes cluster......Done
Validating kubernetes cluster permissions......Done
Validating robin cluster yaml......Done
Installing Robin operator...........Done
Upgrading Robin Operator to version 5.3.14-72 ......Done

Upgrading Robin CR from version 5.3.8-595 to 5.3.14-72 .........Done
Upgrading Robin cluster......Done

20.3.2. Upgrade on Google Anthos

You can upgrade your Robin CNS cluster installed on Google Anthos.

Complete the following steps to upgrade the Robin CNS cluster on Google Anthos:

Note

If you have already downloaded the Robin installation tar file, proceed to step 7.

  1. Access the get.robin.io website.

  2. In the DOWNLOAD FOR FREE box, enter your business email address and click Sign in to Download.

  3. Check the email ID you provided for the passwordless login link and click the link.

  4. After logging in to the get.robin.io website, hover over to the Deploy on Google GKE/Anthos box and click Download and Install.

  5. In the Deploy on Google GKE/Anthos window, copy either the wget or curl command.

  6. Access your Robin CNS cluster and run the copied command on the node from which you can access your cluster using the kubectl command to download the installation tar file:

    $ wget "http://get.robin.io/download/storage?id=<USERID>&type=gke" -O robin-install.tar

  7. After downloading the installation tar file, run the following command to untar the contents into a new directory:

    $ mkdir -p ./robin-upgrade && tar -xf robin-install.tar -C ./robin-upgrade

  8. Run the following command to make the newly created directory your current working directory:

    $ cd <directory name>

  9. Run the following command to upgrade Robin CNS:

    $ ./install-robin.sh --version=<version number> --upgrade

    Example

    $ ./install-robin.sh --version=5.3.14-72 --upgrade
Validating Kubernetes cluster......Done
Validating kubernetes cluster permissions......Done
Validating robin cluster yaml......Done
Installing Robin operator...........Done
Upgrading Robin Operator to version 5.3.14-72 ......Done

Upgrading Robin CR from version 5.3.8-595 to 5.3.14-72 .........Done
Upgrading Robin cluster......Done

20.3.3. Upgrade on IKS

You can upgrade your Robin CNS cluster installed on IBM IKS.

Complete the following steps to upgrade the Robin CNS cluster on IBM IKS:

Note

If you have already downloaded the Robin installation tar file, proceed to step 7.

  1. Access the get.robin.io website.

  2. In the DOWNLOAD FOR FREE box, enter your business email address and click Sign in to Download.

  3. Check the email ID you provided for the passwordless login link and click the link.

  4. After logging in to the get.robin.io website, hover over to the Deploy on IBM IKS box and click Download and Install.

  5. In the Deploy on IBM IKS window, copy either the wget or curl command.

  6. Access your Robin CNS cluster and run the copied command on the node from which you can access your cluster using the kubectl command to download the installation tar file:

    $ wget "http://get.robin.io/download/storage?id=<USERID>&type=iks" -O robin-install.tar

  7. After downloading the installation tar file, run the following command to untar the contents into a new directory:

    $ mkdir -p ./robin-upgrade && tar -xf robin-install.tar -C ./robin-upgrade

  8. Run the following command to make the newly created directory your current working directory:

    $ cd <directory name>

  9. Run the following command to upgrade Robin CNS:

    $ ./install-robin.sh --version=<version number> --upgrade

    Example

    $ ./install-robin.sh --version=5.3.14-72 --upgrade
Validating Kubernetes cluster......Done
Enter IBM api key:
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Validating kubernetes cluster permissions......Done
Validating robin cluster yaml......Done
Installing Robin operator...........Done
Upgrading Robin Operator to version 5.3.14-72 ......Done

Upgrading Robin CR from version 5.3.8-595 to 5.3.14-72 .........Done
Upgrading Robin cluster......Done