Static Configuration

Software Architecture

product_line_custom
Napatech SmartNIC
category
Overview Document

ntservice.ini file

The static configuration is defined in the ntservice.ini file and is activated during start-up of ntservice. An example of the ntservice.ini file can be seen in Example. The parameters include:

  • Definition of the accelerators
  • Definition of the time synchronization
  • NUMA node configuration
  • Definition of the number of host buffers and the NUMA (non-uniform memory access – CPU memory sharing) nodes they belong to
  • Definition of the default packet descriptors used
  • Definition of the time stamp format used

The parameters are grouped according to their use.

ntservice.ini.txt file

The ntservice.ini.txt file explains the different parameters in the ntservice.ini file and lists which accelerators support which values.

System level parameters

A number of the parameters that can be set in the ntservice.ini file are at the system level. They appear under the heading [System].

The comment for each parameter lists only the values that are supported for all accelerators present.

Logging parameters

A number of the parameters that can be set in the ntservice.ini file are used for logging. They appear under the heading [Logging].

The comment for each parameter lists only the values that are supported for all accelerators present.

Accelerator-related parameters

A number of the parameters that can be set in the ntservice.ini file are accelerator-related. Some of these are specific to a single accelerator. They appear under a heading with the name of the accelerator, for instance [Adapter0]. Some are common for an accelerator of a specific type. They appear under a heading with the name of the accelerator type, for instance [NT20E3_2_PTP].

The comment for each parameter lists only the values that are supported for the accelerator in question.

Note: If no accelerators are specified in the ntservice.ini file, ntservice autodetects all accelerators and enables them with default parameters. However, if just one accelerator is specified, no other accelerators are autodetected.

Example

This is a typical example of the Napatech Software Suite configuration file, ntservice.ini.

[System]
HostBufferRefreshIntervalAll = default   # 
LinkPropagationPortPairs =               # [portA, portB], ...
NumWorkerThreads = 3                     # 1 .. 100
SDRAMFillLevelWarning = 0                # X1, X2, X3, X4
TimeSyncOsTimeReference = None           # None* - adapter-0 - adapter-1 - adapter-2 - adapter-3 - adapter-4 - adapter-5 - adapter-6 - adapter-7
TimestampFormat = NATIVE_UNIX            # NATIVE_UNIX* - PCAP - PCAP_NS
TimestampMethod = EOF                    # UNKNOWN - EOF*

[Logging]
LogBufferWrap = wrap                     # wrap* - nowrap
LogFileName = /tmp/Log3G_%s.log          # String
LogMask = 7                              # See ini-file help for information about possible values
LogToFile = false                        # true/false
LogToSystem = true                       # true/false

[Adapter0]
AdapterType = NT200A01_2X40              # NT40A01_4X1 - NT20E3_2_PTP - NT40E3_4_PTP - NT80E3_2_PTP - NT100E3_1_PTP - NT200A01 - NT200A01_2X100 - NT200A01_2X40 - NT4E - NT20E - NT4E_STD - NT20E2 - NT40E2_1 - NT40E2_4 - NT4E2_PTP - NT20E2_PTP
BusId = 0000:03:00.0                     # NNNN:NN:NN.N
HighFrequencySampling = DISABLE          # DISABLE* - ENABLE
HostBufferHandlerAffinity = -2           # -2 .. 31
HostBufferPollInterval = default         # default* - 100 - 250 - 500 - 1000 - 10000 - 25000 - 50000 - 100000
HostBufferRefreshIntervalRx = default    # 
HostBufferRefreshIntervalTx = default    # 
HostBufferSegmentAlignmentRx = default   # 
HostBufferSegmentSizeRx = default        # default* - 1 - 2 - 4
HostBufferSegmentTimeOut = default       # default* - 100 - 250 - 500 - 1000 - 10000 - 25000 - 50000 - 100000
HostBuffersRx = [4,16,-1]                # [x1, x2, x3], ...
HostBuffersTx = [4,16,-1]                # [x1, x2, x3], ...
IfgMode = NS                             # NS* - BYTE
KmTcamConfig = [2,4,0],[4,1,0]           # [cnt, len, dualLookup], ...
MaxFrameSize = 9018                      # 1518 .. 10000
NumaNode = -1                            # -1 .. 16
OnBoardMemorySplit = Even                # Even* - Proportional
PacketDescriptor = NT                    # PCAP - NT*
PortDisableMask = 0                      # See ini-file help for information about possible values
Profile = None                           # None* - Capture
PtpDhcp = ENABLE                         # DISABLE - ENABLE*
PtpMasterModeAllowed = DISABLE           # DISABLE* - ENABLE
PtpProfile = Default                     # Default* - Telecom - Power
PtpUserDescription = Napatech adapter    # String
TimeSyncConnectorExt1 = PpsIn            # None - NttsIn* - PpsIn - NttsOut - PpsOut - RepeatInt1 - RepeatInt2
TimeSyncConnectorInt1 = None             # None* - NttsIn - PpsIn - NttsOut - PpsOut - RepeatExt1 - RepeatInt2
TimeSyncConnectorInt2 = None             # None* - NttsIn - PpsIn - NttsOut - PpsOut - RepeatExt1 - RepeatInt1
TimeSyncHardReset = ENABLE               # DISABLE - ENABLE*
TimeSyncNTTSInSyncLimit = 5000           # 1 .. 4294967295
TimeSyncOSInSyncLimit = 50000            # 1 .. 4294967295
TimeSyncPPSInSyncLimit = 5000            # 1 .. 4294967295
TimeSyncPTPInSyncLimit = 5000            # 1 .. 4294967295
TimeSyncReferencePriority = Ext1, FreeRun # FreeRun* - PTP - Int1 - Int2 - Ext1 - OSTime
TimeSyncTimeOffset = 0                   # 0 .. 1000000
TxTiming = RELATIVE                      # ABSOLUTE - RELATIVE*
VXLANAltDestinationPorts = 4789,4789     # X1, X2
Note: An NT200A01-2×100/40 running at 2 × 100 Gbit/s has the value NT200A01_2X100 for AdapterType, and an NT200A01-2×100/40 running at 2 × 40 Gbit/s has the value NT200A01_2X40.
Note: An NT40A01-4×10/1-SLB has the value NT40E3_4_PTP for AdapterType.
Note: The values NttsIn and NttsOut for TimeSyncConnectorExt1 are included for backwards compatibility. They are not fully supported.

For a list of the individual parameters including explanations and default values, see DN-0449.