proxmox-mirrors/pve-docs
1
0
Fork 0
mirror of https://git.proxmox.com/git/pve-docs synced 2025-05-29 13:51:41 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

increase verbosity of sdn dhcp docs.

Browse Source 
These minor additions to and rearrangements within the
documentation target easier accessibility for the SDN DHCP feature.

Signed-off-by: Daniel Herzig <d.herzig@proxmox.com>
This commit is contained in:
Daniel Herzig 2024-10-03 10:38:11 +02:00 committed by Thomas Lamprecht
parent b074964d6f
commit 3e42197c54
1 changed files with 29 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

37
pvesdn.adoc
View File

@ -110,6 +110,12 @@ apt install dnsmasq
systemctl disable --now dnsmasq systemctl disable --now dnsmasq
---- ----
This disables the default dnsmasq service and allows for a separate dnsmasq service for
each configured Zone (`dnsmasq@$ZONE.service`).
See the corresponding section in xref:pvesdn_config_dhcp[DHCP feature] for
configuration details.
[[pvesdn_install_frrouting]] [[pvesdn_install_frrouting]]
FRRouting FRRouting
~~~~~~~~~ ~~~~~~~~~
@ -636,14 +642,17 @@ available when using the xref:pvesdn_ipam_plugin_pveipam[PVE IPAM plugin].
Configuration Configuration
~~~~~~~~~~~~~ ~~~~~~~~~~~~~
You can enable automatic DHCP for a zone in the Web UI via the Zones panel and NOTE: Currently only Simple Zones have support for automatic DHCP.
enabling DHCP in the advanced options of a zone. Do not forget to follow the installation steps for the
xref:pvesdn_install_dhcp_ipam[dnsmasq DHCP plugin]!
NOTE: Currently only Simple Zones have support for automatic DHCP You can enable automatic DHCP for a zone in the Web UI via the Zones panel and
enabling DHCP in the advanced options of a Zone.
After automatic DHCP has been enabled for a Zone, DHCP Ranges need to be After automatic DHCP has been enabled for a Zone, DHCP Ranges need to be
configured for the subnets in a Zone. In order to that, go to the Vnets panel and configured for the Subnets in a Zone. In order to that, go to the VNets panel and
select the Subnet for which you want to configure DHCP ranges. In the edit create a VNet, which is attached to your Zone. Click your VNet and create
the Subnet for which you want to configure DHCP ranges. In the edit
dialogue you can configure DHCP ranges in the respective Tab. Alternatively you dialogue you can configure DHCP ranges in the respective Tab. Alternatively you
can set DHCP ranges for a Subnet via the following CLI command: can set DHCP ranges for a Subnet via the following CLI command:
@ -653,14 +662,26 @@ pvesh set /cluster/sdn/vnets/<vnet>/subnets/<subnet>
-dhcp-range start-address=10.0.2.100,end-address=10.0.2.200 -dhcp-range start-address=10.0.2.100,end-address=10.0.2.200
---- ----
You also need to have a gateway configured for the subnet - otherwise You also need to have a gateway configured for the Subnet - otherwise
automatic DHCP will not work. automatic DHCP will not work.
Make sure the gateway's IP address is within the range of your Subnet
(eg 192.0.2.1 for a Subnet 192.0.2.0/24). This will be the address under
which you can reach your PVE host from the guest. If you want your guests
to have internet access, check the SNAT box as well.
NOTE: The node will configure the gateway IP with the configured netmask
on the virtual bridge. Keep in mind that this range should not be in use
elsewhere in your network to avoid unexpected routing issues.
After finishing your configuration, apply it from the SDN panel.
The configuration results in a Linux bridge (named like your VNet) being configured
with the gateway's IP as its address.
The DHCP plugin will then allocate IPs in the IPAM only in the configured 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
xref:pvesdn_install_dhcp_ipam[dnsmasq DHCP plugin] as well.
Plugins Plugins
~~~~~~~ ~~~~~~~