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 11 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 hardware type (called instance type, shape, or size in the different cloud environments) of the license server system
  • Changing the number of CPUs and/or the RAM size 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


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:

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

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



  • No labels