ntlog

Basic Troubleshooting
Platform
Intel® PAC
Napatech SmartNIC
Content Type
User Guide
Capture Software Version
Link™ Capture Software 12.11

You can use the ntlog tool to read the log messages generated by the driver.

Before you begin

  • The driver is loaded.

  • ntservice is started.

ntlog depends on ntservice. In case of for instance configuration errors, ntservice will often be able to enter a service mode that allow you to use the ntlog tool.

If ntservice fails without entering service mode, please refer to Verify Whether the Driver is Loaded and the ntservice Daemon or NTService has been Started.

Error messages

The following is an example of the ntlog output on Linux using the -m option with bitmask 0x001 which displays error messages.

$ /opt/napatech3/bin/ntlog -m 0x001
ntlog (v. 2.10.0.254-a537d)
==============================================================================

>>> Warning: Failed to initialize the API.
>>>          Not able to read low level driver log
>>>          Is the driver loaded?
Log level mask: 0x07
Log display mask: 0xFF
-------------------------+--------+---------+-----+------------+------------------------------------------------------------------
Timestamp                |   PID  | LogType | Src |     Rel    | Log entry
-------------------------+--------+---------+-----+------------+------------------------------------------------------------------
06/28/15 16:53:59.883457 |  17960 | INFO    | SRV |  254-a537d | Starting ntservice (v. 2.10.0.254-a537d)
06/28/15 16:53:59.885314 |  17960 | ERROR   | OSS |  254-a537d | Could not open Napatech device /dev/nt3gd
06/28/15 16:53:59.885317 |  17960 | ERROR   | SRV |  254-a537d | Failed to open libntos
06/28/15 16:53:59.885318 |  17960 | ERROR   | SRV |  254-a537d | NtServiceInit: Init Fail: 396
06/28/15 16:53:59.885320 |  17960 | ERROR   | SRV |  254-a537d | ********************************************************************
06/28/15 16:53:59.885321 |  17960 | ERROR   | SRV |  254-a537d | *                Something failed during init.                     *
06/28/15 16:53:59.885322 |  17960 | ERROR   | SRV |  254-a537d | *          Please check the complete log for more info.            *
06/28/15 16:53:59.885322 |  17960 | ERROR   | SRV |  254-a537d | ********************************************************************
06/28/15 16:54:07.980374 |  17973 | ERROR   | OSS |  254-a537d | Could not open Napatech device /dev/nt3gd
06/28/15 16:54:07.980380 |  17973 | ERROR   | API |  254-a537d | [ntlog] Failed to initialize libntos

Warnings

The driver also logs warnings such as limited line rate, sensor alarms etc. as shown below.

05/29/13 15:02:18.952362 |   6557 |  WARNING| SRV | 23969 | Adapter 0: Cannot perform line rate transmit. The measured bandwidth is 27941Mbps - required bandwidth for line rate is 45696Mbps
05/29/13 15:02:18.952388 |   6557 |  WARNING| SRV | 23969 | Adapter 1: Cannot perform line rate transmit. The measured bandwidth is 28299Mbps - required bandwidth for line rate is 45696Mbps
05/29/13 15:02:10.385191 |   6557 |  WARNING| SRV | 23969 | Port 0: Port sensor 0 "QSFP+" enters alarm state with value 54.9 C
Log Level mask: 0x07

Windows

The ntlog tool is under the installation directory on Windows e.g. C:\Program Files\Napatech3\bin. The following command example uses the -m option with 0x001 to display error messages on Windows.

C:\Program Files\Napatech3\bin>ntlog -m 0x001

Please see DN-0449 for more information on the ntlog syntax.