sdn: rework installation a bit and merge sections for dnsmaq

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
This commit is contained in:
Thomas Lamprecht 2023-11-21 20:01:43 +01:00
parent a7ec9f05c4
commit 3d5a1655f2

View File

@ -85,28 +85,32 @@ apt install libpve-network-perl
NOTE: {pve} version 7.0 and above have the `ifupdown2` package installed by NOTE: {pve} version 7.0 and above have the `ifupdown2` package installed by
default. If you originally installed your system with an older version, you need default. If you originally installed your system with an older version, you need
to explicitly install the `ifupdown2` package. to explicitly install the `ifupdown2` package.
+
After installation, you need to add the following line to the end of the After installation, you need to ensure that the following line is present at the
`/etc/network/interfaces` configuration file, so that the SDN configuration gets end of the `/etc/network/interfaces` configuration file on all nodes, so that
included and activated. the SDN configuration gets included and activated.
+
---- ----
source /etc/network/interfaces.d/* source /etc/network/interfaces.d/*
---- ----
[[pvesdn_install_dhcp_ipam]]
DHCP IPAM DHCP IPAM
~~~~~~~~~ ~~~~~~~~~
The DHCP integration into the IP Address Management stack currently uses The DHCP integration into the built-in 'PVE' IP Address Management stack
`dnsmasq` for giving out DHCP leases. This is currently opt-in. currently uses `dnsmasq` for giving out DHCP leases. This is currently opt-in.
To use that feature you need to install the `dnsmasq` package on every node: To use that feature you need to install the `dnsmasq` package on every node:
---- ----
apt update apt update
apt install dnsmasq apt install dnsmasq
# disable default instance
systemctl disable --now dnsmasq
---- ----
[[pvesdn_install_frrouting]]
FRRouting FRRouting
~~~~~~~~~ ~~~~~~~~~
@ -647,7 +651,7 @@ The DHCP plugin will then allocate IPs in the IPAM only in the configured
ranges. ranges.
Do not forget to follow the installation steps for the Do not forget to follow the installation steps for the
xref:pvesdn_dhcp_dnsmasq_installation[dnsmasq DHCP plugin] as well. xref:pvesdn_install_dhcp_ipam[dnsmasq DHCP plugin] as well.
Plugins Plugins
~~~~~~~ ~~~~~~~
@ -657,16 +661,8 @@ Dnsmasq Plugin
Currently this is the only DHCP plugin and therefore the plugin that gets used Currently this is the only DHCP plugin and therefore the plugin that gets used
when you enable DHCP for a zone. when you enable DHCP for a zone.
[[pvesdn_dhcp_dnsmasq_installation]]
.Installation .Installation
In order to be able to use the Dnsmasq plugin you need to install For installation see the xref:pvesdn_install_dhcp_ipam[DHCP IPAM] section.
the dnsmasq package and disable the default DNS server that gets automatically
started:
----
apt install dnsmasq
systemctl disable --now dnsmasq
----
.Configuration .Configuration
The plugin will create a new systemd service for each zone that dnsmasq gets The plugin will create a new systemd service for each zone that dnsmasq gets