Upgrading Witness

Introduction

This page covers upgrading your system from older to newer versions of Witness V4.

The following instructions are for:

Standard Upgrades using the Upgrade wizard for a non-redundancy setup.
Advanced Upgrades for fully redundant systems. Please refer to Redundancy for more information.

For Migrating from Witness V3 please view this page: Migration from Witness V3.

Please note that only upgrades are supported by the standard Witness installer, you cannot downgrade a newer installation to an older version.

Before the Upgrade

It is vital to perform a backup of the database before upgrading a system, in case there is an issue and the system needs to be restored. Please refer to: https://navtechradar.atlassian.net/wiki/spaces/TUN/pages/776798248/Database+Configuration#Backup-Database
Plan the upgrade to occur when there will be minimal disruption. During the upgrade the system will not be operational.
We strongly recommend that you review the relevant release notes before starting any upgrade:
AdvanceGuard®: AdvanceGuard® Release Notes
ClearWay™: ClearWay™ Release Notes

All recommendations apply even if you skip an upgrade between older versions. Therefore, please ensure you check all upgrade notes from the version being upgraded to the version you intend to install.

Standard Upgrade

Open the installer / upgrade application.
A warning will be given; select Yes to continue:
The Witness Setup screen will open.
Ensure that the Update option is selected and then click Next:
Select the language option you require (Default is English) and click Next:
The Management Server service details should already be populated. These are basic settings so the software knows how to start and find all the other components on the network. Here is an example:
Please ensure all details are correct, especially the correct management server address, database server address, and then click Next. If you are unsure, cancel the upgrade and get the details from your technical support.
If the MongoDb server was selected as a component during the installation of Witness then the database service details will be displayed:
Click Install.
The new version of the software should then be installed, and an installation screen will be displayed:
One the installation is complete you will need to confirm if you want to set the services to start automatically or manually. Ensure the default username and password remain unchanged. Then click Next:
The InstallHelper.exe should briefly open and then close:
Click Finish to complete the upgrade:
Check that the version number displayed at the bottom of the System Login screen is the expected new version number: