public inbox for pve-devel@lists.proxmox.com
 help / color / mirror / Atom feed
From: Daniel Herzig <d.herzig@proxmox.com>
To: pve-devel@lists.proxmox.com
Subject: [pve-devel] [PATCH docs] increase verbosity of sdn dhcp docs.
Date: Thu,  3 Oct 2024 10:38:11 +0200	[thread overview]
Message-ID: <20241003083811.39215-1-d.herzig@proxmox.com> (raw)

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>
---
 pvesdn.adoc | 37 +++++++++++++++++++++++++++++--------
 1 file changed, 29 insertions(+), 8 deletions(-)

diff --git a/pvesdn.adoc b/pvesdn.adoc
index 39de80f..d4f63fc 100644
--- a/pvesdn.adoc
+++ b/pvesdn.adoc
@@ -110,6 +110,12 @@ apt install 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]]
 FRRouting
 ~~~~~~~~~
@@ -627,14 +633,17 @@ available when using the xref:pvesdn_ipam_plugin_pveipam[PVE IPAM plugin].
 Configuration
 ~~~~~~~~~~~~~
 
-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.
+NOTE: Currently only Simple Zones have support for automatic DHCP.
+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
-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
+configured for the Subnets in a Zone. In order to that, go to the VNets panel and
+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
 can set DHCP ranges for a Subnet via the following CLI command:
 
@@ -644,14 +653,26 @@ pvesh set /cluster/sdn/vnets/<vnet>/subnets/<subnet>
  -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.
 
+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
 ranges.
 
-Do not forget to follow the installation steps for the
-xref:pvesdn_install_dhcp_ipam[dnsmasq DHCP plugin] as well.
 
 Plugins
 ~~~~~~~
-- 
2.39.5



_______________________________________________
pve-devel mailing list
pve-devel@lists.proxmox.com
https://lists.proxmox.com/cgi-bin/mailman/listinfo/pve-devel


                 reply	other threads:[~2024-10-03  8:39 UTC|newest]

Thread overview: [no followups] expand[flat|nested]  mbox.gz  Atom feed

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20241003083811.39215-1-d.herzig@proxmox.com \
    --to=d.herzig@proxmox.com \
    --cc=pve-devel@lists.proxmox.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox
Service provided by Proxmox Server Solutions GmbH | Privacy | Legal