Tip
This is the documentation for the 22.02 version. Looking for the documentation of the latest version? Have a look here.
Host Interfaces¶
Host interfaces are interfaces which have not been allocated to the dataplane. As such, these exist separate from other types of TNSR interfaces. As the name implies, they are available for use by the host operating system. These interfaces are primarily used for host OS management.
Host interfaces may be managed from TNSR as described in this section, or using another mechanism in the host OS, such as Network Manager.
Warning
To be used as a host interface, an interface must not be used by the dataplane. To return an interface from dataplane to host control, see Remove TNSR NIC for Host Use.
Host Interface Configuration¶
To configure a host interface, from config
mode, use the host interface
<name>
command to enter config-host-if
mode. The <name>
parameter is
the name of the interface in the host operating system. To see a list of
available interfaces, use show host interface
.
config-host-if
mode contains the following commands:
- description <text>:
A brief text description of this interface, such as
Management
.- enable|disable:
Enables or disables the interface.
- ip address <ipv4-prefix>:
Sets a static IPv4 address and CIDR mask to use on the interface.
- ipv6 address <ipv6-prefix>:
Sets a static IPv6 address and prefix to use on the interface.
- mtu <mtu-value>:
Sets the maximum transmission unit size for the interface.
Host Interface Example¶
This example configures the host OS interface enp8s0f1
with an IP address
of 10.2.178.2/24
and an MTU of 1500
:
tnsr# configure
tnsr(config)# host int enp8s0f1
tnsr(config-host-if)# ip address 10.2.178.2/24
tnsr(config-host-if)# mtu 1500
tnsr(config-host-if)# enable
tnsr(config-host-if)# exit
tnsr(config)# exit
To confirm that the settings were applied to the interface, use show host
interface
:
tnsr# show host interface enp8s0f1
Interface: enp8s0f1
Link up
Link MTU: 1500 bytes
MAC address: 00:90:0b:7a:8a:6a
IPv4 addresses:
10.2.178.2/24
As additional confirmation, check how the interface looks in the host operating system using a shell command:
tnsr# host shell ip addr show enp8s0f1
7: enp8s0f1: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc mq state UP group default qlen 1000
link/ether 00:90:0b:7a:8a:6a brd ff:ff:ff:ff:ff:ff
inet 10.2.178.2/24 scope global enp8s0f1
valid_lft forever preferred_lft forever
Host Interface Status¶
The show host interface (<name>|ipv4|ipv6|link)
command shows the current
status of host interfaces. When run without parameters, show host interface
will print the status of all host interfaces.
The command also supports the following parameters:
- <name>:
The name of an interface. Restricts the output to only the single given interface.
- ipv4:
Restricts the output to include only interface IPv4 addresses.
- ipv6:
Restricts the output to include only interface IPv6 addresses.
- link:
Restricts the output to include only interface link status information, including the MTU and MAC address.
Any subset of these parameters may be given in the same command to include the desired information.