Linux

HES deployment - Linux

To update the HES server for Linux, you have to:

1. Disable the Data Protection on the HES.

2. Update the server using the following instruction.

3. Enable Data Protection again.

Option 1 (using a script)

To update the server, you can use the update.sh script, which is located in the HES directory (/opt/HES default). You can run it either manually or through the web interface (by clicking on the server version). If an update is available, you will be prompted to update the server using a script. If you have changed the location of the server, the name of the service to run, you can manually update the necessary parameters in the script.

The script has the following command line parameters:

--dir - path to HES bin directory. Default /opt/HES

--service - name of HES-service. Default HES

--url - url to download the update file. Default, url will be taken from https://update.hideez.com/hes/build.json

But you can override these parameters. For example, to update HES offline, from the file "linux_x64_latest.tar.gz", located in the user's home directory, you can run the script as follows:

/opt/HES/update.sh --url file://~/linux_x64_latest.tar.gz

or, if the update is on another of your resources: update.ps1 --url https://<your_resource/linux_x64_latest.tar.gz

Option 2 (without using a script)

2.1. Stopping HES Service

  $ sudo systemctl stop HES

2.2. Backup the HES binaries and the configuration file

  $ sudo mv /opt/HES /opt/HES.old

2.3. Backup the Database

• For MySQL database:

The following command will create a copy (dump) of the database hesdb in file hesdb.sql in /opt/HES.old directory:

  $ sudo mysqldump -uroot -p<MySQL_root_password>  hesdb > /opt/HES.old/hesdb.sql

change <MySQL_root_password> with your real password.

• For Microsoft SQL Server database:

The following command will create a backup of the database hesdb in file hesdb.bak in /var/opt/mssql/data directory:

sqlcmd -S localhost -U SA -Q "BACKUP DATABASE [hesdb] TO DISK = N'/var/opt/mssql/data/hesdb.bak' WITH NOFORMAT, NOINIT, NAME = 'db-full', SKIP, NOREWIND, NOUNLOAD, STATS = 10"

2.4. Download a new version of the HES

$ cd ~
$ curl -O https://update.hideez.com/hes/linux_x64_latest.tar.gz
$ tar -xvf linux_x64_latest.tar.gz
$ sudo mv HES /opt/

2.5. Restore the configuration file

  $ sudo cp /opt/HES.old/appsettings.Production.json /opt/HES/appsettings.Production.json

2.6. Restart the HES and check its status

  $ sudo systemctl restart HES
  $ sudo systemctl status HES

  
  ● HES-hideez.example.com.service - Hideez Enterprise Service
   Loaded: loaded (/usr/lib/systemd/system/HES-hideez.example.com.service; enabled; vendor preset: disabled)
   Active: active (running) since Wed 2020-03-25 10:48:12 UTC; 16s ago
 Main PID: 4657 (HES.Web)
   CGroup: /system.slice/HES.service
           └─4657 /opt/HES/HES.Web

Mar 25 10:48:12 hesservertest systemd[1]: Started Hideez Enterprise Service.

After checking that the update was successful and everything works fine, you can delete copies of the database and server:

$ sudo rm -rf /opt/HES.old

If something goes wrong, you can restore the HES server using the following commands

Restore the folder with previous HES version:

$ sudo systemctl stop HES
$ sudo mv /opt/HES.old /opt/HES

Restore the Database:

• For MySQL database:

$ sudo mysql -uroot -p<MySQL_root_password> hesdb < /opt/HES.old/hesdb.sql

change <MySQL_root_password> with your real password.

• For Microsoft SQL Server database:

$ sqlcmd -S localhost -U  SA -Q "RESTORE DATABASE [hesdb] FROM DISK = N'/var/opt/mssql/data/hesdb.bak' WITH FILE = 1, NOUNLOAD, REPLACE, STATS = 5"

then restart HES:

$ sudo systemctl  start HES

As an alternative, you can make updates via a web interface on your HES server

1. Open the HES server.

2. Open section Settings → Parameters on the sidebar → Server Update

3. Type address in the field Service Name (by default “HES.service”)

4. In the section with available updates, Click Update

Note: that way of updating HES available only for servers deployed on Linux