From cf39bda8af2a634180bd677b833c205110726a40 Mon Sep 17 00:00:00 2001 From: Konrad Bucheli Date: Tue, 19 Dec 2023 10:56:21 +0100 Subject: [PATCH] document static routes --- admin-guide/configuration/networking.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/admin-guide/configuration/networking.md b/admin-guide/configuration/networking.md index 99823a28..ef6b6282 100644 --- a/admin-guide/configuration/networking.md +++ b/admin-guide/configuration/networking.md @@ -96,6 +96,30 @@ networking::connection::ipoib_network: NetworkManager also supports other types like `wifi`, `vpn`, `bridge`, `vlan`, etc. Note that other types than `ethernet` and `ethernet` have so far not been tested. Please contact us if you managed to set up some other network type or need help to do so. +### Static Routes + +Static routes can be added with the `additional_config` key in the connection settings. +Depending on the IP version there is a `ipv4` or `ipv6` subkey which then can contain many `routes` + number keys. So the first route is `routes1`, the second `routes2`, etc. +The minimal entry for `routesX` is the network and then, separated with a comma, the next hop IP. The optinal third entry is the metric. +For each route you may also add a option key `routesX_options`, where multiple options in the form `name=value` can be added, again comma separated. + +An example: + +``` +networking::connection::management_network: + interface_name: 'eno1' + ipv4_method: 'manual' + ipv4_address: '192.168.71.10/24' + ipv6_method: 'disabled' + additional_config: + ipv4: + routes1: '10.255.254.0/24,192.168.71.10' + routes2: '10.255.255.0/24,192.168.71.10,100' + routes2_options: 'lock-cwnd=false,lock-mtu=false' +``` + +All routing options can be found in the Red Hat NetworkManager documentation ([RHEL8](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html/configuring_and_managing_networking/configuring-static-routes_configuring-and-managing-networking#how-to-use-the-nmcli-command-to-configure-a-static-route_configuring-static-routes), [RHEL9](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/9/html/configuring_and_managing_networking/configuring-static-routes_configuring-and-managing-networking#how-to-use-the-nmcli-command-to-configure-a-static-route_configuring-static-routes)). + ### DNS Override The internal nameservers are configured according to the network zone by Puppet.