Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Anchor
TOC
TOC
 
Include Page
KBCOMMON:KB-CSSstyle
KBCOMMON:KB-CSSstyle

...

Charon-AXP/VAX has a configuration parameter to define the number of retries (license_key_lookup_retry). Please refer to the product configuration documentation for more details.

...

The license check on Charon-AXP/VAX/PDP starting with version 4.4 will be successful for a newer license if the major version (for example, the 4 in 4.7) is the same. In version 4.3, the emulator will start, but there are inconsistencies and incompatibilities especially in the associated tools (e.g., hasp_view). Product versions 4.2 and earlier are incompatible with the current license schema.

...

...

License Content

Include Page
PDC:__Include: HASP License Content
PDC:__Include: HASP License Content

...

  • Hardware dongles require the Sentinel HASP run-time (driver) installation before the dongle can be connected to and used by the system.
  • Hardware dongles, apart from HL-MAX dongles, are equipped with a battery and a clock, which makes them independent of the host clock. To keep the battery charged, the dongle should occasionally be The battery is not rechargeable. However, the dongle can use the power provided by the host system while it is plugged in. By doing this, the depletion of the battery can be slowed down. Check the dongle at regular intervals if it is not permanently connected to a system even if it is not currently needed. If the battery becomes completely depleted, the dongle will be permanently unusable and must be replaced. See also: How long does the license USB dongle battery last upon a full charge.
  • Hardware dongles are not suited for running Charon emulator products in cloud environments. Stromasys provides other licensing solutions adapted to virtual environments (Charon VE licenses) for selected products. See Virtual Environment (VE) License Server Documentation.

...

A software license does not require any special hardware but it still requires installation of the Sentinel runtime environment

Important information:

  • 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.
  • Software licenses are best suited for stable environments, because their correct function depends on certain characteristics of the host system. Changing these characteristics will invalidate the license.

    • If the Charon host runs on real hardware, software licenses are by default tightly bound to the hardware for which they were issued. If major hardware characteristics of the system are changed, the license will be disabled.
    • If the Charon host runs in a virtual environment (e.g., VMware), software licenses are normally bound to the virtual machine ID and a set of additional characteristics of the virtual machine. If any of these parameters are changed, the license will be disabled.
    • For a more detailed description of the restrictions, please refer to Software Licensing restrictions or contact your Stromasys representative.
  • Software licenses are very sensitive to even small changes on the host system. Therefore, it is especially important to provide for a backup license that will ensure continued operation should there be a problem with the software license. See See Handling Multiple License Keys for details.
  • Standard software licenses are not suited for running Charon emulator products in cloud environments. Stromasys provides other licensing solutions adapted to virtual environments (Charon VE licenses) for selected products. See Virtual Environment (VE) License Server Documentation.

...

  1. Add a password for the Sentinel Admin Control Center (ACC).
  2. If you purchased a hardware license, you can simply plug the dongle into a free USB port on the system.
  3. If you purchased a software license, you need to create a fingerprint file in C2V (customer-to-vendor) format containing the system characteristics. Use this file to request a license for your Charon product from Stromasys.
  4. If your license is a network license served by a license server, make sure that the access of the client system to the license server is not blocked by the configuration or a firewall.
  5. Optionally, define how multiple licenses will be used (selecting primary/backup license, defining license priorities).
  6. If you have an existing license that needs to be updated, you need to create a customer-to-vendor (C2V) file and use this file to request a license update from Stromasys.

...

To view available licenses using Sentinel ACC, start the web interface as described above.

Please note: starting with Charon-AXP/VAX 4.9 a new Sentinel ACC version (>= 7.60) has been included in the product. The functionality is very similar but the appearance is somewhat different.

o get to the Sentinel Keys screen, click on the corresponding menu item or access the URL http://localhost:1947/_int_/devices.html directly. A screen similar to the following opens and displays the available license keys:

...

  • The option to create a C2V file is not available in older versions of the license software.
  • Starting with ACC version 7.60, the option to create C2V files for USB dongles is only available if it has been enabled in the basic configuration section (under the Configuration menu item).
  • Newer versions of ACC also offer the option to create a fingerprint for a new SW license.
  • Some newer versions of ACC show the option on this screen to create a DEMOMA fingerprint. This is a demo key for development purposes and not relevant for Charon products.
  • Some newer versions of ACC offer to create a fingerprint for a software license if such a license does not exist yet. Do not use this option. The resulting file has a format that is incompatible with the Stromasys license creation tools. Instead use the tools described in Generating C2V and Fingerprint Files Installing the License.

The menu options ProductsFeatures and Sessions on the left-hand side provide the same information as the buttons. However, they show the information for all licenses.

...

If there is more than one license, the data for each license is shown on a separate tab.

Please note: starting with Charon-AXP/VAX version 4.9, the button Charon License Details has been renamed to Refresh current license. The names of some parameters have changed, new parameters were added, and other parameters removed. See the following sample output:

Image Modified


Anchor
LicInst
LicInst
Installing the License

...

A local hardware license (USB dongle) is installed by inserting the USB license key into a free USB port of the host system after the Sentinel runtime software has been installed.

After this step, verify that the license is visible to the system by following the steps for viewing a license as described above. Please bear in mind that a local hardware license cannot be read when connected to the system via a remote connection (e.g., via RDP).

...

Once a software license has been installed, current versions of the license update utility do not allow you to create another fingerprint without (temporarily) removing the installed software license. Therefore, save the created fingerprint file in case you need to create an additional software license for the same system (this will be the exception because in most cases the existing license can be updated with the required information). If you don't have the fingerprint file anymore and cannot create a second fingerprint because there is already a valid software license installed, please contact your Stromasys representative or VAR. If you have an obsolete/invalid software license on your system, you can remove it as described in Removing a License.

Step 2:  Send the resulting fingerprint file to Stromasys orders administration using the email address that Stromasys will provide to you.

...

1. Open a web-browser on the client host and go to the URL http://localhost:1947/_int_/config_to.html
 (option: Configuration / Access to Remote License Managers). 

2. This will open a configuration page similar to the following. Please note: newer Charon emulator products (e.g., Charon-AXP/VAX version 4.9) have newer versions of the Sentinel license drivers. The Sentinel ACC pages of these versions look different, but the functionality remains mostly the same

...

After installing a license on the system, verify the availability of the license as described in the section section View Existing Licenses.

Check if the license shows the correct product, expiration date etc.

...

The following sections describe the options available to achieve a more deterministic license selection. If only one license is available, either locally installed or via the network, this section does not apply.

Please note: for Charon-AXP/VAX before version 4.9 and other older Charon products: the parameters described in this section can only be used to define a primary key and a backup key, or to specify the correct key if there is a conflicting license for a different Charon product on the same system. It is not possible with these versions of Charon to combine a local license (black dongle) with other licenses (local or network) to increase the number of concurrent instances of the same Charon product on one host system. Newer versions allow a more flexible use of multiple licenses. Both variants are described in the following sections.

...

If more than one key is visible to the system, you can define a prioritized list of license keys.  To do this, add the following parameter to the configuration file of the Charon instance:

set session license_key_id = "<key-id prio1>, <key-id prio2>,...[,any]"

The first entry in the list has the highest priority. The emulator instance will try to use this key first. If it is not available, it will try the second key in the list and so on. If the parameter any is added to the end of the list, the emulator instance will search for any keys not part of the list should none of the listed keys be available. If the parameter is not defined, an unqualified search for a suitable license will be performed and the first one found (if any) will be used. If no usable license is found, the emulator will stop.

...

Every license key can contain one or more product sections. Newer licenses can contain a product license ID identifying each product section. A prioritized list of product license IDs can be added to the emulator instance configuration file to specify which product sections to use and which should have the highest priority. To do this, add the following parameter to the configuration file of the Charon instance:


set session license_id = "<lic-id prio1>, <lic-id prio2>,..."

The emulator instance will scan the available license keys for the listed product license IDs. Then it will try to use the first defined product section. If it is not available, it will try the next and so on. If none of the listed product license IDs are found, the emulator will stop.

...

If there is more than one license key available on the system, the tool will allow you to select the appropriate key to update as shown in the screenshot below:

Div
classpagebreak



Step 2:  Send the resulting C2V file to Stromasys orders administration using the email address that Stromasys will provide to you.

...

classpagebreak


Step 3: Step 3: After receiving the V2C file(s) from Stromasys, copy the file(s) to the system where the license needs to be installed, start the license update utility as described above, and install the new license:

...

If a license needs to be removed from a system or the access to the license needs to be disabled, the steps are different for the different license types and are described in the next sections:

  • Removing a

...

  • hardware license from a

...

  • system
  • Removing a

...

  • software license from a

...

  • system
  • Removing

...

  • access to a network license from a system

Important: before removing a license from a system or disabling access to a license, take to following points into consideration:

...

Old version (showing a software license in cloned state):

Div
classpagebreak



New version (showing an active software license and a cloned software license):

...

Example using old ACC version:


Please note: the certificate display screen can look slightly different depending on the type of software license and the actions performed on this license in the past. The following example shows the certificates of a software license after several updates. The screenshot is based on Sentinel ACC version equal or higher than version 7.60.

Div
classpagebreak


5. Remove the certificate file(s) using operating system tools.

...

Please refer to the section Controlling Access to Network License on Client Side in Installing a Network License for more information.

Div
classpagebreak


Manual Sentinel HASP License Driver Installation

This is normally not required as the license drivers are part of the Charon emulator product installation kits. Also, Stromasys provides a license update utility that simplifies this task.

New License Driver Installation

Before installing the license make sure that the Sentinel run-time (driver) to be installed is collected from your Charon kit or provided by Stromasys on request for your particular product. Do not update the Sentinel run-time (driver) from online or any other sources, including the Sentinel web site.

In case of several Charon kits containing different versions of Sentinel run-time (driver), the last one, having the most recent version, must be installed. The Charon installation performs this operation automatically.

At the moment Charon supports Sentinel HASP keys, Sentinel HL and Sentinel Software Licenses (SL).

Installation of a Charon regular or network license consists of:
 

  1. Installation of the Sentinel run-time environment on the Charon emulator host (regular and network keys) or on the host that will distribute Charon licenses over a local network segment (network key only). The Sentinel software is installed automatically by the Charon emulator products for Windows.
  2. Physical connection of the HASP license dongle to the Charon host or to the host distributing the Charon license over the local network segment.
  3. Collecting the system fingerprint (*.c2v file), sending it to Stromasys and applying the update (*.v2c file) in case of software license (and in case of updating HASP dongle license). See the details below.

When a manual installation of the Sentinel run-time is required (in the case of the network license server that does not have a Charon emulator product installed):

  1. Login as Administrator
  2. Open the Charon kit folder
  3. Switch to the hasp_install subfolder
  4. Unzip the archive haspdinst.ziplocated in this folder
  5. Open cmd.exe and switch to the folder where the files were unzipped
  6. Execute the following commands:


    ...> haspdinst.exe -fr -kp -nomsg

    ...> haspdinst.exe -install -cm


  7. Extract the contents of this archive hasplib.zip to the same directory.
  8. Copy the file haspvlib_68704.dll
    to C:\Program Files (x86)\Common Files\Aladdin Shared\HASP" (in case of a x64 host) or
    to C:\Program Files\Common Files\Aladdin Shared\HASP (in case of a x86 host)

Note that the following operations have to be performed when installing a network license:

  • On the server side (where the network license will reside): open port 1947 for both TCP and UDP
  • On the client side, if broadcast search for remote licenses is to be used, UDP traffic from port 1947 of the license server to ports 30000-65535 of the client must be permitted.
  • Both on server and client sides: setup default gateway

Please consult with your Windows User's Guide on details.

If stricter firewall rules are required, it is possible to open the ports 30000-65535 and 1947 only for the Sentinel HASP License Manager (hasplms.exe) service (it will be installed as part of the Charon emulator kit).

Div
classpagebreak


Replacing the Currently installed License Drivers


Replacement of the currently installed Sentinel Run-time can be needed in case of installation of specific run-time provided by Stromasys.

To proceed, remove the current version of Sentinel run-time:

  • Login as Administrator
  • Extract the content of the unique ZIP file residing in hasp_install directory of the Charon distribution to the same folder.
  • Run cmd.exe from the Start menu of host computer
  • cd to the hasp_install directory
  • Issue the following command:
    ...haspdinst.exe-fr -kp -nomsg

Install the new Sentinel run-time:

  • cd to the directory where the target run-time resides
  • Issue the following command:

    ...> haspdinst.exe -install -cm

  • cd to the hasp_install directory
  • Extract the contents of this archive hasplib.zip to the same directory.
  • Copy the file haspvlib_68704.dll
    to C:\Program Files (x86)\Common Files\Aladdin Shared\HASP (in case of a x64 host) or
    to C:\Program Files\Common Files\Aladdin Shared\HASP" (in case of a x86 host).



Include Page
KBCOMMON:KB-GoToTop
KBCOMMON:KB-GoToTop