Upgrading Veeam Kasten

Note

Currently, upgrades are only supported across a maximum of four versions (e.g., 2.0.10 -> 2.0.14). If your Veeam Kasten version is further behind the latest, a step upgrade process is recommended where you can use the --version flag with helm upgrade to control the version jumps. At least 50% free space is required in catalog storage also.

Upgrade Assistant

You can verify the available free space for the catalog and access your recommended upgrade path by navigating to the System Information page from the Settings menu in the navigation sidebar or by using Veeam Kasten Primer for Upgrades resource.

../_images/upgrade_assistant_ui.png

Upgrading Helm-Installed Veeam Kasten

To upgrade to the latest Veeam Kasten release, unless you have installed Veeam Kasten via the a public cloud marketplace, you should run the following command assuming you installed in the kasten-io namespace with the release name k10. If you do not remember your release name, you can easily discover that via the use of helm list --namespace=kasten-io.

$ helm repo update && \
    helm get values k10 --output yaml --namespace=kasten-io > k10_val.yaml && \
    helm upgrade k10 kasten/k10 --namespace=kasten-io -f k10_val.yaml

Known Issues: Helm 3 has known bugs with upgrade (e.g., #6850). If you run into errors along the lines of

Error: UPGRADE FAILED: rendered manifests contain a new resource that already exists. Unable to continue with update: existing resource conflict: kind: Deployment, namespace: kasten-io, name: prometheus-server

Please use the following as a workaround and then run the above upgrade commands.

$ kubectl --namespace=kasten-io delete deployment prometheus-server

Upgrading on the Google Cloud Marketplace

If you have installed Veeam Kasten via the Google Cloud Marketplace, please follow the instructions here.

Upgrading on the AWS Marketplace

If you have installed Veeam Kasten via the AWS Container Marketplace or AWS Marketplace for Containers Anywhere, please follow the marketplace upgrade instructions.

Upgrading an Operator Installed Veeam Kasten

Upgrading a Veeam Kasten installation made by a Veeam Kasten Operator requires updating the Veeam Kasten Operator. Ref: Red Hat documentation for upgrading installed Operators.

The process of upgrading the Veeam Kasten Operator depends on how update was configured during install - Automatic or Manual.

../_images/install_operator.png

The Operator update approval strategy can be changed anytime after install from the Subscription tab of the Operator.

../_images/change_operator_update.png

For an Automatic update, the Veeam Kasten Operator and Operand (which is the Veeam Kasten install) are both automatically updated any time a new Veeam Kasten Operator is published.

For a Manual update, the cluster administrator must approve the update when it shows up for the installation to begin. Ref: Red Hat documentation for manually approving a pending Operator upgrade.

../_images/operator_upgrade_available.png

The Veeam Kasten operators are published with a maximum supported OpenShift version. This will cause warnings to appear when trying to upgrade a cluster beyond the maximum supported version.

Warning

Upgrading the cluster beyond the Veeam Kasten maximum supported OpenShift version may cause unpredictable Veeam Kasten behavior and will result in losing Kasten support.

Examples of warning messages for cluster upgrade:

../_images/update_cluster_warning.png
../_images/cluster_settings_warning.png