...

This section describes some information that could become relevant during the operation of a VE license server and the corresponding Charon-SSP emulator products.

Contents

Sentinel/Gemalto License Tools not Applicable to the VE License Server

The In Charon-SSP version, the Sentinel/Gemalto-specific license tools and configuration options are available when installing the management packages for the VE-capable Charon-SSP emulator packages. These tools and options are in particular the following:

...

The above tools cannot be used for managing Charon-SSP VE licenses. Please ignore them if you have a VE license.

Actions that can Invalidate a VE License

Starting and Stopping the License Server

Please note: In versions before 1.0.17, the license server can only be started if a valid license is installed.

...

• Starting the license server:     # systemctl start licensed
• Stopping the license server:   # systemctl stop licensed
• Restarting the license server: # systemctl restart licensed

Primary and Backup License Server

General Information

Charon-SSP for VE licenses supports a backup license server to ensure service continuity should the primary backup license server become temporarily unavailable. Backup licenses are typically limited to a certain number of emulator runtime hours.

...

Note the parameters K_TYPE=COUNTDOWN and K_EXPIRED=100. They indicate that this is a backup license with 100 hours of emulator runtime.

Backup License Server Operation

Should the primary license server become unavailable, the emulator tries to connect to the backup license server. If this succeeds, the emulator continues to run without interruption. If no connection to a valid license can be established within 2 hours, the emulator will stop.

...

If the primary license server becomes available again after the emulator has switched to the backup server, the emulator will automatically switch back to the primary server to avoid unnecessary depletion of the backup license runtime hours.

Log Files

Log files provide important information about the operation of the license server and the Charon-SSP software. In case of problems, this is the first place to check.

License Server Log File

Log File Location

The license server log file is stored under /opt/license-server/license_log

The log file is called license.log. At every license server start, a new version of the log file is created and the previous file is rotated to license.log.1. Other existing versions are rotated accordingly.

Log File Samples

Normal startup:

2020-01-16 09:00:43 INFO    MAIN     Build time: Jan 16 2020 10:54:15
2020-01-16 09:00:44 INFO    MAIN     License server is ready to serve.

...

2020-09-08 09:14:1610-02 21:46:29 INFO    MAIN     License server is ready to serve.
2020-10-03 01:31:09 INFO    Server   CHARON-SSP/4U v4.1.3132 has logged in from 127.0.0.1:12886 has been disconnected40704.
2020-0910-0803 0901:1445:3021 INFO    Server   CHARON-SSP/4U v4.1.31 has logined32 from 127.0.0.1:12886.40704 has been disconnected

Charon-SSP Emulator Log Files

Log File Location

The default emulator log file location is /opt/charon-agent/ssp-agent/ssp/<architecture/<vm-name>/.

...

Please note: The log file path can be changed by the user to a non-default value.

Log File Samples

Working license found during emulator start:

...

Please note: The output shows a 2 hour grace-period. This is applicable to Charon-SSP versions 4.1.21 and later. In earlier versions the grace-period was 24 hours. This is no longer needed because a backup license server can now be configured (since Charon-SSP version 4.1.19). If a valid license has not become available before the end of the grace period, the emulator will be stopped.

Switch to backup license server:

...