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:
- License Viewer, License Updater, and License Manager in the Tools > License 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 VPC licenses. Please ignore them if you have a VPC license.
Actions that can Invalidate a License
Cloud environment:
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 instance type (AWS) or shape (OCI) of the license server system
- Changing the CPU number and 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
- Running the C2V program again after having installed a valid license
VMware environment:
A VPC license server in an ESXi environment is currently tied to the hardware of the ESXi host. The license server can be installed on the same VM as the Charon-SSP software or on a different VM, but both must be on the same ESXi host. Moving the license server to a different ESXi host will currently invalidate the license. This will change in future versions.
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:
2020-01-16 11:24:38 WARN License 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 version.