System Interface#
Underlay Routing → SISystem Interfaces
The system interface is also known as the router ID, and is a special loopback address in the DefaultRouter used as a unique identifier for the node in the network. The SystemInterface resource is also typically used as the source IP address for setting up MP-BGP sessions that exchange overlay routes.
Best deployed as part of a Fabric
When possible, we recommend that you deploy this resource through a Fabric which automatically creates a SystemInterface for every node in the Fabric.
BFD#
BFD parameters can be configured on a SystemInterface. The configured BFD session will monitor a remote IP address, improving the fault detection time significantly.
Not seeing BFD sessions being established?
BFD requires a protocol to subscribe before a BFD session is created. This could be either a static route or a BGP peer. For example, a BGPPeer with BFD enabled will only establish a BFD session with its peer if the underlying SystemInterface has BFD enabled as well, and vice versa.
Dependencies#
DefaultRouter#
The SystemInterface is always connected to a DefaultRouter, which is the abstraction for the routing table that will install the IP subnet configured on the interface. The DefaultRouter must be created before the SystemInterface can be attached to it.
Referenced resources#
The SystemInterface has no references to any other EDA resources.
Examples#
Custom Resource Definition#
To browse the Custom Resource Definition go to crd.eda.dev.
SystemInterface
SPEC
SystemInterfaceSpec defines the desired state of SystemInterface
-
Enable or disable BFD on this SystemInterface.
-
The minimum interval in milliseconds between transmission of BFD control packets.
default: 1000range: 10 to 100000 -
The number of packets that must be missed to declare this session as down.
default: 3range: 3 to 20 -
Enables Biforward Detection.
default: false -
The minimum interval between echo packets the local node can receive.
default: 1000range: 0 to 100000 -
The minimum interval in milliseconds between received BFD control packets that this system should support.
default: 1000range: 10 to 100000 -
Sets custom IP TTL or Hop Limit for multi-hop BFD sessions packets. Not applicable to single-hop BFD sessions.
range: 2 to 255
-
-
Reference to a DefaultRouter.
-
The description of the SystemInterface.
-
IPv4 address in ip/mask form, e.g., 192.168.0.1/32.
-
IPv6 address in ip/mask form, e.g., fc00::1/128.
STATUS
SystemInterfaceStatus defines the observed state of SystemInterface
-
Indicates the health score of the SystemInterface.
-
Indicates the reason for the health score.
-
Indicates when this Interface last changed state.
-
Indicates the current operational state of the SystemInterface.
enum: "Up", "Down", "Degraded", "Unknown"