Upgrade Guide with ISO and Template#
Introduction#
Before starting with this upgrade, please read the following notes related to upgrades from earlier versions of the software.
Normal operations will be interrupted during an upgrade. Perform the upgrade in a maintenance window. Refer to the type of upgrade for details on the upgrade duration.
Release 21.4 onwards - Product License Changes
From release 21.4 onwards, VOSS Automate allows for the registration and update of product licenses within the application. A licensing service is installed during installation or upgrade and a license token is associated with the platform on which it is installed.
Release 24.1 onwards - Virtual Machine and ESXi Version Compatibility, and AVX Support
Before starting your upgrade, ensure that the hardware version of each of your virtual machines (VMs) is at least version 11, compatible with ESXi 6.0 and up, and that your host CPU supports AVX (Advanced Vector Extensions).
A "check cluster" command in the Automate pre-upgrade steps checks for AVX support. To ensure that AVX support is added to the VMs, you'll need to upgrade the compatibility of the VM in vCenter.
Release 24.1 onwards - Microsoft Teams, Deprecation of Basic Authentication
Starting with Automate 24.1, Microsoft PowerShell must be set up for app (application) registration for authentication.
See the following references:
Upgrade Planning#
Unified Node and Modular Cluster Topology Preparation#
Multinode Upgrade#
- Unified Node Topology: Upgrade a Multinode Environment with the ISO and Template
- Download Files and Check (Prior to Maintenance Window)
- Version Check (Prior to Maintenance Window)
- Security and Health Check Steps (Maintenance Window)
- Pre-Upgrade Steps (Maintenance Window)
- Upgrade (Maintenance Window)
- Post-Upgrade, Security and Health Steps (Maintenance Window)
- Database Schema Upgrade (Maintenance Window)
- Template Upgrade (Maintenance Window)
- Post Template Upgrade Tasks (Maintenance Window)
- Log Files and Error Checks (Maintenance Window)
- End of the Maintenance Window and Restoring Schedules
- Licensing (outside, after Maintenance Window)
- Mount the Insights disk (outside, after Maintenance Window)
- Modular Cluster Topology: Upgrade a Multinode Environment with the ISO and Template
- Download Files and Check (Prior to Maintenance Window)
- Version Check (Prior to Maintenance Window)
- Security and Health Check Steps (Prior to Maintenance Window)
- Pre-Upgrade Steps (Maintenance Window)
- Upgrade (Maintenance Window)
- Post-Upgrade and Health Steps (Maintenance Window)
- Database Schema Upgrade (Maintenance Window)
- Template Upgrade (Maintenance Window)
- Post Template Upgrade Tasks (Maintenance Window)
- Log Files and Error Checks (Maintenance Window)
- End of the Maintenance Window and Restoring Schedules
- Licensing (outside, after Maintenance Window)
- Mount the Insights disk (outside, after Maintenance Window)
Single Node Upgrade#
- Upgrade a Single Node Cluster Environment with the ISO and Template
- Download Files and Check (Prior to Maintenance Window)
- Security and Health Steps single node cluster (Prior to Maintenance Window)
- Version Check (Prior to Maintenance Window)
- Pre-Upgrade Steps single node cluster (Maintenance Window)
- Upgrade single node cluster (Maintenance Window)
- Post-Upgrade, Security and Health Steps single node cluster (Maintenance Window)
- Database Schema Upgrade single node cluster (Maintenance Window)
- Template Upgrade single node cluster (Maintenance Window)
- Post Template Upgrade Tasks single node cluster (Maintenance Window)
- Log Files and Error Checks single node cluster (Maintenance Window)
- End of the Maintenance Window and Restoring Schedules
- Licensing (outside, after Maintenance Window)
- Mount the Insights disk (outside, after Maintenance Window)