Skip to main content

Upgrading VADAAR

While you have an active Maintenance plan, you are eligible to receive upgrades for the latest VADAAR software releases.

Important

We recommend you backup your files before upgrading your software. For more information on backing up and restoring, see Backup and Restore.

Upgrading to the Latest Software Build​

To perform an upgrade:

Prerequisite

You'll need an ImmersaView portal account. If you do not have one and need a portal account, please send us an email at sales@immersaview.com.

  1. Log in to the ImmersaView Portal.
  2. Select the Downloads link to access your installer.
  3. Under the VADAAR 2 box, select Download.
  4. On the Downloads page, download the Server, Sender, and Viewer installers under your platform.
  5. Once each installer downloads, run each installer.
  6. For each installer:
    1. Accept the End User License Agreement when it displays.
    2. On the next screen, choose the installation path.
    3. Select the Install button to begin the installation process.
      note

      When the software finishes installing, you may need to select Yes to allow Windows User Account Control (UAC) verification messages.

Result: Your system is now upgraded to the latest software version.

note

To ensure the version upgraded, check the log file. In VADAAR version 2.0 and newer, check the version number on the About page by navigating to Settings > About. If the version number is not shown correctly, refresh the page to ensure the latest version is shown from the Server.

tip

If anything goes wrong during the upgrade process, restore VADAAR from your most recent backup. See Backup and Restore.

Migrating from Version 1 to Version 2​

Version 2 of VADAAR introduces a number of breaking API changes, listed here. If using the API, consider these changes when upgrading, as existing GraphQL queries affected will fail to execute in version 2.

note

Version 1 & 2 refer to product revisions of VADAAR 2 and should not be confused with the legacy product VADAAR Ultimate.

API Reference​

The API Playground and API Reference have changed. Visit the API Playground documentation to learn how to access the new API reference.

Migrating from Version 2 to Version 3​

VADAAR Version 3 introduces a new main database to adhere to the database's versioning policy. Instances of VADAAR that use the embedded database, enabled by default, need to migrate their database from the old version to the new version manually.

Embedded Database Migration​

Important

The database needs to be backed up on version 2. If version 3 is already installed, roll-back to version 2 to back up the database.

  1. Backup your database on version 2.x following the database backup instructions.

  2. Upgrade VADAAR to version 3.x following the upgrading to latest software instructions.

  3. Run the upgrade command.

    danger

    The upgrade command is destructive. Ensure your database is backed up before executing.

    Use an administrative command prompt:

    "C:\Program Files\VADAAR Server\VadaarServer.exe" --DatabaseUpgrade=true
    This should complete without errors.

  4. Start VADAAR Server normally.

  5. Restore the backup file following the database restore instructions.

  6. Restart VADAAR Server.

Result: VADAAR is fully operational.