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 - Role changes for managing Microsoft resource accounts
Starting with Automate 24.1, Microsoft requires that you use application registration (app registration) for authentication. If you wish to use basic authentication with service account credentials, please contact VOSS support for assistance. Until Microsoft implements changes to their resource account infrastructure, basic auth is required to create, update, and delete resource accounts. List (import/sync) of resource accounts is supported with app registration authentication in Automate 24.1.
If you wish to manage resource accounts in Automate, you’ll need to set up a service account with an additional role assigned, “User Administrator”, “Global Administrator”, or custom roles that include the “User Management” permission.
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)