Upgrading Witness

Introduction

This page covers upgrading your system from older to newer versions of Witness AdvanceGuard® or ClearWay™ V4.

The following instructions are for:

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.

Contents



Before the Upgrade

  1. 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: Database Configuration | Backup Database.

  2. Plan the upgrade to occur when there will be minimal disruption. During the upgrade the system will not be operational.

  3. We strongly recommend that you review the relevant release notes before starting any upgrade:

    AdvanceGuard®: AdvanceGuard® Release Notesand AdvanceGuard® Upgrade Instructions

    ClearWay™: ClearWay™ Release Notesand ClearWay™ Upgrade Instructions

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

  1. Open the installer / upgrade application.

  2. A warning will be given asking if you want to allow this app to make changes to your device. Select Yes to continue.

  3. The Witness Setup screen will open.

  4. Ensure that the Update option is selected and then click Next:

     

  5. Select the language option you require (Default is English) and click Next:

     

     

  6. The Management Server service details should already be populated with the current installation configuration settings:

     

  7. If the MongoDb server was selected as a component during the installation of Witness then the database service details will be displayed:

     

  8. Click Install.

  9. The new version of the software should then be installed, and an installation screen will be displayed:

     

  10. 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:

     

  11. The InstallHelper.exe should briefly open and then close several times:

     

  12. Click Finish to complete the upgrade:

     

  13. Check that the version number displayed at the bottom of the System Login screen is the expected new version number:

     

Advanced Upgrade

The advanced upgrade is for fully redundant systems, which will have Primary, Secondary and Tertiary Database Servers.

  1. To proceed with an advanced upgrade stop all Witness services on all servers.

  2. Then upgrade all three Database Servers, without the Start service(s) after install selected, as in the example below:


     

  3. Start the the Witness Database Servers (MongoDB Service) in the order of Primary, Secondary and then Tertiary:

     

  4. Next upgrade the Primary Management Server but do NOT start the services as part of the upgrade. Note: if you have a combined Database and Management Server, then the Management Server will have already been upgraded.

  5. Start the Management Server Shortcut found in Explorer by using the path %ProgramFiles%\Navtech Radar\Witness by Double Clicking it. Do NOT run the ManagementServer Application.

     

     

  6. A ManagementServer command window will be displayed. Press 1 to start the server:

     

  7. Ensure that no database errors have occurred. Check that the Database Upgrade has succeeded and the output shows Core - Is Primary Server:

     

  8. Then use Ctrl+C to stop and exit the ManagementServer.

  9. Start the Witness services on the Primary Management Server.

  10. Check that each service is running:

     

  11. Repeat the process to upgrade the Secondary Management Server and start the services.

Verification Process of Primary and Secondary Management Servers

  1. Use the Witness UI to check the Primary and Secondary servers are online and the database status is Green in the Topology tab.

  2. Once a healthy status is confirmed, you can then upgrade all other servers and start their services.


Related Information

Safety is everything.