WAVE: Changing the OS of your WAVE System

WAVE is a 100% cross-platform software. It can support Windows, Linux, MacOS, and ARM-based-Pi. 



If an OS change is required on a system:

  1. Login to the WAVE Media Server using the WAVE Desktop client
  2. Click the Main Menu Button, navigate to System Administration and then click Create Backup...
  3. Copy all the backup files and store them to an external drive or storage.
  4. Reinstall your system with a new OS.
  5. Install proper version of the WAVE server and the client to your system.
  6. Login to the newly installed WAVE Media Server via WAVE Desktop client
  7. Click the Main Menu Button and navigate to System Administration, then click Restore from Backup...


Notice: This migration will discard the motion chunks (for Smart Search), Audit Log and Event Log. The logs listed above will not be migrated.


Migrating System Metadata:

The migration of metadata between OS platforms may pose a risk of losing data which you hoped to retain.  Be sure to create backups of all database files and consult with WAVE Support before attempting to perform this migration.

[From Linux to Windows as an example]

  1. Stop the server
  2. Fully copy the folders:
    - /opt/Hanwha/mediaserver/etc
    - /opt/Hanwha/mediaserver/var
  3. Copy and save all archives from every single disks (you can just legacy the HDDs and use them on a new system as well)
  4. Save all license keys.
  5. Install the proper version of WAVE on Windows.
  6. After installation, please first Stop the Server. Additionally, make sure that previously Linux servers are not active to avoid server conflict.
  7. Open the file etc/mediaserver.conf, copied from the Linux server, and find the serverGuid parameters.
  8. Execute regedit.exe on Windows Machine.
    Navigate to  HKEY_LOCAL_MACHINE\SOFTWARE\Hanwha\WAVE Media Server
    Find key guidIsWAVEID and set it to no.
    Find key serverGuid and set it as the value you found in Linux configuration file from Step #7. Change key systemName if it's needed.
  9. Open C:\Windows\System32\config\systemprofile\AppData\Local\Hanwha\WAVE Media Server and delete all the files in that folder.
  10. Paste the copied files to C:\Windows\System32\config\systemprofile\AppData\Local\Hanwha\WAVE Media Server

It should include:
ecs.sqlite -- main DB
mserver.sqlite -- DB with Audit Trail, Event Log, Bookmarks etc.
record_catalog -- folder with motion data
ssl -- folder with ssl certificate

  1. Connect all the storage drives.
    If archive was recorded to /opt/Hanwha/mediaserver/var/data, copy /opt/Hanwha/mediaserver/var/data/hi_quality and /opt/Hanwha/mediaserver/var/data/low_quality to an empty disk.
  2. Place the folders inside of WAVE Media. If WAVE Media is not found, create one.
  3. Make sure that all WAVE Media on each storage drives contain only high_quality and low_quality. All db and .ref files should be deleted.
  4. Start the WAVE Server. And then login using the WAVE Desktop client, and Rebuild the archive index.
  5. Old storage drives list can be seen in Storage list in the Client. Try to delete them from UI. If you can't, please, contact WAVE Tech support.
  6. Issue a license reactivation request on WAVE Support Portal, and provide us the new HARDWAREID. Then reactivate the licenses again to enable recording.


Copyright © 2021 Hanwha Techwin America.
All rights reserved