Note these points before upgrading.
If the cluster is running an earlier release, upgrade to VAST Cluster 3.2.x before following the instructions on this page to upgrade to VAST Cluster 3.4.x.
By default, all upgrades are non disruptive (NDU). This is done by performing a rolling restart of Dnodes and CNodes. On small clusters, this is done one node at a time. On larger clusters, up to 10% of CNodes will be upgraded concurrently, while DNodes will continue to be done one at a time.
The duration of the main upgrade process depends on the cluster's workload and size. Expect a cluster upgrade to take at least one hour for the smallest size cluster (1 DBox and 1CBox) and proportionally longer for larger clusters.
We recommend not to run any other carrier replacements, server expansions or other such field operations in parallel to the upgrade.
During NDU, clients can continue to write data to the cluster. However, the following operations are blocked:
Creating, modifying and deleting VIP Pools
Uploading a support bundle
Setting a password
Enabling or disabling a CNode or DNode
Creating or modifying a view policy
Enabling or disabling an SSD or NVRAM
Creating a user.
There are a few post upgrade tasks that continue for a while after the NDU is complete. During that post upgrade phase, the following activities are blocked:
Another upgrade (which could be a software upgrade or an NVRAM upgrade)
Certain VMS operations the modify metadata, such as setting quotas.
Upgrade of VAST OS on the CNodes and DNodes is an optional part of the upgrade procedure. Please confirm with VAST support before enabling this feature.
VAST Cluster 3.4.x minimally requires VAST OS 10.0.28 on all CNodes and DNodes in the cluster.
To check CNode and DNode OS versions from the VAST Web UI:
Obtain a link for downloading the target release package. Links may be available in the version release notes. Otherwise, please request a link from VAST Data Support.
The package file contains all component images.
Download the release package file to your local machine.
Connect to the VAST Web UI.
From the left navigation menu, select Infrastructure and then Clusters.
Select the Actions button for the cluster () and then select Upgrade.
The Upgrade Cluster dialog appears.
Click Upload a file and browse to the package file that you downloaded.
Enable options only from the following, as needed:
Cold. Deactivates the cluster during upgrade. When not selected, cluster operation continues without disruption. You cannot select this option if you are selecting the OS option.)
This option will cause downtime and is not recommended without explicit guidance from VAST Data Support.
Cold upgrade is not supported if VAST OS is upgraded (see OS.)
Force. Forces upgrade regardless of version or upgrade state. Use this option if you need to upgrade to the same version as already installed or if a previous upgrade failed without the upgrade state clearing.
OS. Upgrades the OS on the CNodes and DNodes. Be sure to check this if you need to upgrade VAST OS on the CNodes and DNodes.
Do not select BMC or NVRAM! Upgrade of BMC firmware and NVRAM firmware from 3.2.x to 3.4.x are not supported!
Do not select SSD since SSD upgrade cannot be run together with the core platform upgrade. It can be run as a separate task afterwards. Some performance impact is expected when upgrading SSDs on QLC DBoxes.
Click Upgrade and then click Yes to confirm.
The release package is now uploaded to the cluster and following upload, the upgrade begins. The Activities icon indicates the upload progress at the top of the page. When the upload is complete, the upgrade begins.
You can monitor progress on the Activities page.
Connect to the Management CNode using the local IP (not the VMS VIP).
Download the package file to the Management CNode, placing it under
/vast/bundles. For example:
wget link -O /vast/bundles/filename
It is important that the file is specifically copied to
/vast/bundlesand not to any other location.
Run the following command to start VAST CLI:
vcli -u <username> -p <password>
From the VAST CLI run the cluster upgrade command.
For example, if CNode OS upgrade is not needed:
cluster upgrade --build-package /vast/bundles/release-<release number>-<pipeline number>.vast.tar.gz
Alternatively, with CNode OS upgrade:
cluster upgrade --build-package /vast/bundles/release-<release number>-<pipeline number>.vast.tar.gz --os-upgrade
Wait patiently for upgrade to complete.
Initially, the build file is extracted and imported, which takes some time. Once that stage is complete, the upgrade begins and the progress is displayed in the CLI.