Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Ensure that your Witness V3 installation has been upgraded to the latest version and that the main Piccadilly service has been started and stopped at least once.

  2. Install a complete deployment of Witness V4, either on the same or new hardware. Please refer to the installation installation documentation for more information:Installing the Software.

  3. After the install, ensure that one, or both V4 Management Servers are stopped. However you must leave the database service(s) running.

  4. Ensure you have the Witness V3 configuration.xml file available. This must be on the same PC where you intend to run the migration tool.

...

The migration tool is installed with the Management Server in V4 and can be found in the installation directory, typically C:\Program Files\Navtech Radar\Witness. The tool is entitled MigrationTool.exe.

...

It is a command line tool so should be run from a command prompt. To run the migration process follow these steps:

  1. Ensure the Witness V4 Management Server services have been stopped.

  2. Open a command prompt and enter the path to executable. To see the command line options, run the application using the -? option:

  3. The key options are:

    Image Removed
    Code Block
    -d, --databaseaddress - the database server address. Defaults to 127.0.0.1 (localhost).
    -p --databaseport - the database server port. Defaults to 27010.
    -n --databasename - the name of the database - if not provided this will automatically change depending on whether migrating to ClearWay™ or AdvanceGuard®.
    -c --configuration - the path and file name of the Witness V3 configuration file (i.e. configuration.xml).
    -s --skipprompt - by default the migration tool prompts to delete and import all items. If you change this to true the tool will not prompt.

    The minimum options required are database IP address (-d) and the location of the configuration file (-c). If the database is on the same system that you are running the migration tool, then you only need the configuration option (-c).

  4. Enter the command line appropriate for your system setup. For example:

    Image Removed
    Code Block
    C:\Program Files\Navtech Radar\Witness\MigrationTool.exe -d 10.0.7.165 -c c:\configuration.xml
  5. Once you tun run the command you will be prompted to continue. Press Y to start the migration.

    Image Removed

  6. The migration tool will show progress and list all the objects being transferred.

  7. Restart the Witness V4 Management Server services.

  8. Login to the Witness V4 system and check that all the listed objects have been migrated and settings are as expected. All the V4 system settings, such as default users and passwords, will remain unchanged.

Note

When the migration tool connects to the Witness V4 database it will delete all existing data. This should not be a problem if the Witness V4 system is a clean installation. However if you are doing the migration over an existing V4 setup then be aware that you will lose all the older configuration data.

...

Info

You will be prompted to complete the site configuration details when you first log into the UI. Note that the site origin coordinate has been imported from the V3 configuration file so should not be changed.

...