Skip to main content
Skip table of contents

Upgrade ClusterVisor

Online ClusterVisor Upgrade

If a cluster is able to access the internet, ClusterVisor contains an automated tool that can perform the upgrade across all nodes and node images.

WebUI

In the web UI navigate to ClusterVisor Config → Software Upgrade

Click Upgrade to version to see available versions for install.

image-20251209-203519.png

Once selected, click Next to begin the upgrade, following the prompts accordingly.

Unless advised by Advanced Clustering support, only use the “production” software channel for ClusterVisor upgrades, as updates from the “development” channel may contain updates not ready for production environments.

CLI

BASH
cv-upgrade -I

This will check ACT’s ClusterVisor repo for any updated version from the version currently installed, download the latest version, and install to all nodes.

The -I argument indicates to include updating ClusterVisor on all node images

-y can be added to assume “yes” to all prompts

Offline ClusterVisor Upgrade

For cluster that are “offline” or have heavy filters and restrictions, then the “offline upgrade” is required.

  1. Check for CV updates by going to the ClusterVisor Version Browser (https://repo.advancedclustering.com/clustervisor)

  2. Copy in your license key to the provided text box

    1. The cluster admin will then receive the license key via email

    2. If it needs to be sent again, please contact your sales representative or ACT support at support@advancedclustering.com

  3. Once logged in, you can filter down all the versions with the version number, architecture, and release

  4. Download the latest version, which download as a tar file, that looks something like: 2.25.10-6190.el9.x86_64.tar.gz

  5. Copy that file over to either the head node or the appliance in this path: /clustervisor/software/clustervisor/

    1. The file must exist here to upgrade via web UI

  6. Verify the sha256sum

    1. If you downloaded the checksum file you can do sha256sum -c clustervisor-2.25.10-6190.el9.x86_64.tar.gz.checksum

      1. Otherwise you can run sha256sum 2.25.10-6190.el9.x86_64.tar.gz and make sure it matches)

  7. Once the sha256sum is verified you can then begin the upgrade:

Web UI

In the web UI navigate to ClusterVisor Config → Software Upgrade

Under Upgrade Source select Offline, then click select the version to upgrade to in the Upgrade to version dropdown

If you do not see the downloaded version, make sure the downloaded tar.gz file is located in /clustervisor/software/clustervisor/

The file can be uploaded from your local machine by clicking the Filemanager button below Upgrade Source. This will open a file browser to /clustervisor/software/clustervisor/. Locate the upload button – image-20251209-203157.png – to open a prompt which will allow you to drag and drop the file or Browse for the file on your local workstation by clicking Upload.

Once the file is uploaded, select the version from the Upgrade to version dropdown

Click Next to begin the upgrade, following all prompts accordingly

image-20251209-203613.png

ClusterVisor Offline Software Upgrade Example

image-20251209-203658.png

Use Filemanager to browse for or upload the ClusterVisor software file example

CLI

cv-upgrade -I --skip-download

Follow the prompts from there

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.