Contents

Overview of Initial License Installation Steps

Each Charon emulator product requires a valid license to run. To access the license, the emulator needs the Sentinel runtime software. This software is part of the Charon-AXP/Charon-VAX HPA for Linux installation kits. Refer to the software installation section of the Charon product user's guide for software installation instructions.

After the installation of this software, If you have a hardware USB license dongle, simply connect it to the system after the Charon-HPA software has been installed and verify that the license can be installed on the system. The following steps will be described in more detail below:

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 primary and backup license IDs in the Charon configuration file.
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.

Overview of License Management Tools

The following list shows the main tools used to manage licenses on Linux:

• Sentinel Admin Control Center (ACC): A web-based interface providing important configuration options with respect to licenses.
• The hasp_srm_view program: A command-line tool to display the detailed license contents and generate C2V and fingerprint files. Cannot be used over a remote connection when using local hardware licenses.
• The hasp_update program: A command-line tool to install new and update existing licenses.

Accessing the License Management Tools

The command-line tools are installed under /opt/charon/bin/. If this directory is not part of your PATH variable, you have to specify the full path to access the command.

To run the commands, use the following syntax for hasp_srm_view and hasp_update respectively.

...

# /opt/charon/bin/hasp_srm_view <option>

and

# /opt/charon/bin/hasp_update <option> 

The relevant options will be specified with the tasks described below, as needed.

The Sentinel ACC on the local system is accessed by starting a web-browser and pointing it to the URL: http://localhost:1947read correctly by entering the following command:

 Please note that this command must be run from a local connection. If you are connected over a remote connection (e.g., ssh), you will receive an error. 

As a workaround, you can display the license contents with the following command (adapt the path of the command if your installation location is different):

Verify that the license contains the correct product, the correct number of emulator instances, and the correct expiration date (if applicable).

Example:

Details about licensing in general and how to handle licenses in Charon-HPA can be found in the section License Management Overview for Charon-HPA and in the License Handbook. The license chapter contains important information about security and more complicated use cases (for example, multiple license keys, software licenses, and network licenses).