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.