How do I migrate from v1.x to v2.x? – Evoko Support

This guide describes the update process for your Evoko Home server and Liso devices to update from version 1.x to version 2.x.

Important! We recommend reading through this support article before starting the update process. If anything is unclear, please do not hesitate to contact us for advice and update assistance.

Important! We recommend checking the list of supported booking systems before upgrading as they might have changed.

Quick Summary
Update Evoko Home to v2.x on a Windows server
Update Evoko Home to v2.x on a Linux server
Update Evoko Liso firmware

Summary

With v2.x, only default mode is supported.
Updating is supported from Evoko Home v1.37.0 or later and Evoko Liso firmware 2018_06_28_v1.37.0 or later.
We recommend updating Evoko Home to v2.x first and then remote update the Evoko Liso firmware.
Due to some breaking API changes, Evoko Home v2.x is not backwards compatible with Lisos running firmware v1.x. Meetings will not sync to or from the Lisos.
Remote updating Lisos running firmware v1.37 to v2.0 from Evoko Home v2.0 works.
Windows server users are recommended to run the "single installer" setup.exe to update.
Linux server users are recommended to run the installation script install.sh as usual to update.

Update Evoko Home to v2.x on a Windows server

Important! make sure you have your MongoDB credentials documented, they can be found in your configuration file C:\Program Files (x86)\EVOKO\EvokoHome\ErmService.exe.config. If the credentials are different from the default values (evoko_user, evoko_pass, evoko_db) then it is crucial that you save them somewhere as the credentials are needed when updating Evoko Home. Failure to perform this step will result in Evoko Home data loss.

Important! We recommend to always perform a database backup before you begin. Please find the instructions on how to do this here.

Download the latest version of Evoko Home for Windows to the server.
Extract the downloaded installation package EvokoHome.zip
Run the executable setup.exe
This will trigger the "single installer" which will help you install correct versions of additional software (e.g. Node.js, MongoDB etc) required to run Evoko Home.
Enter your MongoDB credentials.
Once the update is complete, verify that the service is running under services.msc.
Look for a service named ERM Service and make sure its status is Running.
Finally make sure that you can access the Evoko Home web interface as usual via a web browser.
Once you're logged in you should encounter "Migration in progress. Please wait...".
Press "OK" and you're done.
Update the Liso firmware

Update Evoko Home to v2.x on a Linux server

The process of updating from v1.37.0 to v2.x.yz on Linux is the same as previous versions.

Important! We recommend to always perform a database backup before you begin. Do this by changing into the Evoko Home install folder (usually /home/evoko/Evoko Home/) and typing sudo bash backupdb.sh. Then copy the created backup folder to a safe location.

Download the latest version of Evoko Home for Linux and put the installation package on the server.
Extract the downloaded installation package:
```
sudo tar -xzf installation_v2.*.tar.gz
```
A directory v2.x.yz should now have been extracted, you can check this by running ls.
Change directory to the newly extracted directory and run the installation script:
```
cd v2.* && sudo bash install.sh
```
Accept to remove nodejs by typing y followed by Enter.
To continue and install, select Yes by typing 1 followed by Enter.
Select Yes by typing 1 followed by Enter to update using your existing configuration/database.
Set the maximum amount of memory Evoko Home can use by typing the amount e.g. 2048 and followed by pressing Enter.
Done!
Make sure that MongoDB is running by entering service mongod status, the output should say "active (running)".

If MongoDB is not already running, attempt to start MongoDB by running service mongod start.
Check that Evoko Home is running by entering sudo supervisorctl, the output should say RUNNING.
If Evoko Home is running the exit the supervisor and remove the installation files:
```
cd .. && sudo rm -r installation_v2.*.tar.gz v2.*
```
Finally make sure that you can access the Evoko Home web interface as usual via a web browser.
Once you're logged in you should encounter "Migration in progress. Please wait...".
Press "OK" and you're done. Proceed by updating Liso units and try out the new UI.

Update Evoko Liso firmware

The Liso firmware can be updated in two different ways either by remote update or via USB stick.

Update Evoko Liso firmware via remote update

In Evoko Home navigate to Rooms > Monitoring and press "Firmware check".
Once the new release has downloaded press the button to start the remote update process for either a single Liso unit, a group of Liso units or all.

Note! The Legacy API Authentication option is enabled by default to support connecting 2018_04_16_v1.36.0 (and above) Liso units to Evoko Home v2.0. Once you are done updating all Liso units to 2.0 this option should be disabled under Global settings.

Update Evoko Liso firmware via USB

Download the latest Evoko Liso firmware update image.
Extract the downloaded firmware update image and put the full-image-gui-imx6solotinto_YYYY_MM_DD_v2.x.y.tar.gz it the root of a USB stick.
Insert the USB stick in the USB port of the Evoko Liso you wish to update.
Login as an admin on the Liso unit using PIN/RFID.
In the admin menu press "Upgrade via USB" and wait for the firmware update to complete.