Introduction

This page covers upgrading your system from older to newer versions of Witness AdvanceGuard® or ClearWay™ 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 https://navtechradar.atlassian.net/wiki/spaces/TUN/pages/477265925 for more information.

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: https://navtechradar.atlassian.net/wiki/spaces/TUN/pages/776798248/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®: and

   ClearWay™: and

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:
   
   

   Open

   

    

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

    

   Open

   

    

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