Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 14 Next »

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

Contents

Sentinel/Gemalto License Tools not Applicable to VPC License Server

Depending on the Charon-SSP version, Sentinel/Gemalto-specific license tools are still available in Charon-SSP VPC. 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

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

Actions that can Invalidate a VPC License


A VPC 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:

  • 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


Starting and Stopping the License Server

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

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

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

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



<Go to top>

  • No labels


© Stromasys, 1999-2024  - All the information is provided on the best effort basis, and might be changed anytime without notice. Information provided does not mean Stromasys commitment to any features described.