Installation and licensing an evaluation (Windows)

To view v13.x documentation, go to the top level of the legacy documentation.

This page applies to Harlequin v14.0r0 and later; and to Harlequin Core but not Harlequin MultiRIP.

From Harlequin Core v14, installers are no longer provided. The Harlequin Core SDK is delivered as a compressed ZIP archive.

This page provides step-by-step instructions to install and set up the required LDK components after extracting the ZIP file to your computer.

Prerequisites

Operating system: See Release Notes (Harlequin Core) for supported operating systems.
Processor: See Release Notes (Harlequin Core) for minimum hardware requirements.

Unpacking

Once you have copied the installation package (E.g., Evaluation-shiva-HHR-14.x-win_64-amd64.zip) to your Windows machine, extract it to your chosen installation location. This will result in the chosen folder containing the SDK components and directories needed to run the Harlequin Core.

Licensing

Before running the RIP, you may need to install the LDK runtime and license the RIP. If you have been provided with a license (product) key, do the following:

Installing the LDK runtime

From a command prompt, install the LDK runtime (RTE):

1. Change to the directory <install dir>/LDK/RTE.
2. Run haspdinst.exe -install

You can check this has been successful by opening the link in <install dir>/LDK/Utils or by opening this webpage: http://localhost:1947/_int_/config.html

Activating the product key

Activating from a command prompt

To activate a product key for a new license (SL or VL) from a command prompt:

1. Change to LDK/Utils
2. Run ldkutil -initial <product key> -sl

If successful, ldkutil will report 'Activation successful'.

Activating from the GUI tool

To activate a product key for a new license (SL or VL) using the GUI LDK Tool:

1.  Start <install dir>/LDK/Utils/ldktool.exe
2.  Click More
3.  Click New License
4.  Click License this computer
5.  Click Have internet access
6.  Paste in your product key and click Activate.

When installing Windows LDK-secured HHR, you must install the supplied external License Manager, hasp_rt.exe, in the same directory as an LDK-secured HHR application (either clrip.exe or your own application that links to corelib.dll). Failure to do so results in slow RIP start-up times and possibly other hard-to-diagnose failures.

For more information on LDK see the LDK Guide.

Running clrip.exe

You should now be able to run the clrip test harness, see Running the Harlequin Core with clrip (Linux, macOS, and Windows).

Your LDK protection key ID is displayed in the command line window when running clrip.