Skip to main content

Migration - Evoko Home to Humly Control Panel

  • Updated

This article describes how to migrate Evoko Home to Humly Control Panel.


During the migration process all data and settings stored in the database of Evoko Home will be migrated to Humly Control Panel. All connected Liso room booking displays connected to Evoko Home will automatically be connected to Humly Control Panel, after the migration process has been finished.

 

info_icon_zendesk.pngSome features that can be found in Humly Control Panel will not be supported on the Liso because of hardware and software limitations. However, by connecting your Lisos to Humly Control Panel you will not only keep all functionality from Evoko Home, but you will also gain new functionalities.

 

Information

Migrating from Evoko Home to Humly Control Panel is only supported for on premise installations running in a Windows server environment. Preferable on Windows Server 2019 or later. Linux is not supported.

warning_icon_zendesk.pngBefore migrating we strongly recommend creating a backup or a snapshot of your physical or virtual machine, which could be used for reverting back in case there would be any problems during or after the migration.

 

Copy server certificate and key

warning_icon_zendesk.pngBefore starting the migration we strongly recommend that you make a copy of the signed server certificate and key, since they will be replaced by a self-signed certificate and key during the migration process. After the migration is done you should replace the self-signed with the signed certificate and key that you made a copy of.

  1. Go to the EVOKO-folder in Windows Explorer and navigate to EvokoHome\liso_files\certificates\

  2. Make a copy of the server.crt and server.key

  3. Paste the server.crt and server.key somewhere safe where you can easily access them after the migration, i.e. the Desktop-folder

Screenshot_2021-12-14_at_23.22.43.png

This screenshot shows the default path of the EVOKO-folder under Program Files, but the path can also be something else since it is customizable during installation of Evoko Home.

 

Migration

  1. Visit https://humly.online and download the latest Humly Control Panel for Windows

  2. Click on the HcpInstaller_vX.x.x.x application to launch the installer
    Screenshot_2021-12-06_at_12.13.28-20211206-111334.png
    This screenshot shows HcpInstaller_v1.7.2.7, but it could be any newer version. We recommend to always migrate to the latest version of Humly Control Panel.

  3. Click Install to begin the migration process from Evoko Home to Humly Control Panel
    Screenshot_2021-12-15_at_00.19.57-20211214-232002.png
  4. Click Next
    Screenshot_2021-12-15_at_00.22.21-20211214-232226.png
  5. Change the installation destination folder for Humly Control Panel, or use the default destination folder (recommended). Click Next to confirm installation folder
    Screenshot_2021-12-15_at_00.26.27-20211214-232632.png

  6. IMPORTANT! Keep the MongoDB credentials if you want to migrate the database from Evoko Home to Humly Control Panel. Don’t change anything. Click Next
    Screenshot_2021-12-15_at_00.33.32-20211214-233338.png
  7. Click Install to begin installation of Humly Control Panel
    Screenshot_2021-12-15_at_00.39.24-20211214-233930.png
  8. The installer will detect that there are an installation of Evoko Home installed on the computer. Click Yes to import settings the settings from Evoko Home to Humly Control Panel
    Screenshot_2021-12-15_at_00.42.03-20211214-234209.png
  9. Migration process is finished. Click Finish to exit the Setup Wizard
    Screenshot_2021-12-15_at_00.45.43-20211214-234548.png

 

info_icon_zendesk.pngAfter the migration you will notice that the Liso devices have lost connection to Humly Control Panel. Also, you will only be able to reach Humly Control Panel using localhost:3002 on the computer or virtual machine where you migrated and installed Humly Control Panel.
Both of these can be easily fixed by replacing the self-signed certificate and key with the signed certificate and key that you made a copy of before beginning the migration (Copy server certificate and key).

 

Replace self-signed certificate and key

  1. On the computer or virtual machine where you did the migration and installed Humly Control Panel, open services.msc
    Screenshot_2021-12-06_at_12.43.38-20211206-114343.png
  2. Find HCP Service and click Stop to stop the service
    Screenshot_2021-12-06_at_12.44.24-20211206-114430.png
  3. Go to the Humly-folder in Windows Explorer and navigate to ControlPanel\application_data\certificates\
    Screenshot_2021-12-06_at_12.46.14-20211206-114620.png
    This screenshot shows the default installation path of the Humly-folder under Program Files, but the path can also be something else since it is customizable during installation of Humly Control Panel.

  4. Make a cut & paste of the self-signed server.crt and server.key file for backup, and paste them somewhere safe where you can easily retrieve them if needed, i.e. the Documents-folder. Don’t paste them in the same folder where you pasted the signed certificate and key prior to the migration!

  5. Now, paste the signed server certificate and key, that you did a copy of before the migration, into the empty certificates-folder under ControlPanel\application_data\certificates\
    Screenshot_2021-12-06_at_12.46.14-20211206-114620.png
    This screenshot shows the default installation path of the Humly-folder under Program Files, but the path can also be something else since it is customizable during installation of Humly Control Panel.

  6. Return to services.msc and Start the HCP Service again
    Screenshot_2021-12-06_at_12.44.24-20211206-114430.png

  7. It can take up to 10 minutes before every Liso is connected again and you can access Humly Control Panel from outside the computer or virtual machine on which it was installed

 

Read more:

Connect a booking system to the Humly Control Panel

HCP Basic Set up - Global Settings 

 

Related articles

Comments

0 comments

Please sign in to leave a comment.