Upgrade Guide with Delta Bundle#
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.
Upgrades to v21.4-PB1 and v21.4-PB2 - Web Portal Default Settings
VOSS Automate offers two graphical interfaces, or web portals - admin
and classic
.
Your system administrator defines, via the following command, the web portal that will be the default
for your system: web portal default set <admin|classic>
Typically, the admin
web portal is set as default, and the classic
web portal is disabled (only classic
can be disabled).
These settings should be preserved post-upgrade.
However, an issue was reported for upgrades from v21.4 to v21.4-PB1, where the web portal settings were not
preserved post-upgrade. In this case, you would need to re-run the following commands to set
admin
as default, and to disable classic
:
web portal default set admin
web portal disable classic
This issue was fixed for upgrades to v21.4-PB2, which means that the web portal settings you have in earlier versions are preserved when upgrading to 21.4-PB2.
For more information around these settings, see:
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.
Upgrades to a v2x.x Release from a v18.x or v19.x release - Impact of new Usage field added to Directory Numbers
From release 21.1 onwards, a new field called Usage has been added to Directory Numbers (DN).
This field tracks the type of device that the DN has been assigned to. For example, for Phones, Device Profiles, and Remote Destination Profiles, the usage is “Device”. For Hunt Groups, the usage is “Hunt_Pilot”, and so on.
The Usage field is automatically populated when the DNs are assigned to and removed from various devices from 21.1 onwards.
In order to populate the Usage field once-off for all existing Directory Number inventory
instances, the Audit Number Inventory tool (view/NumberInventoryAudit
) should be run once
post-upgrade for each customer.
The tool only needs to be run once when initially upgrading to a 2x.x release from a 18.x or 19.x release.
If you ran the tool already when upgrading to 21.1 for example, then it does not need to be run again when upgrading to later versions, for example 21.2, 21.3, 22.1, and so on.
Before running the tool:
Careful consideration must taken when selecting where the Number Inventory is deployed: Customer or Site - this is usually Dial Plan dependent.
Review the Audit Number Inventory topic in the Core Feature Guide.
Upgrade Planning#
Multinode Upgrade#
- Unified Node Topology: Upgrade a Multinode Environment with the Delta Bundle
- Download Files and Check
- Adaptations Check
- Schedules, Transactions and Version Check
- Pre-Upgrade, Security and Health Steps
- Upgrade
- Post-Upgrade, Security and Health Steps
- Post Template Upgrade Tasks
- Restore Adaptations
- Restore Schedules
- Release Specific Updates
- Log Files and Error Checks
- Licensing after Delta Bundle Upgrade
- Modular Cluster Topology: Upgrade a Multinode Environment with the Delta Bundle
- Determine the Primary database and application node in a Modular Cluster Topology
- Download Files and Check
- Adaptations Check
- Schedules, Transactions and Version Check
- Pre-Upgrade, Security and Health Steps
- Upgrade
- Post-Upgrade, Security and Health Steps
- Post Template Upgrade Tasks
- Restore Adaptations
- Restore Schedules
- Release Specific Updates
- Log Files and Error Checks
- Licensing after Delta Bundle Upgrade
Single Node Upgrade#
- Upgrade a Single Node Cluster Environment with the Delta Bundle
- Download Files and Check
- Adaptations Check
- Schedules, Transactions and Version Check
- Pre-Upgrade, Security and Health Steps
- Upgrade
- Post-Upgrade, Security and Health Steps
- Post Template Upgrade Tasks
- Restore Adaptations
- Restore Schedules
- Release Specific Updates
- Log Files and Error Checks
- Licensing after Delta Bundle Upgrade