Witness™ 4.0 has a single installer application that can be used for installing a single service on multiple hardware platforms or for installing several services on the same platform. When using the installer, it is important that you select the correct services and plugins for the required role of the hardware platform. Please refer to the System Design documentation to see what different roles you can configure for different hardware platforms. This design will change depending on the number of radars you will be using and whether you are implementing the resilience features.
There are a number of prerequisites which must be installed prior to running the software. It is recommended that these are installed before installing Witness™. Please refer to Software Prerequisites for more information:Software Prerequisites.
Open the installer application. Once running, move onto the licence page and confirm you accept the terms of the terms of the licence. Select your language. Once complete move onto component selection.
The predefined options for the components are as follows:
Complete: This installs a complete system onto a single platform. This is a good solution for testing, demonstration and small-scale trials but must never be used for production systems.
Management Server: This will just install the Management Server service.
Track Engine: This will just install the Track Engine service. The Situational Awareness components are automatically installed with the Track Engine but are not available unless they are correctly licensed.
Camera Controller: This will just install the Camera Controller service. Camera Plugins will be installed by default.
User Interface: This will just install the Helvellyn client. The client can be installed on multiple PCs, but you must have a licence for each instance.
MongoDb Server: This will just install the MongoDb database service. This enables the service to be installed on separate servers where required, either as part of replica set for resilience or just to separate the database load from other services.
Mobile Server: This will just install the Mobile Server service. This allows the operator to access the Witness™ Mobile client.
Image Server: This will just install the Image Server service which provides dynamic management of video streams, including transcoding, scaling, frame rate adjustments and re-streaming.
Custom: Custom is not a predefined option, but the installer will switch to custom if you select any combination of components that do not match the predefined options. For example, if you installed the Management Server but did not select an Image Server then this would become a custom install as in the example below:
Selecting different components may have an impact on what further pages appear during the install process. The installer will only ask for information which is required the selected components. |
The installation location can now be chosen:
Having selected the required components, you must provide some basic settings, so the software knows how to start and find all the other components on the network.
The following fields must be completed when prompted:
Management Server Address (Required for Management Server, Camera Controller, Mobile Server & Track Engine Installs): This must be the interface address of the Management Server. This must be provided for all components so:
The Management Server knows what address to listen on so other services can connect across the network
All other services know where to find the Management Server so they can connect
Be careful using the loop back address (127.0.0.1). This will work for systems where all the services are on the same physical PC or server, but this will not work if you have services on different systems. If you are not sure which to use then we would always recommend you use the primary IP address of the system, not the loop back address. Lastly, never use the name localhost in place of the loop back address. If you are confident that you can use the loop back address, then always use the 127.0.0.1 IP address. |
Use Auto-Discovery for services (Required for Management Server, Camera Controller, Mobile Server & Track Engine Installs): This option must be selected if you are using the resilient features and are installing two Management Servers. This enables all services to discovery which Management Server is currently the primary so they can successfully connect. This option is not required if you are only installing a single Management Server.
Use TLS for services: This option is enabled by default. Transport Layer Security (TLS) is an encryption protocol that protects data when it moves between computers.
When installing two Management Servers, you must provide the correct Management Server Address for each instance. For example, if you install the first Management Server on a system with a primary IP address of 10.1.0.1, then this should have a Management Server Address of 10.1.0.1 and you should select the Auto-Discovery. If the second server has an address of 10.1.0.2, then during the install you must set this Management Server Address to 10.1.0.2 and select the Auto-Discovery. |
Multicast Interface Address (Required for Management Server, Camera Controller, Mobile Server & Track Engine Installs): This field can be left at the default 0.0.0.0 where there is only one network adaptor in the system and where that adaptor is only configured with a single IP address. If the system has multiple adaptors or a single adaptor with multiple addresses (a setup usually referred to as multi-homing) then this field must be set to the IP address used on the interface which connects the system to the rest of the Witness™ services.
Multicast Address: The multicast address has two modes of working.
One method uses failover in multicast mode, which has a multicast address of the form 239.x.x.x.
The other method uses failover in unicast mode which is a pair of addresses separated by a comma for the Management Servers, with the first address being the Management Server you are installing the Management Server onto. For example, you have two Management Servers - MS1 with an IP address of 192.168.0.5 and MS2 with an IP address of 192.168.0.6. So, when installing onto MS1, the address would be 192.168.0.5,192.168.0.6 and when installing on MS2 the address would be 192.168.0.6,192.168.0.5.
Management Server Rank (Required for Management Server Installs Only): This field must be completed when you are installing more than one Management Server. The rank dictates which of the two servers is primary and which is secondary. A lower rank value (normally 0) indicates the primary server. A higher value (normally 1) indicates the secondary. If you are not using the resilient features, then this field should be left at the default value of 0.
Database Server Address (Required for Management Server Only): This is the address of one or more of the database servers that the Management Server is required to use. If you are using a single database, then should be the IP address of the database system. If you are using a replica set - for resilience - then typically you will need to provide three IP addresses, one for each server in the replica set. The IP addresses can be entered as a comma separated list i.e., 10.0.1.10,10.0.1.11,10.0.1.12
Database Name (Required for Management Server Installs Only): This must be completed with the name of the database used for this installation. Unless you have a specific requirement to change the name it should be left at the default value.
If you selected the MongoDb server as a component, then you will be asked for the database settings.
The following fields must be completed when prompted:
Use Replica Set: this should be selected if the database server you are installing is part of a resilient replica set.
If you are installing the Management Server and the MongoDb Server onto the same system, and you have already added a comma separated list of IP addresses for the replica set, the Use Replica Set field will already be set and you won't be able to change it. The installer assumes it must be a replica set because you provided more than one IP address for the database. If you only installing the database server then the installer won't know if you are trying to install a replica set, so you must set this field manually. |
Database Path: This is the location where the database will store its data. Depending on the size of the installation and the amount of data you need to record, the database can get very large. In this situation we would strongly recommend that the data is stored on a separate drive or partition to the operating system.
A Windows scheduled task will be created called WitnessMongoLogRotate. This script runs at midnight, every 24 hours to ensure that there are only ever 10 MongoDB logs (thus the hard drive will not fill up with these logs). |
Once you have provided all the necessary settings, you need to select the Install button to copy all the files to disk. All the relevant files will be automatically copied to the default application folder: Program Files\Navtech Radar\Witness.
Once the selected components have been installed, a preset but editable Service Username and Password will be configured, or you can use a pre-existing account.
You will be prompted for some service settings:
Start service(s) after install: This option should be selected unless you have a good reason not to start the services. If you choose not to select this option, then the installed services can be started with a system reboot or by using the Services Control Manager (SCM).
Set service(s) to manual startup: This option prevents the services starting automatically when the system boots. This should never be used for a production system, only for engineering or test installations. With this option set, the services can only be started using the SCM, and this option can only be changed by reinstalling the services.
When ready, select Next and Finish on the final page to close the installer.
Change the content by label macro to filter for other articles / resources related to this one. You can select one or labels in the macro to auto-link other pages.