128T-loopback-static-routes plugin provides a way to manage the route table in Linux for the loopback interface called
kni254 which is created by default on a 128T router. This is useful to set up the appropriate Linux host networking when management traffic is traversing a forwarding interface managed by the 128T router.
The instructions for installing and managing the plugin can be found here.
The plugin is designed to provide the following capabilities:
- Add a default route with custom metric towards
- Provide a list of static routes (with metric) to direct traffic towards
- Automatically learn and program static routes for configured services
The plugin aims to solve several different use cases when it comes to setting up the Linux host routing on a 128T router. The sections below explore each of the supported use cases and their configurations.
Make kni254 the Default Route in Linux
When a 128T router is deployed at the edge of a network (such as a branch or a store), it typically does not have a dedicated management interface. In such scenarios, the traffic originating in Linux such as DNS, NTP, etc., has to be routed through the 128T platform. The linux host networking document describes the 128T configuration needed to accomplish this in details. The plugin configuration to set up the Linux routing to enable in-band management access is shown below.
metric of zero will try to make this "the" default route in Linux. If the system has an out-of-band management interface and
kni254 is intended to be a backup default route choose a higher metric.
Automatically Discover Prefixes from Services
The configuration attribute
learn-from-service, when enabled, will selectively allow access to configured services. The
kni254 interface always belongs to the
_internal_ tenant and the plugin scans the running 128T configuration for the services that allow access to the
learn-from-service config can only be used when
default-route is set to false.
Consider the following example:
The configuration above will add a static route of
126.96.36.199/32 for the
dns service and
172.16.101.10/32 for the
_conductor_1_ service. Since the
other_service does not allow the
_internal_ tenant it will not be considered for adding the static routes towards
kni254. All prefixes learned through this method will get the same configured metric in Linux. For example both the routes will get a metric of
128 in the above example.
When the 128T router is running software version 4.3.0 or greater, the learning mode will automatically react to new services being committed to the 128T configuration and keep the Linux host routes in sync.
In addition to, or instead of, learning routes through service definition, the user can add other static prefixes to the configuration. In the example below, first route adds a
/32 with a metric of
100 and second route adds a
/16 with a metric of
static-route config can only be used when
default-route is set to false.
A service or static-route with prefix
0.0.0.0/0 is the same as setting
default-route to true for the plugin configuration.
Once the plugin is enabled, it will take over the management of the
/etc/sysconfig/network-scripts/route-kni254 file. This implies that when conductor services or other features such as management-over-forwarding are used its important to leave the
learn-from-services flag set to true. Otherwise you could miss routing some of the traffic towards
kni254 and some services might not work as intended.
When the plugin configuration is updated, the
128T-handle-loopback-static-routes-config.path service will react to those changes and update the
kni254 routes. The
128T-handle-loopback-static-routes-config.service can be checked for troubleshooting.
The plugin updates the
/etc/sysconfig/network-scripts/route-kni254 file and applies the route to
kni254. Here's an example of what the file would look like on a running system depending on the configuration.
- PLUGIN-768 Support the Loopback Static Routes plugin in 128T versions