proxmox-mirrors/pve-docs
1
0
Fork 0
mirror of https://git.proxmox.com/git/pve-docs synced 2025-05-01 09:33:42 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

network: rework and reorder reload/apply section

Browse Source 
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 <t.lamprecht@proxmox.com>
This commit is contained in:
Thomas Lamprecht 2022-09-12 17:58:26 +02:00
parent 6f151d2591
commit 4faa64451a
1 changed files with 21 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

39
pve-network.adoc
View File

@ -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
~~~~~~~~~~~~~~~~~~