Dell ObjectScale 1.3 Administration Guide

Upgrade ObjectScale on Software Bundle

This section provides the steps to upgrade ObjectScale from version 1.3.0 to 1.3.x in Software Bundle deployment.

Prerequisites

Any Linux system that has connectivity to the target cluster can be used for the upgrade. This can be one of the running nodes or an external system on the same network. It is recommended to use an external system to upgrade the cluster.

The system should have 100 GB free space for package download and extraction on the partition where the bundle is to be downloaded. This space is in addition to the space required for the ObjectScale System.

If you are downloading the package on one of the Kubernetes nodes,

Ensure it is not downloaded on the root partition. Preferably, use /tmp partition for the download.
Ensure you have the kubeconfig to access the cluster.
Obtain the current running version of the cluster using kubectl version.
Ensure all the cluster nodes are on SLES 15 SP4.
Ensure that all nodes are in Ready status using kubectl get nodes.

The system should have these software versions installed:

Kubectl 1.26 or above.
Helm 3.38 or above
Curl

Steps

Download the software-bundle upgrade package from the Dell Support Site and copy the package to one of the cluster nodes or one of the external service nodes which has access to the Kubernetes cluster.
To determine the upgrade path, you can check Release Notes of the latest patch release to understand the compatible target upgrade versions of ObjectScale and/or RKE2.
NOTE:If the upgrade bundle is downloaded to the control-plane node, which also hosts the http-share pod, there could be space constraints that may lead to an upgrade failure. This is because there is no free space available in the /var partition for extracting the bundle. It is recommended to download the target upgrade bundle on a node other than the one where the http-share pod is hosted. To identify the node that hosts the http-share pod, use the following command:
```
kubectl get pods -A -owide | grep -i http
```
```
cmo http-share-0 2/2 Running 0 19h 192.168.35.207 dhcp-10-236-65-131.cluster.local <none> <none>
```
In the above example, http-share is hosted on 10.236.65.131.
```
cmo http-share-0 2/2 Running 0 19h 192.168.35.207 dhcp-10-236-65-131.cluster.local <none> <none>
```
Extract the package.
```
tar -xvf objectscale-<version>-software-bundle.tar
```
The artifacts folder will have the required manifest files for the next step.

Upload the required lcm_manifest.json, objectscale-lcm-manifest.json, and platform.tgz to the http-share service.

NOTE:

The upload location is fixed and must have the following path: https://$INGRESS_IP/httpshare/upload/bundle/objectscale/upgrade/<DIR>/, where <DIR> is usually the ObjectScale target upgrade version.
Before uploading, ensure that the http-share location is clear by deleting any existing files.
If you are retrying upgrade after a failed upgrade, ensure that the necessary files are present in the http-share location.

# Target upgrade version
VERSION=1.3.0

# Get http-share ingress IP address
INGRESS_IP=$(kubectl get svc rke2-ingress-nginx-controller -n kube-system --output jsonpath='{.status.loadBalancer.ingress[0].ip}')
 
# Clean/remove the http-share location
curl -i -k -X DELETE https://$INGRESS_IP/httpshare/upload/bundle/objectscale/upgrade
 
# Upload the required artifacts
cd objectscale-$VERSION-software-bundle/artifacts
curl -i -k --create-dirs https://$INGRESS_IP/httpshare/upload/bundle/objectscale/upgrade/VERSION=1.3.0/ -F "file=@platform.tgz"
curl -i -k https://$INGRESS_IP/httpshare/upload/bundle/objectscale/upgrade/VERSION=1.3.0/ -F "file=@lcm_manifest.json"
curl -i -k https://$INGRESS_IP/httpshare/upload/bundle/objectscale/upgrade/VERSION=1.3.0 -F "file=@objectscale-lcm-manifest.json"

Log in to the ObjectScale Portal user interface using the admin account.
From the ObjectScale Portal user interface, click Administration > Upgrades.
The uploaded upgrade package is displayed.
Click Select Upgrade.
The Precheck option is displayed.
Click Precheck and confirm by clicking Start precheck.
The precheck process starts.
When the Precheck Passed message is displayed on the top of the screen, click Upgrade
A dialogue box is displayed with the upgrade version details.
Click Start Upgrade
The upgrade starts, and the various stages of progress is displayed.

Results

You have successfully upgraded ObjectScale to the target version.

Next steps

After upgrading ObjectScale to the target version, you must upgrade Kubernetes if there are any patch fixes available. See Infrastructure Upgrade for ObjectScale Appliance - RKE2 Upgrade for steps.

Welcome

Welcome to Dell