Contents

General Information

The software required to manage and use HASP licenses for Charon is included in every Charon emulator kit. It consists of

• the license drivers (the Sentinel HASP runtime software),
• and additional management utilities.

There are two installation scenarios:

• If you plan to run a Charon emulator product on a system, follow the installation steps listed in the respective user's guide (see Documentation). The user's guide of your emulator product will also lead you through the installation of the license drivers and the license management software. As part of the documentation for each Charon emulator product, you will also find a release notes document. The release notes contain important information about new features and restrictions of specific versions.
• If you plan to use a system as a license server without running a Charon emulator product, you can also install a full product package. As an alternative, the license-specific components can be extracted from the Charon emulator kit and installed separately (Linux), or they can be installed using the Charon License Utility (Windows).

The following sections provide more detail on the license-specific packages included in the respective Charon emulator kits for Linux and Windows.

Please refer to the respective product user's guides for full details on how to install these packages (see Documentation) or the full Charon emulator product.

Important information for software upgrades:

• Upgrading to new versions of Charon products requires a license update. Please contact your VAR or Stromasys representative to plan the update.
• Additional information for software licenses: new versions of Charon products contain a new Sentinel license runtime version 7.63 or higher provided by the license vendor (aksusbd package). The new version contains important updates. However older software licenses are not compatible with the new version. Upgrading to the new version of the runtime software in most cases requires the installation of a new software license (instead of just an update).

• Downgrading to an older license runtime version from version 7.63 or later can also cause the invalidation of a software license.

• Before an upgrade to the newer Sentinel runtime version, contact your VAR or Stromasys representative to discuss the best way to upgrade.

• A product upgrade may also contain changes to the HASP licensing components impacting compatibility between newer emulator products and license formats created for older products. This is not a frequent occurrence, but please always check the release notes for possible caveats.

Please note: To avoid unexpected problems, do not use any Sentinel runtime software that was not provided by Stromasys without being advised to do so by your Stromasys representative.

License Drivers in Standalone Mode on Linux

This section describes the necessary steps to install the Sentinel HASP runtime software and additional management utilities on a Linux system without installing a complete emulator product. This involves extracting the license specific packages from a full product kit and install them on your Linux system.

Sentinel HASP Runtime Packages in Charon Product Kits for Linux

All Charon product kits contain the necessary licensing software components. Below, you find an overview of these components for all Linux-based Charon products.

• If you plan to install a complete Charon emulator product, please consult the appropriate user's guide on the Stromasys Documentation page.
• If you plan to install the Charon license drivers on a system that will not host emulator products, you can install the full product or just use the license-specific packages contained in the complete product kit. Their installation is also described in the product-specific user's guides.

Even though every Charon emulator product kit contains the license specific software components, the packaging is not exactly the same for all products.

The following table provides an overview of the relevant packages in the individual kits at the time of writing:

• The aksusbd package contains the aksusbd and hasplmd daemons which make up the runtime environment. If packaged with the Charon-SSP kit, it also contains the required haspvlib libraries.
• Charon-AXP/VAX: the charon-license package contains the hasp_srm_view and hasp_update utilities and the required haspvlib libraries.
• Charon-SSP: the charon-agent-ssp package contains the hasp_srm_view and hasp_update utilities.
• Charon-PAR: the license management utilities and the required haspvlib libraries are included in the Charon-PAR emulator RPM.

The above packages can be installed independently of the overall product to provide the Sentinel HASP runtime environment (standard RPM package installation; prerequisite for *.i586 and *.i386 packages: glibc.i686).

Please note: the Charon-SSP packages containing the licensing software components are not recommended for a standalone installation because they also contain SSP-specific additional functionality that would need to be disabled for a standalone installation.

Installation Overview for License Packages on Linux

If the Charon license is a network license (red USB dongle or software license), you can either connect it to the Charon host USB port (to use it locally and provide it to other hosts on the local network at the same time) or to install it on a dedicated network license server that will serve the license to license clients.

Basic installation steps overview for a standalone installation (example based on the Charon-AXP/VAX packages):

• Copy aksusbd*.rpm and charon-license-<version>.x86_64.rpm (see above) to the system on which they will be installed, for example to /tmp.
• Login as "root" on the server.
• Switch to the directory containing the packages.

• Install the RPM packages using yum (RHEL/CentOS 7.x) or dnf (RHEL/CentOS 8.x).
  Example:
  # cd /tmp
# yum install aksusbd*.rpm charon-license-*.rpm

• If using an USB dongle, connect the dongle to one of the available USB ports of the license server.
• If using a Software License, create a fingerprint of the license server system.

Please refer to the the respective product user's guides for a complete description of the prerequisites, the installation steps, and the supported Linux versions and distributions.

License Drivers in Standalone Mode on Microsoft Windows

This section provides an overview of the necessary steps to install the Sentinel HASP runtime software on a Windows system without installing a complete Charon emulator product.

The recommended tool for installing the standalone license drivers on Microsoft Windows is the CHARON on Windows - Charon License Utility.

Charon License Utility for Microsoft Windows

Previously, this involved  extracting the license specific packages from a full product kit and install them on your Microsoft Windows system.

Now, Stromasys provides a Charon License Utility. It is highly recommended to use this utility instead of the manual method. The Charon License Utility provides the following functions:

• Install/Uninstall Sentinel LDK License Manager (driver and service)
• Open the Sentinel Admin Control Center
• Display license content (also via RDP connection),
• Update license utility
• Start/stop Sentinel LDK License Manager service
• Easy software license removal

The Charon License Utility is available free of charge and available for download from Stromasys. Please contact your Stromasys representative if you need information about the download link.

The following sections are retained for information purposes. However, it is no longer the recommended way of installing the standalone license drivers on Windows.

Deprecated Standalone License Driver Installation Method

Sentinel HASP Runtime Packages in Charon Product Kits for Windows

All Charon product kits contain the necessary licensing software components. Below, you find an overview of these components.

• If you plan to install a complete Charon emulator product, please consult the appropriate user's guide on the Stromasys Documentation page.
• If you plan to install the Charon license drivers on a system that will not host emulator products, you can install the full product or just use the license-specific packages contained in the complete product kit. There installation is also described in the product-specific user's guides.

The license driver components for a standalone installation are provided in the Charon-AXP and Charon-VAX product kits for Windows in separate zip-files included in the installation kit. These files can be extracted and used to install the license driver components on a system that does not need the full Charon product installation, for example on a license server. The installation steps for these license-specific components are described in the respective product user's guide on the Stromasys Documentation page.

License driver components in the Charon-AXP/VAX product kits: 

• Unpack the zip-file containing the Charon installation kit.
• Enter the folder with the unpacked kit.
• Go to the sub-folder hasp_install. It contains the zip-archive with the command-line tool for installing the Sentinel runtime software components. In Charon-AXP/VAX versions before version 4.9, the zip-file is called Sentinel_LDK_Run-time_cmd_line_<version>.zip. In Charon-AXP/VAX versions 4.9 and later it is called haspdinst.zip.
• Charon-AXP/VAX kits starting with version 4.9 have an additional zip-file: hasplib.zip.

Please note:

• The license driver zip-files contained in the Charon product kits for Windows does not contain the additional utilities to view and update licenses. If you need these utilities, either use the RUS_OQEDC and hasp_view programs from the unpacked product kit or install the full Charon product kit.
• Charon-AXP/SMA does not include a separate license driver zip-file.

Installation Overview for License Packages on Microsoft Windows (Deprecated)

If the Charon license is a network license (red USB dongle or software license), it is possible either to connect it to the host USB port (to use it locally and provide it to other hosts on the local network at the same time) or to install it on a local network license server for remote access from this particular host.

If a remote license server is to be used:

• Copy the file "hasp_install\haspdinst.zip" from the CHARON distribution to any directory on the server, for example "C:\Temp".
• Extract the contents of this archive to the same directory.
• Login as "Administrator" on the server and open "cmd.exe" from the "Start" menu.
• Switch to that directory.

• Install the extracted file:
  Example:

  ...> cd c:\temp
c:\temp> haspdinst.exe -fr -kp -nomsg
c:\temp> haspdinst.exe -install -cm

• Copy the file "hasp_install\hasplib.zip" from the CHARON distribution to any directory on the server, for example "C:\Temp".
• Extract the contents of this archive to the same directory.
• Copy the file "haspvlib_68704.dll" to "C:\Program Files (x86)\Common Files\Aladdin Shared\HASP" (in case of x64 host) or "C:\Program Files\Common Files\Aladdin Shared\HASP" (in case of x86 host)
• If using an USB dongle, connect the dongle to one of the available USB ports of the license server.

Please refer to the the respective user's guides for a complete description of the prerequisites, the installation steps and the supported Linux versions and distributions.

Post-Installation Tasks

The following post-installation tasks are strongly recommended to improve security and to enable additional trouble-shooting options:

• Protect remote access to the Sentinel Admin Control center: see Security Settings for Sentinel Admin Control Center
• Enable access and error logging for the license driver: see Enabling logging in Sentinel Admin Control Center