Documentation

gitHub

Windows

Standard installation

The application is shipped as a signed .exe file with an installation wizard automatically placing the app in the proper folder and displaying the License Agreement and Release Notes.  Windows installation does not require admin rights (unless the installation is made to a directory requiring admin rights) and does not write to the Windows Registry.  However, in a corporate environment, you should contact your IT department.  They can remotely access your computer and install the software for you.  You should comply with the IT policy on non-approved software.

 

Warning: Do NOT install Hackolade in the AppData directory.  You should select either Program Files, or C:\Hackolade or some other place where you have Write rights.  AppData is for application data, not application programs.

 

Important: do NOT install a new version of Hackolade while the application is running.  All instances of the application must be closed for the upgrade to proceed properly.  Please refer to this page if you get an error such as this one:

Image

 

After downloading the application from our download page, double-click on the downloaded .exe file and the wizard will start.  You will first see the publisher verification dialog letting you check the authenticity of the download signed with Hackolade's parent company NV IntegrIT's extended validation certificate.

 

Image

 

The wizard starts with a Welcome page stating the version number about to be installed

Image

 

You need to approve the License Agreement to proceed:

Image

 

 

A default installation folder is proposed, which may be changed if you wish:

Image

 

Warning: Do NOT install Hackolade in the AppData directory.  You should select either Program Files as suggest, or C:\Hackolade or some other place where you have Write rights.  AppData is for application data, not application programs.

 

After a couple of additional prompt, the installation process will start.  At the end, you will be able to consult the release note, and automatically start the application.

 

The installation program also supports silent mode for command-line installations, with the following arguments:

/SILENT Runs the installer in silent mode (The progress window is displayed)
/VERYSILENT Very silent mode. No windows are displayed.
/SUPPRESSMSGBOXES Suppress message boxes. Only has an effect when combined with '/SILENT' and '/VERYSILENT'.
/NOCANCEL Disables canceling the installation process.
/DIR="x:\dirname" Overrides the default install directory.
   

Example:

Silently install the program, suppress message boxes, and install in a user directory instead of the default.

Hackolade-win64-setup-signed.exe /VERYSILENT /SUPPRESSMSGBOXES /DIR="C:/Users/%username%/Hackolade"

 

Licenses on Virtual Machines (or physical computer accessed via Remote Desktop Installations [RDP] or equivalent)

Important note: installing Hackolade on a central computer (whether on a PC or a server, whether the machine is virtual or physical, and whether on premises or in the Cloud) does not change the terms of our License Agreement.  Specifically, that license metric is per "per seat", and that a license must be obtained for each device on or from which the Product is used or accessed. When the Product is accessed remotely across using Terminal Server, Remote Desktop, Citrix XenDesktop or an equivalent method, a separate Product license is required to be assigned to each device from which the application is accessed, i.e. not the virtual machine on which the Product is installed.

 

Important: before you delete a user login on a VM, or delete an entire VM, make sure to release the Hackolade key(s) via Help > Software Key Validation > Release.  This is the only way for you to free up the seats of that user, and make it available for another one.

 

Reminder: when installing Hackolade on a VM to share among multiple users, it is important to realize that licensing is not attached to just the machine, but to the combination of the machine, where Hackolade is installed, a client workstation identification for the PC accessing the application, and the user login.  As per the EULA: "A license must be obtained for each device on or from which the Product is used or accessed."  

 

Example: having 4 Hackolade users on a single VM is the equivalent of having 4 individual PCs running Hackolade from a licensing point of view: you need 4 license seats to be validated.

 

VM configuration

Hackolade licensing is enforced through registration on our license server of a combination of unique identifiers, including the UUID of the computer where Hackolade is installed, a client workstation identification for the PC accessing the application, and the user login.  Each unknown combination reserves one seat on our license server, until you reach the total number of seats purchased for the submitted license key.

 

While typically Windows installation does not require admin rights, if the directory where the software is to be installed requires admin rights, you may need the intervention of an administrator with elevated rights to execute the installation.  The Hackolade installation should be made for "all users" of the central computer, if given the choice.  Please refer to the section above for instructions on the installation process.

 

Once the software is installed centrally, each user login should be able to access its own instance of the application.  Each user login on the central computer will be required to go through software key validation, following the steps outlined here.

 

Given the way license seats are counted, it is important that identifiers remain stable.  If your IT department configured VM infrastructure differently, it may be required for your IT department to adjust parameters in order to achieve stability.

 

Citrix

ENABLE_DYNAMIC_CLIENT_NAME should be left to YES
Allows client name to be the same as the computer name. When you change the computer name, the client name changes too. 

• Yes (default) – Allows the client name to be the same as the computer name. Example, CitrixWorkspaceApp.exe ENABLE_DYNAMIC_CLIENT_NAME=Yes. 

• No - Does not allow the client name to be the same as the computer name. You must specify a value for the CLIENT_NAME property. Example, CitrixWorkspaceApp.exe ENABLE_DYNAMIC_CLIENT_NAME=No

 

Additional resources:

https://docs.citrix.com/en-us/receiver/windows/4-9/install/cfg-command-line.html#identify-a-user-device

https://docs.citrix.com/en-us/receiver/windows/4-9/install/cfg-command-line.html#dynamic-client-name

 

 

VMWare

As per this VMWare article, setup should generally be OK:  "Each virtual machine has a universal unique identifier (UUID). The UUID is generated when you initially power on the virtual machine...  Suspending and resuming a virtual machine does not trigger the process that generates a UUID...  If you do not move or copy the virtual machine to another location, the UUID remains constant."  

 

If it is not the case, maybe instructions in this article will help your IT department configure appropriately