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 document describes how to install the license expiration utility alone, out of the Toolkit so that it can be used on servers running Charon-AXP, Charon-VAX,Charon-SSP or Charon-PAR.

This document relates to license expiration utility version 2.6 dated Jun 5, 2023 .

 All described operations have to be performed on the Charon server and logged in as 'root' (no other user supported).

Before installing the license expiration check utility, please verify the hasp_srm_view executable path is known.

If Charon-AXP or Charon-VAX is installed, the PATH is already known thanks to the /etc/profile.d/charon.sh file. It usually contains:

If Charon-SSP is installed, the PATH is not defined by default. This file must then be created manually with the following lines:

If Charon-PAR is installed, the PATH is not defined by default. This file must then be created manually with the following lines (example with Charon-HPA installed in /opt folder):

 This has to be done once. On next login, the file will be automatically executed and the path correctly set.

 To verify the path to hasp_srm_view is known, use the following command:

If a file name is not returned with its full path:

• check the $PATH value contains the path to the hasp_srm_view executable file (this can be done by running "echo $PATH") or

• execute the charon.sh file as mentioned above.

The Mail service must have been configured. The Mail transfer agent can be postfix, sendmail, ...

To download the utility, you must issue a request via email to the Stromasys support team (support@stromasys.com) or ask your reseller.

The utility is provided in a tar file that must be extracted into the /opt/charon/utils folder. If this folder does not exist, you can create it this way then copy the tar file to this folder:

Extract the files from the tar file to the Charon installation directory, subdirectory ‘utils’:

Execute the installation script:

The setup script will:

• Verify the required packages are installed (at, bc, lsusb, ...),

• Create the crontab file and/or add the necessary entries: by default the expiration check is scheduled at 1 AM and 9 AM each day and will send an alert 15 days before expiration,

• Ask to fill the recipients list in case an alert has to be sent,

• Ask for the email mode, text or html (default),

• Ask if a test email has to be sent,

• Will display information on how to check the script is working correctly and how to force an alert