Set up Hideez Client app
Hideez Client App – Setting up Hideez Client
The installation package comes in two forms:
Bootstrapper (.exe)
MSI package (.msi)
You can find the .exe installation file here and .msi installation files here - x86, x64.
Bootstrapper
Bootstrapper is a special application that is used to install prerequisites that are required by the installed application.
The Hideez Client Bootstrapper contains:
Two Hideez Client MSI. One for 32-bit architecture and one for 64-bit architecture
Two C++ 2015-2019 Redistributables. One for 32-bit architecture and one for 64-bit architecture
.NET Framework 4.7.2 web installer
The bootstrapper automatically determines the architecture of the system (32-bit or 64-bit) and installs the respective components without the need for user input on the matter.
Setup interface
You need to select the Enterprise version option and specify the Use Windows 10 Bluetooth option if you will use the built-in Bluetooth or Use an external Hideez dongle if you will be using the dongle.
To proceed with the installation, check the I agree to the license terms and conditions checkbox.
IMPORTANT: Please, notice that Internal Bluetooth option is supported only for Windows 10 version 1903 (2019) and later. In earlier versions, Hideez Key works only with the Hideez dongle.
After Client installation you need to enter HES address at the 'Settings' section.
And save it by clicking the 'Save' button.
Then server indicator becomes yellow and you will need to approve workstation on HES.
MSI Package
Installation from an MSI file does not install additional components. They must be installed separately, but the MSI file can be used in automatic installation scripts.
System modifications by MSI package
During installation the package will make the following modifications to the system:
Application is installed under the following path %ProgramFiles%\Hideez\Client\
A new registry key is created under HKLM\SOFTWARE\Hideez\Client
A registry value client_hes_address (type REG_SZ) is created under HKLM\SOFTWARE\Hideez\Client and contains Hideez Enterprise Server address
A custom Hideez CSR driver is installed on all compatible devices
A new folder is created in the following location %ProgramData%Microsoft\Windows\Start Menu\Programs\Hideez and contains a shortcut to the Hideez Client executable file
A registry value Hideez Client is created under HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Run and contains a path to the application executable file clientsetup.exe from the installation folder
The application is added to the Programs and Features table in Windows
If installed using Bootstrapper, the entry is called Hideez Client
If installed using MSI, the entry is called Hideez Client Update <version>, where <version> is changed based on assembly version
If Hideez Client application is running during the installation process, the installer will try to stop services and client application without asking for additional user input.
Both installation options (Bootstrapper and MSI package) support the transfer of parameters from the command line:
| Parameter | Function | Default value | Constraints |
|---|---|---|---|
SERVERADDRESS | Specifies a Hideez Enterprise Server address to which an installed application will try to connect to. | Empty string | The specified value must be a well formed URL string |
INSTALLDONGLEDRIVER | Specifies if the installer package should additionally install a driver for CSR bluetooth adapters. 0 -Do not install driver 1 - Install driver | 0 | The specified value must be either 1 or 0 |
USEWIN10 | Specifies if Windows 10 Bluetooth support should be enabled 0 - Windows 10 Bluetooth support is disabled 1 - Windows 10 Bluetooth support is enabled | 1 | The specified value must be either 1 or 0 |
USEHDONGLE | Specifies if external Hideez Dongle support should be enabled 0 - External Hideez Dongle support is disabled 1 - External Hideez Dongle support is enabled. | 0 | The specified value must be either 1 or 0 |
ENTERPRISE | Specifies if application should be installed in Enterprise mode. 0 - Standalone mode 1 - Enterprise mode | 0 | The specified value must be either 1 or 0 |
The parameters are not mandatory. The installation can be performed without specifying parameters.
Example of setup with parameters
MSI
The following line is executed from the command line terminal:
The execution of this line will result in the installation of the application and custom bluetooth driver. The installed application will then try to connect to the Hideez Enterprise Server at the following address: http://192.168.10.249/
Note: For the quiet (silent) installation, the command must be executed with administrator permissions.
Bootstrapper
The following line is executed from the command line terminal:
The execution of this line will result in the installation of the application and custom bluetooth driver. The installed application will then try to connect to the Hideez Enterprise Server at the following address: http://192.168.10.249/
Last updated
