Tip

This is the documentation for the 23.11 version. Looking for the documentation of the latest version? Have a look here.

Diagnosing Service Issues

If a service will not stay running and the logs indicate that it is crashing, additional debugging information can be obtained from core dumps.

By default, core dumps are disabled for services. These can be individually enabled as needed by the following command:

tnsr(config)# service (backend|bgp|dataplane|dhcp4|ike|ntp (dataplane|host)|ospf|ospf6|
                 restconf|rip|snmp (dataplane|host)|unbound) coredump (enable|disable)

After enabling or disabling coredumps, the target service must be restarted for the change to take effect.

The resulting core files will be written under /var/lib/systemd/coredump/.

Debugging TNSR

The following commands enable debugging information in various aspects of TNSR. These should only be used under direction of Netgate.

debug backend [level <n>]:

Enable debugging in clixon_backend at the given level.

debug cli [level <n>]:

Enable debugging in clixon and cligen at the given level.

debug restconf [level <n>]:

Enable debugging in the RESTCONF daemon at the given level.

debug tnsr (clear|set|value) <flags>:

Enable debugging in TNSR. The set or clear command may be repeated multiple times to add or remove individual flag values. The value command may be used to directly set the value. The <flags> value is the logical or of all desired debugging flags.

The following flag values are available:

Flag

Value

TDBG_NONE

0x00000000

TDBG_FRR

0x00000001

TDBG_HOST

0x00000002

TDBG_KEA

0x00000004

TDBG_VPP

0x00000008

TDBG_NTP

0x00000010

TDBG_STRONGSWAN

0x00000020

TDBG_UNBOUND

0x00000040

TDBG_HTTP

0x00000080

TDBG_DELAYED_NODE

0x00001000

TDBG_DEP_GRAPH

0x00002000

TDBG_TRANSACTION

0x00004000

TDBG_ACL

0x00010000

TDBG_BGP

0x00020000

TDBG_BRIDGE

0x00040000

TDBG_INTF

0x00080000

TDBG_NEIGHBOR

0x00100000

TDBG_SUBIF

0x00200000

TDBG_SYSCTL

0x00400000

TDBG_GRE

0x00800000

TDBG_LOOPBACK

0x01000000

TDBG_ROUTE

0x02000000

TDBG_SPAN

0x04000000

TDBG_MAP

0x08000000

no debug (backend|cli|restconf|tnsr):

Removes all debugging.