************************************ 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. .. 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. 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. 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. 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: .. code-block:: text $ wget "http://get.robin.io/download/storage?id=&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: .. code-block:: text $ 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: .. code-block:: text $ cd robin-upgrade 9. Run the following command to upgrade Robin CNS: .. code-block:: text $ ./install-robin.sh --version= --upgrade --cluster-name= --zone-name= **Example** .. code-block:: text $ ./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 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: .. code-block:: text $ wget "http://get.robin.io/download/storage?id=&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: .. code-block:: text $ 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: .. code-block:: text $ cd robin-upgrade 9. Run the following command to upgrade Robin CNS: .. code-block:: text $ ./install-robin.sh --version= --upgrade **Example** .. code-block:: text $ ./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 .. 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: .. .. code-block:: text .. $ wget "http://get.robin.io/download/storage?id=&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: .. .. code-block:: text .. $ 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: .. .. code-block:: text .. $ cd robin-upgrade .. 9. Run the following command to upgrade Robin CNS: .. .. code-block:: text .. $ ./install-robin.sh --version= --upgrade .. **Example** .. .. code-block:: text .. $ ./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 Manual Upgrade Steps ===================== If you have installed the Robin CNS using the ``skip_postgres_operator`` parameter to use the Zalando PostgreSQL operator, then you must first upgrade the Zalando PostgreSQL operator to v1.11.0 or later before upgrading the Robin CNS. Complete the following steps to upgrade to the latest Robin CNS version: 1. Untar the Robin CNS folder. 2. Run the ``cd`` command to access the folder where you untarred the Robin CNS binaries. 3. Generate the Robin Operator and Robin CR YAML files: .. code-block:: text # ./install-robin.sh -g --image-registry-path="gcr.io/robinio-public/robin-storage" 4. Apply the ``robin-operator.tmp`` YAML file generated in step 3: .. code-block:: text # kubectl apply -f ./robin-operator.yaml.tmp .. Note:: Wait for the ``robin-operator`` Pod to come up. 5. Check if the ``robin-operator`` Pod is up with the new Robin CNS version: .. code-block:: text # kubectl rollout status -n robinio deploy/robin-operator 6. Apply the ``robin.yaml.tmp`` file generated in step 3: .. code-block:: text # kubectl apply -f ./robin.yaml.tmp After running the above command, Pods in the ``robinio`` namespace will be redeployed with the new version of Robin CNS. Upgrade Verification ^^^^^^^^^^^^^^^^^^^^^ Perform the following steps to verify that the upgrade is successfully completed: 1. Run the following command to make sure that all the images are properly upgraded to the latest image: .. code-block:: text # kubectl get pods -n robinio -o=custom-columns=PODNAME:.metadata.name,IMAGE:.spec.containers[*].image 2. Run the following command to check the progress of the upgrade: .. code-block:: text # kubectl rollout status -n robinio ds/robin-worker 3. Log in to the Robin Master Pod and run the following command to verify that all the hosts are displaying the Robin CNS v5.4.10-59 version and are in the ``Ready`` status: .. code-block:: text # robin host list **Example** .. code-block:: text # robin host list Id | Hostname | Version | Status | RPool | Avail. Zone | LastOpr | Roles | Isol Shared Cores | Isol Dedicated Cores | Non-Isol Cores | GPUs | Mem | HDD(#/Alloc/Total) | SSD(#/Alloc/Total) | Pod Usage | Joined Time -------------+--------------+-----------+--------+---------+-------------+---------+-------+-------------------+----------------------+----------------+-------+------------+--------------------+--------------------+-----------+---------------------- 1726835504:1 | vnode-87-203 | 5.4.10-59 | Ready | default | N/A | ONLINE | S | 0/0/0 | 0/0/0 | 76/4/80 | 0/0/0 | 11G/4G/15G | 2/180G/399G | -/-/- | 83/27/110 | 19 Sep 2024 22:33:09 1726835504:2 | vnode-87-198 | 5.4.10-59 | Ready | default | N/A | ONLINE | S | 0/0/0 | 0/0/0 | 77/3/80 | 0/0/0 | 7G/7G/15G | 2/180G/399G | -/-/- | 71/39/110 | 19 Sep 2024 22:33:10 1726835504:3 | vnode-87-202 | 5.4.10-59 | Ready | default | N/A | ONLINE | S | 0/0/0 | 0/0/0 | 77/3/80 | 0/0/0 | 5G/10G/15G | 2/180G/399G | -/-/- | 83/27/110 | 19 Sep 2024 22:33:11 1726835504:4 | vnode-87-204 | 5.4.10-59 | Ready | default | N/A | ONLINE | S | 0/0/0 | 0/0/0 | 74/6/80 | 0/0/0 | 10G/4G/15G | 2/200G/399G | -/-/- | 80/30/110 | 19 Sep 2024 22:33:11 1726835504:5 | vnode-87-192 | 5.4.10-59 | Ready | default | N/A | ONLINE | S | 0/0/0 | 0/0/0 | 76/4/80 | 0/0/0 | 7G/7G/15G | 2/160G/399G | -/-/- | 70/40/110 | 19 Sep 2024 22:33:13 * Note: all values indicated above in the format XX/XX/XX represent the Free/Allocated/Total values of the respective resource unless otherwise specified. In addition allocated values for compute resource such as cpu, memory and pod usage includes reserved values for the corresponding resource. .. Note:: After upgrading to Robin CNS v5.4.10-59, if you are using the Robin Client outside the ``robincli`` Pod, you must upgrade to the latest version of the Robin Client.