This is the documentation for the v21.03 version. Looking for the documentation of the latest version? Have a look here.
The host OS and TNSR use separate network namespaces to isolate their networking
functions, as covered in TNSR Architecture. These are the
namespace and the
host namespace. The
dataplane namespace is for the
networking environment managed by TNSR, and the
host namespace is for the
networking environment managed by the host operating system. These two
namespaces are isolated from one another and cannot communicate directly without
manually creating a link or routing between them.
TNSR Service Namespaces¶
Services on TNSR can run in the
host namespace, the
or both, depending on the nature of the service.
Network-related services such as dynamic routing daemons (BGP, OSPF, OSPF6,
RIP), Unbound, DHCP Server, and IPsec run only in the
Management-oriented services such as SSH, the RESTCONF API, and SNMP run in the
host namespace by default, but these services are capable of running in both
namespaces at the same time using separate instances.
The NTP daemon can run in either namespace, but cannot be active in both at once.
Namespaces in TNSR CLI Commands¶
TNSR commands which can operate in multiple namespaces will support a namespace
dataplane) prefixed before the command. To see
a list of these commands, enter the namespace name followed by
? from master
tnsr# host ? ping Send ICMP echo shell Invoke shell or run a command traceroute Determine path to destination tnsr# dataplane ? ping Send ICMP echo shell Invoke shell or run a command traceroute Determine path to destination
The remainder of the command parameters are the same.
traceroute commands default to the
namespace if the parameter is omitted.
Configuration commands for items which support multiple namespaces are called out throughout the documentation where appropriate. Typically these will have either a namespace parameter or command, depending on the service and mode.
Namespaces in Shell Commands¶
When operating in a shell on the TNSR device, commands can be run in the current
namespace or another namespace. Outside of TNSR, the shell defaults to
From the TNSR CLI, a shell must be started in a specific namespace as mentioned
previously in Namespaces in TNSR CLI Commands. For example, using
starts a shell where all commands are executed in the
host shell uses the
When using a
host namespace shell, specific commands may be executed in the
dataplane namespace in two ways.
sudo ip netns exec dataplane <command>
This method requires elevated privileges using
sudoor to be run from a shell as
TNSR includes a convenience launcher program,
dp-exec, which may be run by any user and executes the given command in the dataplane namespace as the current user.
When using a
dataplane namespace shell, commands may be executed in the
host namespace by using
sudo nsenter -t 1 -n -- <command>. This requires
elevated privileges using
sudo or to be run from a shell as