This section describes some information that could become relevant during the operation of a cloud BYOL license server and the corresponding Charon-SSP emulator products.
Contents
Sentinel/Gemalto License Tools not Applicable to the Cloud BYOL License Server
The Charon-SSP version, Sentinel/Gemalto-specific license tools are available when installing the management packages for the BYOL-capable Charon-SSP emulator packages. These tools 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 licenses. Please ignore them if you have a BYOL license.
Actions that can Invalidate a Cloud BYOL License
A cloud BYOL license server in a supported cloud environment can be moved to a different subnet or zone in the same virtual private cloud environment. It is also possible to backup and restore (to the same instance) the license server data. However, the following actions will invalidate the license:
Starting and Stopping the License Server
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
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.
No valid license installed:
2020-01-10 12:17:19 INFO MAIN Build time: Jan 10 2020 17:22:12 2020-01-10 12:17:19 ERROR License Failed to retrieve license. 2020-01-10 12:17:19 INFO MAIN The program is terminated.
Charon-SSP Emulator Log Files
Log File Location
The default emulator log file location is /opt/charon-agent/ssp-agent/ssp/<architecture/<vm-name>/.
- <architecture> can be sun-4m, sun-4u, or sun-4v.
- <vm-name> is the name of the emulated SPARC system.
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.
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-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 License Virtual hardware model Charon-SSP/4V is licensed. 2020-01-16 11:37:33 INFO License Maximum concurrent instances are limited to 4. 2020-01-16 11:37:33 INFO License Maximum allowed virtual CPU(s) are 4. 2020-01-16 11:37:33 INFO License Maximum allowed virtualized RAM is 8192 MB. 2020-01-16 11:37:33 INFO License Major version number is 4. 2020-01-16 11:37:33 INFO License Minor version number is 1. 2020-01-16 11:37:33 INFO License Expiration UTC time: 01-May-2020.
Connection to license server lost temporarily and then restored:
(License loss detected) 2020-01-13 22:57:53 ERROR License Failed to connect with license server! 2020-01-13 22:57:53 WARN License Charon will be shutdown within 24 hours! (License server connection restored) 2020-01-13 23:57:56 INFO License Found avaliable license, License ID:01.00000002.001.001. 2020-01-13 23:57:56 INFO License Customer name is Cust1. 2020-01-13 23:57:56 INFO License Virtual hardware model Charon-SSP/4V is licensed. 2020-01-13 23:57:56 INFO License Maximum concurrent instances are limited to 4. 2020-01-13 23:57:56 INFO License Maximum allowed virtual CPU(s) are 4. 2020-01-13 23:57:56 INFO License Maximum allowed virtualized RAM is 8192 MB. 2020-01-13 23:57:56 INFO License Major version number is 4. 2020-01-13 23:57:56 INFO License Minor version number is 1. 2020-01-13 23:57:56 INFO License Expiration UTC time: 01-May-2020. 2020-01-13 23:57:56 INFO License The program runtime environment restored, back to normal operation.
The output shows a 24 hour grace-period. If a valid license has not become available by then, the emulator will be stopped.
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 License Failed to get data from license server!
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.