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 firmware2018_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
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 isRunning
.
- 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 runningls
. - 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 byEnter
.
- To continue and install, select Yes by typing
1
followed byEnter
.
- Select Yes by typing
1
followed byEnter
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 pressingEnter
.
- 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 runningservice mongod start
. - Check that Evoko Home is running by entering
sudo supervisorctl
, the output should sayRUNNING
.
- 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.
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.