Table of contents

Description

The Sentinel Admin Control Center (SACC) offers the possibility to enable access and error log files. By default, the "Access log" option from the SACC page displays volatile information since the last start of the "Sentinel LDK License Manager" service (hasplms) on Windows or the aksusbd service on Linux, no log is written to disk. Enabling logging helps identifying causes of errors. This can be a license accessed by another host, an invalid software license or a license going into cloned state.

More information is available on the provider's web site: Sentinel Admin Control Center.

Step-by-step guide

Using the graphical user interface

Open the http://localhost:1947 page on the host serving the license(s)* and select the Configuration option from the left pane then select the Basic Settings (default tab):

*: if "Allow Remote Access to ACC" is enabled and firewall settings allow you to do this, you can access the page from another host, replacing "localhost" by the server name or IP address.

You can check the "Write an Access Log File" and decide whether to set up a size limit. Depending on your needs you can include more information like "Remote Request".

The "Error Log File" can provide useful errors related to software licenses for example, like invalid licenses found in the license folder (for Charon, licenses are stored in the "C:\Program Files (x86)\Common Files\SafeNet Sentinel\Sentinel LDK\installed\68704" folder) or the date and time a software license went into cloned state.

Checking the "Write Log Files Daily" option or defining a size limit affects the naming and location of the log files, see chapter Log files below for more. When a size limit is reached, the current log file name will be renamed and a new one will be created.

Click the "Submit" button to validate the changes.

Using command lines

Configuration files location:

Edit the configuration file using your favorite text editor and change one of the following parameters (the example is given based on the settings from the screenshot above):

the file does not exist by default, it is created on first update from the SACC web page. If the file does not exist, you can get one on this page: How-to enable remote connection to Sentinel Admin Control Center without GUI.

Additionally you can set up an automatic deletion of rotated log files by specifying the retention number in the delete_logs_days parameter.

Save the changes and restart the "Sentinel LDK License Manager" service (hasplms) on Windows ( this can be done only is no emulator is running and if the service stop is forced, running emulators will stop too because of service dependencies) or the "aksusbd" service on Linux for the changes to be taken into account ( on Linux, running Charon emulators will not be affected as they have a test and retry mechanism in case access to the license is lost for a short period of time).

Log files

Location

Naming

¹: where YYYY_MM_DD represents year (4 digits), month (2 digits) and day (2 digits)

²: where NNNNN is an incremental number (5 digits) starting with 00001

Error log examples

Invalid license file (here expecting .v2c files):

Cloned license:

Related articles

• Page:
  How-to enable remote connection to Sentinel Admin Control Center without GUI
• Page:
  Enabling logging in Sentinel Admin Control Center
• Page:
  How to force Sentinel LDK License Manager service to restart on failure