Views:

Product: CENTRAL

Version: 4.7 and Newer

 

Enable Logging for LABEL ARCHIVE and SENTINEL

Important: After enabling logging for LABEL ARCHIVE and SENTINEL, restart the TEKLYNX services.

LABEL ARCHIVE Logging

1. Modify each of the following NLog.config files individually. In each file, locate the following logger configuration:
<logger name="TkxArv.*" writeTo="file" minlevel="Off" />

Change minlevel="Off" to minlevel="Trace".

LABEL ARCHIVE Client:
C:\Program Files (x86)\Teklynx\Label Archive Client\NLog.config

LABEL ARCHIVE Server:
C:\Program Files (x86)\Teklynx\Label Archive Server\NLog.config

LABELNET WebAdmin:
C:\Program Files (x86)\Teklynx\LABELNET WebAdmin\NLog.config

LABELNET WebSite:
C:\Program Files (x86)\Teklynx\LABELNET WebSite\NLog.config

TkxSvrClients:
C:\Program Files (x86)\Teklynx\TkxSvrClients\NLog.config

TkxSvrServers:
C:\Program Files (x86)\Teklynx\TkxSvrServers\NLog.config

2. The LABEL ARCHIVE log files will be created in:
C:\ProgramData\Teklynx\Logs\

SENTINEL Logging

1. In SENTINEL Manager, navigate to Tools and Tracing. Change the tracing level to Highest.

The path displayed in SENTINEL Manager is where the SENTINEL log files will be placed.

2. In Event Viewer, collect the logs from the following sources:
  • Application
  • System
  • LABELNET TEKLYNX
  • SentinelKernelLog
  • TkxSvrService
See the screenshot below for the highlighted log sources.

3. For Versions 2021 and below, Navigate to:
C:\ProgramData\Tki\LicenseManager

Open LicenseManager.ini. Change DbgReport=0 to DbgReport=1. Verify that the path specified by DbgReportPathName= is valid.
4. For Versions 2022 and above, Navigate to:
Program Files (x86)\Teklynx\Network License Manager\Server\appsettings.jso

Set Logging:File:LogLevel:Default value to "Debug".

CODESOFT Logging

1. Navigate to the CODESOFT installation directory:
C:\Program Files (x86)\Teklynx\CODESOFT VERSION

Open Lppa.ini.

2. In Lppa.ini, change DbgReport=0 to DbgReport=1. Verify that the configured log path is valid.

NSP Logging

If NLM uses an NSP license, NSP logs are also written by the dongle module of NLM.

NSP log location:
C:\ProgramData\Tki\NSP\Logs

By default, NSP writes logs only during installation, activation, or deactivation. Runtime logging must be enabled manually by editing the NSP configuration file.

Enable NSP runtime logging:

1. Open:
C:\ProgramData\Tki\NSP\NSP.ini
2. Locate the [General] section.
3. Set:
LogMode=4

Setting LogMode=4 enables NSP runtime logging.

Important: The NSP LogMode setting can be reset automatically. Check LogMode before each test run to make sure runtime logging is enabled and the required NSP logs will be collected.

NSP log files are obfuscated using fixed-key encryption.

Total Logging

The maximum amount of diagnostic information can be collected by enabling the following logging options and performing the test.

Collect maximum diagnostic information:

1. Enable the debug log level for TkxWebLicenseServer.
2. Enable NSP runtime logging.
3. Enable Lppa traces.
4. Restart the TkxWebLicenseServer Windows service.
5. Execute the test.
6. Record the time and actions performed during the test.
7. Collect the contents of the C:\ProgramData\Tki folder on the machine running NLM.
8. Collect the contents of the C:\ProgramData\Tki folder on the machine running CODESOFT.
9. Collect the Lppa trace files. The default location is C:\temp.
10. Collect the Windows Application and System event logs for the period during which the test was performed.
Keywords: SENTINEL Logs; LABEL ARCHIVE Logs; CENTRAL Logs; How to enable logs for TEKLYNX CENTRAL