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

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 BYOLVE-capable Charon-SSP emulator packages. These tools and options are in particular the following:

HASP Viewer, HASP Updater, and HASP Manager in the Tools > HASP Tools menu of the Charon Manager
The Regular and Backup License parameter in the emulator license configuration section
The command-line tools in /opt/charon-agent/ssp-agent/utils/license

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

Actions that can Invalidate a

...

VE License

Excerpt

A cloud BYOL license server in a supported cloud environment If supported by the cloud provider, the VE license server instance can be moved to a different subnet or zone in the same virtual private cloud environment, as long as the original instance can be moved. It is also possible to backup and restore (to the same instance) the license server data.

However, the following actions will invalidate the license:

Changing the number of CPU cores of the license server system.
Copying the license server data to a different instance
Seriously damaging the root filesystem of the license server system
Re-installing the license server system

Div

class	pagebreak

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 BYOL VE licenses support 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.

Div

class	pagebreak

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:

Code Block

language	text

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.

...

Code Block

language	text

2020-01-10 12:17:19 INFO    MAIN     Build time: Jan 10 2020 17:22:12
2020-01-10 12:17:19 ERROR   License  Failedlicense tois retrievenot licenseavailable.
2020-01-10 12:17:19 INFO    MAIN     The program is terminated.

Switch to backup license serverClient connection log (new in 1.0.28):

Code Block

language	text

2020-0610-2902 1821:08:25 ERROR BYOL 46:29 INFO    MAIN    Failed toLicense connectserver withis theready licenseto server!serve.
2020-0610-2903 1801:0831:2509 INFO  BYOL  Server   Trying to login to license server:CHARON-SSP/4U v4.1.32 has logged in from 127.0.0.1
2020-06-29 18:08:34 ERROR BYOL     Failed to connect with the license server!
2020-06-29 18:08:43 WARN  BYOL     Charon will be terminated within 2 hours!
2020-06-29 19:08:57 INFO  BYOL     Connected with license server: 172.31.40.62
2020-06-29 19:08:57 INFO  BYOL     Found available license ID: 01.00000001.002.045.
:40704.
2020-10-03 01:45:21 INFO    Server   CHARON-SSP/4U v4.1.32 from 127.0.0.1:40704 has been disconnected

Div

class	pagebreak

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:

Code Block

language	text

2020-01-16 11:37:33 INFO  License  Found avaliable license, License ID:01.00000002.001.001.
2020-01-16 11:37:33 INFO  License  Customer name is Cust1.
2020-01-16 11:37:33 INFO  License2020-07-16 21:25:10 INFO  VE       Trying to login to license server: 127.0.0.1
2020-07-16 21:25:13 INFO  VE       Connected with license server: 127.0.0.1
2020-07-16 21:25:13 INFO  VE       Found available license ID: 01.00000001.002.044.
2020-07-16 21:25:13 INFO  VE       Customer name: Stromasys/Testing.
2020-07-16 21:25:13 INFO  VE       Virtual hardware model Charon-SSP/4V4M is licensed.
2020-0107-16 1121:3725:3313 INFO  VE License      Maximum concurrent instances are limited to 4.
2020-0107-16 1121:3725:3313 INFO  VE  License     Maximum allowed virtual CPU(s) are 4.
2020-0107-16 1121:3725:3313 INFO  VE     License  Maximum allowed virtualized RAMmemory is 8192512 MB.
2020-0107-16 1121:3725:3313 INFO  VE    License   Major allowed version number is 4.
2020-0107-16 1121:3725:3313 INFO  VE     License  Minor allowed version number is 12.
2020-0107-16 1121:3725:3313 INFO  LicenseVE       Expiration UTC time: 012020-May-202012-31 15:55:00.

Connection to license server lost temporarily and then restored:

Code Block

language	text

(License loss detected)

2020-0107-1316 22:5725:5356 ERROR License VE       Failed to connect with the license server!
2020-0107-1316 22:5725:5356 WARN  LicenseVE       Charon will be shutdownterminated within 2 hours!

(License server connection restored)

2020-07-16 23:26:01-13 INFO  VE       Connected with license server: 127.0.0.1
2020-07-16 23:5726:5601 INFO  VE  License     Found avaliableavailable license, License ID: 01.0000000200000001.001002.001044.
2020-0107-1316 23:5726:5601 INFO  VE  License     Customer name is Cust1: Stromasys/Testing.
2020-0107-1316 23:5726:5601 INFO  VE     License  Virtual hardware model Charon-SSP/4V4M is licensed.
2020-0107-1316 23:5726:5601 INFO  LicenseVE       Maximum concurrent instances are limited to 4.
2020-0107-1316 23:5726:5601 INFO  VE  License     Maximum allowed virtual CPU(s) are 4.
2020-0107-1316 23:5726:5601 INFO  VE    License   Maximum allowed virtualized RAMmemory is 8192512 MB.
2020-0107-1316 23:5726:5601 INFO  VE  License     Major allowed version number is 4.
2020-0107-1316 23:5726:5601 INFO  VE   License    Minor allowed version number is 12.
2020-0107-1316 23:5726:5601 INFO  VE  License     Expiration UTC time: 2020-12-31 15:55:00.
2020-07-16 23:26:01-May-2020 INFO  VE       Local UTC time: 2020-07-16 15:26:01.
2020-0107-1316 23:5726:5601 INFO  VE     License  The programlicense runtimeis environment restoredverified, back to normal operation.

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.

Div

class	pagebreak

Switch to backup license server:

Code Block

language	text

2020-06-29 18:08:25 ERROR VE     Failed to connect with the license server!
2020-06-29 18:08:25 INFO  VE     Trying to login to license server: 127.0.0.1
2020-06-29 18:08:34 ERROR VE     Failed to connect with the license server!
2020-06-29 18:08:43 WARN  VE     Charon will be terminated within 2 hours!
2020-06-29 19:08:57 INFO  VE     Connected with license server: 172.31.40.62
2020-06-29 19:08:57 INFO  VE     Found available license ID: 01.00000001.002.045.

License Server version mismatch:

...

Code Block

language	text

2020-01-16 11:24:38 WARN  LicenseVE  Failed to get data from license server!

...

Versions Compared

Old Version 21

New Version Current

Key

Contents

Sentinel/Gemalto License Tools not Applicable to the

VE License Server

Actions that can Invalidate a

VE License

Starting and Stopping the License Server

Primary and Backup License Server

General Information

Backup License Server Operation

Log Files

License Server Log File

Log File Location

Log File Samples

Charon-SSP Emulator Log Files

Log File Location

Log File Samples

Page Comparison

Versions Compared

Old Version 21

New Version Current

Key

Contents

Sentinel/Gemalto License Tools not Applicable to the

VE License Server

Actions that can Invalidate a

VE License

Starting and Stopping the License Server

Primary and Backup License Server

General Information

Backup License Server Operation

Log Files

License Server Log File

Log File Location

Log File Samples

Charon-SSP Emulator Log Files

Log File Location

Log File Samples