...
| Insert excerpt | ||||||||
|---|---|---|---|---|---|---|---|---|
|
| Div | ||
|---|---|---|
| ||
Emulator Log Examples
The log-file contents differ depending on Charon products and versions as shown in the following examples.
The following Charon-AXP/VAX log file excerpt shows the message written after the license dongle has been removed for Charon-AXP/VAX versions before version 4.9:
| Code Block | |
|---|---|
|
...
| |
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. |
The following Charon-AXP/VAX log file excerpt shows the message written after the license dongle has been removed for Charon-AXP/VAX version 4.12. It shows the 12 hour grace-period introduced in version 4.9:
...
.
| Code Block | ||
|---|---|---|
| ||
20220825:190522:WARN :1:0000024D:licenseman( |
...
1988): Communication with the license key "527889790" lost. |
...
<lines removed>
...
20220825:200323:INFO :0:0000024D:licenseman( |
...
1981): |
...
The following Charon-SSP log file excerpt shows the message written after the license dongle has been removed:
| Div | ||
|---|---|---|
| ||
|
The following Charon-PAR version 1.7.4 log file excerpt show the message written after the connection to the license dongle has been lost or the dongle has been removed:
...
| class | commandline |
|---|
20160927:150512.34743:PDC CHASSIS:0XCE0F State= INITIALIZE
20160927:150619.152882:Device EWA0 (enp6s0) : RX up
20161009:200646.683932:err:Contact with license key lost ...20161009:200646.684279:err:Please reinsert the key within 15 minutes
otherwise emulator will stop.The following Charon-PAR version 1.11 log file excerpt show the message written after the connection to the license dongle has been lost or the dongle has been removed:
| Div | ||
|---|---|---|
| ||
|
Monitoring Tools
Charon-AXP/VAX and Charon-PAR:
The Linux Toolkit provides monitoring functions covering the license-specific log information. For example:
- License connecting/disconnecting (license lost/restored messages and license removal)
- Change of a license
- License expiration warning
- The next version of the Toolkit will also enable monitoring the Sentinel runtime error log
Please refer to Charon Linux Toolkit for more information.
Charon-SSP and in general all Linux-based products:
There are commercial tools that can be adapted to monitor the Charon emulator log files. However, there are also some Open Source tools that can be used (with the proper customization). Two examples are listed below (this does not constitute a recommendation - but is meant to illustrate what may be available in the Open Source area):
- Logwatch
Logwatch is a customizable, pluggable log-monitoring system. It will go through your logs for a given period of time and create a report in the areas that you wish providing the detail that you wish. It is easy to use, but will have to be customized for use with the Charon emulator log files. - Zabbix
A professional comprehensive monitoring tool that can be adapted to most customers' needs. There are also companies providing professional support for customization and implementation.
Additional tools:
- Standalone license expiration monitoring tool. This was originally part of the Linux Toolkit, but is now available for all Linux-based Charon host platforms. More information is provided further below in this chapter.
Monitoring aksusbd Messages in the Linux System Log
The background process aksusbd and hasplmd log their messages via the journald daemon. These logs can be monitored by the Linux Toolkit. Alternatively, they can be extracted using the journalctl command.
Example: to extract messages specific to the aksusbd software for the last five minutes, use the following command:
...
If a dongle had been removed within this time span, the output is similar to the following:
| Div | ||
|---|---|---|
| ||
|
If a dongle is connected, a message similar to the following will be displayed:
| Div |
|---|
|
A journalctl command similar to the one above can be run regularly within a cron-job that sends an alert if the license has been removed. This method of monitoring has the advantage of being independent of different emulator log file formats and the different check periods set for the individual products.
Charon-AXP/VAX version 4.9 and Charon-PAR version 1.10 and newer also show messages corresponding to the journalctl messages in the emulator log file (with a delay of about one minute) that can be captured by log monitoring tool such as logwatch. Below is a sample for the Charon-AXP/VAX product:
| Div |
|---|
|
Please note: If you use Charon-AXP/VAX, the Linux Toolkit can be used to implement this monitoring option.
Charon License Expiration Check
The Charon Linux Toolkit includes a license expiration check utility that can send alert emails, and/or execute a custom script, a specified number of days before the license expires. This utility can be installed in standalone-mode to be used on Charon-AXP, Charon-VAX, Charon-SSP and Charon-PAR without installing the Charon Linux Toolkit.
To download the utility, you must issue a request via email to the Stromasys support team or ask your reseller.
...
Performing regular check of the current license.
20220825:200323:WARN :1:0000024D:licenseman(1988): Unable to log in to the key "527889790", feature 0.
20220825:200323:ERROR:2:0000024D:licenseman(1996): HASP runtime (50): Unable to locate any Feature matching scope.
20220825:200323:WARN :1:0000024D:licenseman(1988): Failed to login at the Sentinel HASP key: "527889790".
20220825:200323:INFO :0:0000024D:licenseman(1981): Checking the available license key "527889790".
20220825:200323:WARN :1:0000024D:licenseman(1988): Unable to log in to the key "527889790", feature 0.
20220825:200323:ERROR:2:0000024D:licenseman(1996): HASP runtime (50): Unable to locate any Feature matching scope.
20220825:200323:WARN :1:0000024D:licenseman(1988): Failed to log in to the Sentinel HASP key: "527889790".
20220825:200323:WARN :1:0000024D:licenseman(1988): Connection to license key:"527889790" id:"1000.826" lost. Application will stop at 26-Aug-2022 08:03:23.
20220825:200323:INFO :0:00000424:licenseman(2068): session: Detected removal of the license. Normal operation is supported till 26-Aug-2022 08:03:23. |
The following Charon-SSP log file excerpt shows the message written after the license dongle has been removed:
|
The following Charon-PAR version 1.7.4 log file excerpt show the message written after the connection to the license dongle has been lost or the dongle has been removed:
|
The following Charon-PAR version 1.11 log file excerpt show the message written after the connection to the license dongle has been lost or the dongle has been removed:
|
Monitoring Tools
Linux Toolkit for Charon-AXP/VAX and Charon-PAR
The Linux Toolkit provides monitoring functions covering the license-specific log information. For example:
- License connecting/disconnecting (license lost/restored messages and license removal)
- Change of a license
- License expiration warning
- The next version of the Toolkit will also enable monitoring the Sentinel runtime error log
Please refer to Charon Linux Toolkit for more information.
Samples of Open Source Tools for Charon-SSP Hosts and other Linux Hosts
There are commercial tools that can be adapted to monitor the Charon emulator log files. However, there are also some Open Source tools that can be used (with the proper customization). Two examples are listed below (this does not constitute a recommendation - but is meant to illustrate what may be available in the Open Source area):
- Logwatch
Logwatch is a customizable, pluggable log-monitoring system. It will go through your logs for a given period of time and create a report in the areas that you wish providing the detail that you wish. It is easy to use, but will have to be customized for use with the Charon emulator log files. - Zabbix
A professional comprehensive monitoring tool that can be adapted to most customers' needs. There are also companies providing professional support for customization and implementation.
Charon License Expiration Check
The Charon Linux Toolkit includes a license expiration check utility that can send alert emails, and/or execute a custom script, a specified number of days before the license expires.
This utility can be installed in standalone-mode to be used on Charon-AXP, Charon-VAX, Charon-SSP and Charon-PAR without installing the Charon Linux Toolkit.
To download the utility, you must issue a request via email to the Stromasys support team or ask your reseller.
Please refer to How-to install Charon license expiration check on a Linux server for detailed installation and configuration instructions.
Monitoring aksusbd Messages in the Linux System Log
The background process aksusbd and hasplmd log their messages via the journald daemon. These logs can be monitored by the Linux Toolkit. Alternatively, they can be extracted using the journalctl command.
Example: to extract messages specific to the aksusbd software for the last five minutes, use the following command:
$ journalctl --since="$(date '+%Y-%m-%d %H:%M:%S' -d '5 minutes ago')" -t aksusbd --no-pager |
If a dongle had been removed within this time span, the output is similar to the following:
|
If a dongle is connected, a message similar to the following will be displayed:
|
A journalctl command similar to the one above can be run regularly within a cron-job that sends an alert if the license has been removed. This method of monitoring has the advantage of being independent of different emulator log file formats and the different check periods set for the individual products.
Charon-AXP/VAX version 4.9 and Charon-PAR version 1.10 and newer also show messages corresponding to the journalctl messages in the emulator log file (with a delay of about one minute) that can be captured by log monitoring tool such as logwatch. Below is a sample for the Charon-AXP/VAX product:
|
Please note: If you use Charon-AXP/VAX, the Linux Toolkit can be used to implement this monitoring option.
Charon-PAR Special Monitoring Options
...
| Parameter | Description |
|---|---|
| hasp_lost_usr_cmd | Runs a user-defined script or a executable if Charon disconnects from current valid license and no other valid license is found. This action is called every hour during the 12 hours grace period (at the end of which Charon-PAR stops unless a license has been found). The script or command started receives three parameters from Charon-PAR: Usage example: |
| license_changed_usr_cmd | Runs a user-defined script or an executable when Charon-PAR disconnects from one license and connects to another for any reason. The script or command started receives four parameters from Charon-PAR: old-key-id, old-product-license-id, new-key-id, and new-product-license-id. Usage example: |
| license_expiration_warning_usr_cmd | Runs a user-defined script or an executable when the license expiration time is within few hours. The default setup is: starting 24 hours before expiration this script is invoked each hour. The script or command started receives three parameters from Charon-PAR: Usage example: |
...
|
Monitoring Tools
Charon Log Monitor
...
for Microsoft Windows
Charon-AXP/VAX/PDP come with the logmond (Log Monitor & Dispatcher) utility. This utility can monitor the emulator log for events indicating that the license has been removed.
Please refer to CHARON Log monitoring on Windows (logmond - OLD version)- Charon Log Monitor. It contains detailed descriptions for using this tool on all supported Charon product versions.
There is no comparable utility for the Charon-AXP/SMA product.
License Expiration Check on Microsoft Windows
Starting with Charon-AXP/VAX/PDP version 4.8 the license expiration check utility is installed with the Charon emulator kit. The details of this utility are described in the user's guides of the Charon-AXP/VAX/PDP for Windows. This section provides a short overview.
...
- If you installed this utility manually before installing Charon-AXP V4.8, the scheduled task will remain unchanged.
- If you remove all Charon emulator products from the server, the scheduled task will be disabled. It will not be deleted.
- For versions prior to Charon-AXP/VAX 4.8 the utility can be installed manually. Please refer to Charon on Windows - Automated License Expiration Check for details on the use of this tool.
...
| Include Page | ||||
|---|---|---|---|---|
|