Versions Compared

Old Version 18

changes.mady.by.user W.Erber

Saved on

compared with

New Version Current

changes.mady.by.user W.Erber

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: better title

...

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.

Contents

Table of Contents
excludeContents
stylesquare

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

(warning) 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
classpagebreak


Starting and Stopping the License Server

(warning) 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 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:

Code Block
languagetext
# /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.

Div
classpagebreak


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
languagetext
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
languagetext
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):

Code Block
languagetext
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


Div
classpagebreak


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.

(info) 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
languagetext
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  VE    License   Customer name is Cust1: Stromasys/Testing.
2020-0107-16 1121:3725:3313 INFO  VE     License  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  VE     License  Expiration UTC time: 012020-May-202012-31 15:55:00.


Connection to license server lost temporarily and then restored:

Code Block
languagetext
(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 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  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  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.

(info) 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
classpagebreak


Switch to backup license server:

Code Block
languagetext
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
languagetext
2020-01-16 11:24:38 WARN  LicenseVE  Failed to get data from license server!

(warning) Please 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.

...