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

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

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

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

Actions that can Invalidate a VE License

Cloud environment:

...

...

...

...

VMware environment:

...

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.

The license server is a systemd service that is controlled via systemctl:

• 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 license server become temporarily unavailable. Backup licenses are typically limited to a certain number of emulator runtime hours.

The example below shows the output of such a license:

# /opt/license-server/license_viewer 
<<License Viewer>> Current license:
KEYSEC
K_FINGER=123db1ec91a1526c40da028b9e68e5abaadc70c62719af0f6ef1f2cfd2c85bba
K_LICENSE_ID=01.00000001.002.045
K_TYPE=COUNTDOWN
K_EXPIRED=100
K_CUSTOMER=Stromasys/Testing
K_PLATFORM=amazon.aws
K_R_DATE=1593308906
K_INTERVAL=60
KEYEND
PRODSEC
P_NAME=Charon-SSP/4U,Charon-SSP/4U+,Charon-SSP/4V,Charon-SSP/4V+
P_CODE=test
P_MAJV=4
P_MINV=2
P_CPU_NUM=4
P_MAX_MEM=4096MB
P_INSTANCE=4
PRODEND
PRODSEC
P_NAME=Charon-SSP/4M
P_CODE=test
P_MAJV=4
P_MINV=2
P_CPU_NUM=4
P_MAX_MEM=512MB
P_INSTANCE=4
PRODEND

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.

Please note: If you do not have a valid backup license and the primary license server is unavailable for more than 2 hours, make sure to shut down the Solaris guest operating system cleanly before the end of the grace period. Failure to do so may cause data loss or corruption.

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-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.

Client connection log (new in 1.0.28):

2020-10-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.32 has logged in from 127.0.0.1:40704.
2020-10-03 01:45:21 INFO    Server   CHARON-SSP/4U v4.1.32 from 127.0.0.1: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>/.

...

The log file is called <vm-name>.log. At every emulator start, a new version of the log file is created and the previous file is rotated to <vm-name>.log.1. Other existing versions are rotated accordingly. The number of retained files is determined by the log configuration of the emulated SPARC system.

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:

2020-07-16 21:25:10 INFO  VE       Trying to login to license server: 127.0.0.1
2020-01-07-16 21:25:13 INFO  VE       Connected with license server: 127.0.0.1
2020-07-16 1121:3725:3313 INFO  VE     License  Found avaliableavailable license, License ID: 01.0000000200000001.001002.001044.
2020-0107-16 1121:3725:3313 INFO  LicenseVE       Customer name is Waltraud: Stromasys/Testing.
2020-0107-16 1121:3725:3313 INFO  LicenseVE       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:

(License loss detected)

2020-0107-1316 22:5725:5356 ERROR VE     License  Failed to connect with the license server!
2020-0107-1316 22:5725:5356 WARN  VE     License  Charon will be shutdownterminated within 242 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  LicenseVE       Customer name is Waltraud: 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  VE   License    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  LicenseVE       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  LicenseVE       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 24 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 by thenbefore the end of the grace period, the emulator will be stopped.

Switch to backup license server:

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:

The following message is logged in older versions. Newer versions may have a more descriptive error message.

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

In the initial versions of the software, each license server version requires a specific Charon-SSP VPC version. It is planned to introduce an automatic check for compatible protocols and thus more flexibility in a later versionPlease note: The software checks for for compatible protocol versions between license server and emulator software. It logs an error if the versions are not compatible. Compatible versions are required for the emulator to verify the license and to run.