Windows
Migration from 3.10 (or less) to 3.11 (or up) requires additional steps because we have significantly improved the data protection mechanism - now it is built on certificates and doesn't require entering the password manually on server start. Please follow these steps to update your HES:
Update all Hideez Clients to 3.11, the new version can work with both old and new versions of the HES.
Disable the Data Protection on the HES.
Update the server using the following instruction.
Install the Hosting Bundle for .Net 6.0.
If you are using IIS, update its configuration using the parameters below.
Enable Data Protection again.
IIS Configuration
Go into the IIS Manager
Click on Application Pools (on the left)
Right click on your application pool
Select Advanced Settings
General
Change the value of .NET CLR Version to No Managed Code
Process Model
Change the value of Idle Time-out (minutes) to 0
Change the value of Load User Profile to True
Recycling
Change Regular Time Interval (minutes) to 0
1. Backup the HES binaries and the configuration file
Stop the site using the IIS console
rename binary folder
C:\Hideez\HES
toC:\Hideez\HES.old
2. Backup SQL Database
For MySQL database:
The following commands will create a copy of the database in file hesdb.sql
in directory C:\Hideez\HES.old
(in poweshell console):
You will need to enter the MySQL root password. Database name hesdb
may be different for you depending on how you have named it on install.
For Microsoft SQL Server database:
In the SQL Server Management Studio:
Right click on the database name Select Tasks > Backup Select "Full" as the backup type Select "Disk" as the destination Click on "Add..." to add a backup file and type C:\Hideez\HES.old\hesdb.bak
and click "OK" Click "OK" again to create the backup
3. Download and install the latest HES
Download the zip file from https://update.hideez.com/hes/windows_x64_latest.zip, then unzip its content to the folder C:\Hideez\HES
.
4. Restoring the configuration file
Copy C:\Hideez\HES.old\appsettings.Production.json
to C:\Hideez\HES\appsettings.Production.json
in the File Explorer
5. Starting the HES
Start the site using the IIS console
After checking that the update was successful and everything works fine, you can delete copies of the database and server
An alternative is to perform the above steps in powershell:
Stopping HES :
Backup database:
MySQL database:
MS SQL database:
Download and install HES:
Start HES:
Delete folder C:\Hideez\HES.old
RESTORE Database:
MySql
MS SQL
If something goes wrong, you can restore the HES server using the following commands:
Stop the site using the IIS console, then rename old folder to HES, then restore database:
For MySQL database:
you will need to enter the MySQL root password. Here hesdb
is the name of your real database
For Microsoft SQL Server database:
In the SQL Server Management Studio:
In the left navigation bar, right-click on Databases
and then click Restore Database
.
In the Source
section, select Devic
e and click the button with three dots and type C:\Hideez\HES.old\hesdb.bak
In the pop-up window that opens, click Add
and browse for your backup file. Click OK
.
In the left navigation menu, click Options
.
In the pane on the right select Overwrite the existing database (WITH REPLACE)
and Close existing connections to destination database
.
Click OK
.
Then start the site using the IIS console.
Last updated