From 4faa64451a4bf9dbcc68002e58983dc00aab8dd4 Mon Sep 17 00:00:00 2001 From: Thomas Lamprecht Date: Mon, 12 Sep 2022 17:58:26 +0200 Subject: [PATCH] network: rework and reorder reload/apply section Order the live-reload method first & mention that it's recommended. Mention that older PVE installations may also need to install ifupdown2 manually, not just vanilla-Debian based ones. Demote the `ifreload -a` into an inline mention, and emphasize that it really only is for manual direct edits by moving that to the front of the sentence, to avoid that users think that ifreload -a is an alternative to the apply changes button/api. Explain, in short, how changes are applied on reboot. Signed-off-by: Thomas Lamprecht --- pve-network.adoc | 39 +++++++++++++++++++++------------------ 1 file changed, 21 insertions(+), 18 deletions(-) diff --git a/pve-network.adoc b/pve-network.adoc index 0e5f159..85779b6 100644 --- a/pve-network.adoc +++ b/pve-network.adoc @@ -39,26 +39,29 @@ can do many related changes at once. This also allows to ensure your changes are correct before applying, as a wrong network configuration may render a node inaccessible. -Reboot Node to apply +Live-Reload Network with ifupdown2 +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +With the recommended 'ifupdown2' package (default for new installations since +{pve} 7.0), it is possible to apply network configuration changes without a +reboot. If you change the network configuration via the GUI, you can click the +'Apply Configuration' button. This will move changes from the staging +`interfaces.new` file to `/etc/network/interfaces` and apply them live. + +If you made manual changes directly to the `/etc/network/interfaces` file, you +can apply them by running `ifreload -a` + +NOTE: If you installed {pve} on top of Debian, or upgraded to {pve} 7.0 from an +older {pve} installation, make sure 'ifupdown2' is installed: `apt install +ifupdown2` + +Reboot Node to Apply ^^^^^^^^^^^^^^^^^^^^ -One way to apply a new network configuration is to reboot the node. - -Reload Network with ifupdown2 -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -With the 'ifupdown2' package (default since {pve} 7), it is possible to apply -network configuration changes without a reboot. If you change the network -configuration via the GUI, you can click the 'Apply Configuration' button. Run -the following command if you make changes directly to the -`/etc/network/interfaces` file: - ----- - ifreload -a ----- - -NOTE: If you installed {pve} on top of Debian, make sure 'ifupdown2' is -installed: 'apt install ifupdown2' +Another way to apply a new network configuration is to reboot the node. +In that case the systemd service `pvenetcommit` will activate the staging +`interfaces.new` file before the `networking` service will apply that +configuration. Naming Conventions ~~~~~~~~~~~~~~~~~~