Sentinel^® LDK and Sentinel HASP^® Run-time Environment DEB Installer for Linux: Readme

Version 2.4.1

March 2014

This document describes installation of the Run-time Environment for Sentinel LDK and Sentinel HASP, using DEB under the supported Ubuntu and Debian operating systems. ("Sentinel LDK" is the next generation of the Sentinel HASP system.)

The following topics are discussed:

Operating Systems Supported
Changes in Terminology
Uninstalling the Earlier Run-time Environment
Installing the Run-time Environment
Uninstalling the Run-time Environment
Upgrading HASP HL Key Firmware
Known Issues - Run-Time Environment

Operating Systems Supported

Ubuntu Server 10.04.4, 12.04.3 (x86 and x86_64)
Ubuntu Desktop 12.04.3 (x86 and x86_64)
Debian 6.0.8 (x86 and x86_64)

The latest service packs and security updates must be installed.

Issues Resolved in This Release

Reference	Description
LDK-4284	When installing a license on a system with slack space size less than (number of sectors * 1024), the error "Failed to mount fridge" (HASP_DEVICE_ERR) error would occur.
LDK-4554	The use of hasp_update to install a V2C required that the user press <Enter> during the process.
LDK-4059	The Run-time Environment now uses a new set of rules that is more compatible with modern distribution. The HASP4 hasp(HaspCode) API would fail when using the existing 80-hasp.rules.

Changes in Terminology

Sentinel Admin Control Center user interface and help files incorporate changes in terminology as follows:

The Sentinel HASP product is now referred to as Sentinel LDK.
SL keys that were created with Sentinel HASP Business Studio now appear in the user interface as "SL-Legacy" keys.
References to Sentinel EMS in the help files are also valid for Sentinel HASP Business Studio.

Uninstalling the Earlier Run-time Environment

An existing installation of the Run-time Environment cannot be upgraded. Before installing the new Run-time Environment, uninstall the existing Run-time Environment (if present).

An existing Run-time Environment that was installed using the Run-time Environment installation script (dinst) does not have to be uninstalled.

Installing the Run-time Environment

Perform the following steps to install the Run-time Environment for Sentinel LDK or Sentinel HASP:

(For x64 distributions) Manually install the 32-bit support libraries (x86 compatibility packages) provided by your Linux distribution. For example: For Debian or Ubuntu, use the command:
apt-get install ia32

Note: You can use the script install_32bit_compatibility_package_for_x64.sh to install 32-bit support libraries. You can download this script from the Sentinel Customer Community Downloads page.

Disconnect your HASP HL key (if any) from the computer.

Open a terminal window and navigate to the directory containing the downloaded installation file.

As root, enter the following command:
- For Ubuntu 32-bit or Debian 32-bit:
  dpkg -i aksusbd_2.4-1_i386.deb
- For Ubuntu 64-bit or Debian 64-bit:
  dpkg -i --force-architecture aksusbd_2.4-1_i386.deb

Reconnect the HASP HL key.
Note: At this point, for older HASP HL keys, the firmware on the HL key may be automatically upgraded. During the upgrade process, the key will blink continuously. Do not remove the key while it is blinking. If you remove the key too soon, the key may no longer be visible in Admin Control Center. If the key is not visible, or if the upgrade does not occur, refer to "Upgrading HASP HL Key Firmware" below.

Uninstalling the Run-time Environment

Do the following if you want to uninstall the Run-time Environment:

Enter the command: sudo dpkg -r aksusbd

Upgrading HASP HL Key Firmware

The HASP HL Key Firmware has been modified to support future planned security enhancements in Sentinel LDK and Sentinel HASP. Sentinel LDK and Sentinel HASP automatically upgrade the Firmware on HASP HL keys from v.3.21 to the latest version (v.3.25). This occurs:

when a HASP HL key with v.3.21 Firmware is present on a computer where the Run-time Environment is being updated to v.1.14 or later.
when a customer connects a HASP HL key with v.3.21 Firmware to a computer where the Run-time Environment v.1.14 or later has been previously installed.

(You can determine the Firmware version of your HL key by viewing the key on the Sentinel Keys page of the Admin Control Center.)

For HL keys with Firmware earlier than v.3.21, the upgrade does not occur automatically. Customers can upgrade the Firmware to v.3.25 by applying the Firmware Update V2C provided on the Sentinel HASP or Sentinel LDK Installation DVD v.5.0 and later.

During the Firmware upgrade, the relevant key will start to blink. Do not remove the key while it is blinking. If you remove the key too soon, the key may no longer be visible in Admin Control Center.

Note: In the event the key is no longer visible using the Linux Run-time Environment, do the following on a Windows computer:

Install the Run-time Environment using the enclosed installer script.
Connect the HL key.
Run the application FirmwareUpdate.exe, located on the DVD in \Windows\Installed\Redistribute\Firmware Update\.

The HL key is upgraded to v.3.25 Firmware and will now be visible in the Linux Admin Control Center.

Known Issues - Run-time Environment

Reference	Description
140898	Under the Linux operating system, Sentinel License Manager does not support the IPV6 network protocol.

DocID 154i Revision 1403-4

Sentinel® LDK and Sentinel HASP® Run-time Environment DEB Installer for Linux: Readme