Articles in this section

See more

WAVE: Downgrade to a Previous Version

Ehsan Khan
  • Updated
Follow

Why downgrade a WAVE system?

Although it is never recommended to downgrade an WAVE System, there are certain cases where a user may need to downgrade their system after an upgrade to the latest release. This article outlines how to accomplish a downgrade.

WAVE automatically creates a backup of the previous version database prior to every upgrade, so to downgrade, you will need to

  • create a copy of this database,
  • completely remove WAVE from your computer,
  • install the target version, and
  • restore the newly installed System from the backed up database.

Downgrading an WAVE System

Step 1: Make a copy of the System database

  1. Stop the WAVE Server service.
  2. Locate the Hanwha Media Server database folder and move the ecs.sqlite database file to a safe location:
    • In Windows
      C:\Windows\System32\config\systemprofile\AppData\Local\Hanwha\WAVE Media Server
    • In Linux
      /opt/hanwha/mediaserver/var
      NOTE: This step must be repeated for every server in a multi-server system.
  3. Open the backup folder and copy the last backup file to a safe location:
    - Version 4.1: Depending on whether the last backup was automatic or manually triggered, it will be named in one the following formats: ecs_<buildnumber>_<timestamp>_timer.db or ecs_<buildnumber>_<timestamp>_manual.db
    For example: ecs_31768_1600913446096_timer
    - Versions 3.0-4.0: ecs.sqlite.<version number>.<build number>
    For example: ecs.sqlite.3.0.0.15297
    - Versions 2.6 and earlier: ecs_0.backup

Step 2: Uninstall WAVE

Step 3: Install the desired past version of WAVE

  1. Install and set up the desired WAVE version (must match the copied database version!) on each affected Server in the System. Feel free to use the same System Name, or another one, it doesn't really matter as this will be restored by your ecs.backup file.

Step 4: Stop Servers, Restore Database, Restart Servers

  1. After installation is complete stop all Servers in the System.
  2. Navigate back to the WAVE Media Server folder (referenced in Step 1)
  3. Delete the ecs.sqlite database currently in the folder
  4. Find the backup file you would like to restore from.
    • The file you're looking for will have the same date as the date you upgraded to the version you are downgrading from. (example: If you upgraded your system to 3.1 on November 28th, 2017 your backup file will have been created on the same date.
      • In version 2.6 and before the files were called ecs_x.backup
      • In version 3.0 and forward the files will have a version (e.g. ecs.sqlite.3.0.0.15297) and are easier to identify.
  5. Rename the database backup file to ecs.sqlite
  6. Repeat for all Servers in the System
  7. Restart all Servers

Step 5: Log in to your restored, downgraded System.

  1. Open WAVE and log in using the owner password (or WAVE Sync account)
  2. After restoring the database make sure all cameras/etc are accurate. Note: Any changes made to the System since the backup file was created will not be persistent. 

Related articles