Tip
This is the documentation for the v21.03 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|dhcp|http|ike|ntp|restconf|snmp|unbound)
coredump (enable|disable)
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 cli [level <n>]:
Enable debugging in
clixon
andcligen
at the given level.- debug tnsr (clear|set|value) <flags>:
Enable debugging in TNSR. The
set
orclear
command may be repeated multiple times to add or remove individual flag values. Thevalue
command may be used to directly set the value. The<flags>
value is the logicalor
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
- debug vmgmt (clear|set|value) <flags>:
Enable VPP Mgmt library debug. The
set
orclear
command may be repeated multiple times to add or remove individual flag values. Thevalue
command may be used to directly set the value. The<flags>
value is the logicalor
of all desired debugging flags.The following flag values are available:
Flag
Value
VDBG_NONE
0x0000
VDBG_API_SETUP
0x0001
VDBG_API_MSG
0x0002
VDBG_ACL
0x0004
VDBG_BRIDGE
0x0008
VDBG_INTF
0x0010
VDBG_NAT
0x0020
VDBG_TAP
0x0040
VDBG_MEMIF
0x0080
VDBG_LLDP
0x0100
VDBG_GRE
0x0200
VDBG_MAP
0x0400
VDBG_ROUTE
0x0800
- no debug (cli|tnsr|vmgmt):
Removes all debugging.