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
andcligen
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
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
- no debug (backend|cli|restconf|tnsr):
Removes all debugging.