This section identifies the log files relevant for Charon licensing operation.

Charon Emulator Log File

The configuration of each Charon emulator instance contains the definition and location of an emulator log file, which contains important information about the emulator's activities. It also contains information about which license was found and error messages, for example if a license was removed. The log files are text files and can be viewed using a text editor.

Please note:

For a full description of configuration parameters pertaining to log files, please refer to the respective user's guide of your Charon product.
For the actual location of the emulator log file, check the emulator configuration.
For some hints regarding monitoring tools, please refer to Monitoring Licenses.

Default Log File Location on Linux

If the log file location is not specified explicitly in the configuration, the default log file location on host-based Charon emulator products is as shown in the table below:

Charon Product Default Log file Location

Charon-AXP/VAX If the setting of the template configuration is used: directory from which the emulator instance was started.

Charon-SSP If instance was created using Charon-SSP Manager:
/opt/charon-agent/ssp-agent/ssp/[sun-4m|sun-4u]/<configuration-name>/

Charon-PAR

The default location of the log file is the directory in which the emulator is started. Filename format:

Old versions:

hppa_log-<date-and-time>-000000000.log

New versions:

charon-par.<date-and-time>-0000.log

Default Log File Location on Windows

Charon-AXP/VAX/PDP Product

Version

As Service

Log File Location

< 4.8

Yes

Log files are stored in the home directory of the service.

< 4.8

No

The log file is stored in the same directory as the configuration file of the Charon instance.

>= 4.8

Yes

The log file is stored in the home directory defined when creating the Charon instance via the Virtual Machines Manager.

(The Virtual Machines Manager always starts an emulator instance as a service.)

Charon-AXP/SMA Product

There is no default. The parameter must be specified when an emulator instance is created.

Examples

The following shows the license related log entries at the startup of Charon-AXP for Windows versions up to version 4.8:

20160809:175757:INFO :0:000003BA:ll_sentine( 725): Looking for a license key ...

20160809:175801:INFO :0:000003DC:ll_sentine( 820): ... found license key 527889790.

20160809:175801:INFO :0:00000350:ethane.cxx(2697): CHARON-AXP (AlphaServer DS15), V 4.7 B 17101, Sep 18 2015 / 1000.826 / 527889790

20160809:175801:INFO :0:00000336:ethane.cxx(2724): The end user of this software has agreed (...)

20160809:175801:INFO :0:0000009D:ethane.cxx(2801): License info:

CHARON product code: "CHAXP-470xx-WI-LI".

Licensed to: "Stromasys - User1".

Date limited license, limited to: 12/Jan/2017 00:55:00.

Warning: setting the host system date back will permanently invalidate the license key.

License KEY driver is installed as hasplms and is running.

Executable "C:\Windows\system32\hasplms.exe", version 17.0.1.48248.

The following shows a periodic license check on the same system after the license has been removed:

20160809:185509:INFO :0:000003E6:ll_sentine(1820): Performing regular license check ...

20160809:185509:ERROR:2:000003E8:ll_sentine( 379): Sentinel HASP RunTime Error 7.

20160809:185509:INFO :0:00000351:ethane.cxx(3056): session: Detected removal of the license.

Normal operation is supported for 59 minutes from now.

And the following shows another periodic license check where the license is present again:

20160809:195505:INFO :0:000003E6:ll_sentine(1820): Performing regular license check ...

20160809:195508:INFO :0:000003DC:ll_sentine(1913): ... found license key 760119089.

20160809:195508:INFO :0:0000039D:ethane.cxx(2970): License detected and online.

20160809:195508:INFO :0:0000009D:ethane.cxx(2989): License info:

Please note: the system used to collect the examples above has two USB dongles installed. You can see that in the first sample Charon-AXP selects one of the dongles and in the last example it selects the other one, because no primary key has been defined.

The log file format in version Charon-AXP/VAX on Windows version 4.9 and above has changed. Below is a sample output showing the removal of a license key:

20180425:215721:WARN :1:0000024D:licenseman(1830): Communication with the license key "527889790" lost.

20180425:225625:INFO :0:00000424:ethane.cxx(3514): session: Detected removal of the license.

Please note that the configuration parameter log_repeat_filter is set to on by default for Charon-AXP/VAX on Windows. To receive all messages, this parameter must be set to off in the emulator configuration file. This will create a more detailed output as shown below. In particular, it shows the grace period after which the emulator will stop:

20180612:132038:WARN :1:0000024D:licenseman(1830): Communication with the license key "879642840" lost.

20180612:132438:INFO :0:0000024D:licenseman(1823): Performing regular check of the current license.

20180612:132438:WARN :1:0000024D:licenseman(1830): Unable to log in to the key "879642840", feature 0.

20180612:132438:WARN :1:0000024D:licenseman(1830): HASP runtime (7): Sentinel protection key not available.

20180612:132438:WARN :1:0000024D:licenseman(1830): Failed to login at the Sentinel HASP key: "879642840".

20180612:132438:WARN :1:0000024D:licenseman(1830): Connection to license key:"879642840" id:"1002922" lost.

Application will stop at 13-Jun-2018 01:24:38.

20180612:132438:INFO :0:00000424:ethane.cxx(3514): session: Detected removal of the license.

Please note: the format of the log files is different for the various Charon emulator products, but they provide very similar information.

The following shows the log entries of a Charon-SSP instance on Linux for a situation similar to above (emulator start, license missing at periodic check and found again at next check):

2017-02-17 14:27:36 INFO License Found new license key (ID: 527889790).

2017-02-17 14:27:36 INFO License The license key is physical key.

2017-02-17 14:27:36 INFO License Customer name: "Stromasys"

2017-02-17 12:27:15 WARNING License License key 527889790: Unable to locate any Feature matching scope!

2017-02-17 12:27:17 WARNING License Regular license key (ID: 527889790) doesn't exist/match, skipped.

2017-02-17 12:27:19 WARNING License License key 760119089: Unable to locate any Feature matching scope!

2017-02-17 12:27:21 WARNING License Backup license key (ID: 760119089) doesn't exist/match, skipped.

2017-02-17 12:27:23 ERROR License There is no valid license key.

2017-02-17 12:27:25 WARNING License CHARON will be shutdown within 120 minutes!

2017-02-17 14:27:36 INFO License Found new license key (ID: 527889790).

2017-02-17 14:27:36 INFO License The license key is physical key.

2017-02-17 14:27:36 INFO License Customer name: "Stromasys"

System Log Files

System Log File on Linux

On systems using systemd, which uses the journald utility to log messages, the messages for the Sentinel runtime software (aksusbd) can be viewed using the journalctl command.

On systems using syslog or a variant thereof the Sentinel messages can be found in the file /var/log/messages.

The following is an example for Sentinel runtime messages logged via journald showing the aksusbd startup and the adding and removing of a HASP dongle.

Aug 10 20:27:01 host1 aksusbd[1357]: Starting AKSUSB daemon: [ OK ]

Aug 10 20:27:01 host1 aksusbd[1389]: loaded, daemon version: 2.5.1.46317, key API (USB) version: 3.88 (...)

Aug 10 20:27:01 host1 aksusbd[1357]: Starting WINEHASP daemon: [ OK ]

Aug 10 20:27:01 host1 aksusbd[1357]: Starting HASPLM daemon: [ OK ]

Aug 11 16:07:02 host1 aksusbd[16559]: aksusbd_usb_dev_remove: device '/dev/aks/hasp/1-6.3'

Aug 11 16:07:02 host1 aksusbd[1389]: registerHASPDevices: pipe read() failed: 20, Success

Aug 11 16:07:03 host1 aksusbd[16569]: aksusbd_usb_dev_remove: device '/dev/aks/hasp/1-14.2'

Aug 11 16:07:03 host1 aksusbd[1389]: registerHASPDevices: pipe read() failed: 21, No such device

Aug 11 17:07:24 host1 aksusbd[22376]: aksusbd_usb_dev_connect: device '/dev/aks/hasp/1-14.2'

Aug 11 17:07:24 host1 aksusbd[1389]: registerHASPDevices: pipe read() failed: 21, No such device

Aug 11 17:07:30 host1 aksusbd[22409]: aksusbd_usb_dev_connect: device '/dev/aks/hasp/1-6.3'

Sentinel Runtime Driver Log Files

You can enable access and error logging in Sentinel ACC. Please refer to the following article: Enabling logging in Sentinel Admin Control Center.