proxmox-mirrors/pve-docs
1
0
Fork 0
mirror of https://git.proxmox.com/git/pve-docs synced 2025-08-11 19:25:47 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

basic network reload documentation

Browse Source 
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
This commit is contained in:
Thomas Lamprecht 2019-12-02 09:27:48 +01:00
parent 74662f51a3
commit 52e23c357d
1 changed files with 44 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

47
pve-network.adoc
View File

@ -15,10 +15,49 @@ protects you from errors.
Once the network is configured, you can use the Debian traditional tools `ifup`
and `ifdown` commands to bring interfaces up and down.
NOTE: {pve} does not write changes directly to
`/etc/network/interfaces`. Instead, we write into a temporary file
called `/etc/network/interfaces.new`, and commit those changes when
you reboot the node.
Apply Network Changes
~~~~~~~~~~~~~~~~~~~~~
{pve} does not write changes directly to `/etc/network/interfaces`. Instead, we
write into a temporary file called `/etc/network/interfaces.new`, this way you
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
^^^^^^^^^^^^^^^^^^^^
With the default installed `ifupdown` network managing package you need to
reboot to commit any pending network changes. Most of the time, the basic {pve}
network setup is stable and does not change often, so rebooting should not be
required often.
Reload Network with ifupdown2
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
With the optional `ifupdown2` network managing package you also can reload the
network configuration live, without requiring a reboot.
NOTE: 'ifupdown2' cannot understand 'OpenVSwitch' syntax, so reloading is *not*
possible if OVS interfaces are configured.
Since {pve} 6.1 you can apply pending network changes over the web-interface,
using the 'Apply Configuration' button in the 'Network' panel of a node.
To install 'ifupdown2' ensure you have the latest {pve} updates installed, then
WARNING: installing 'ifupdown2' will remove 'ifupdown', but as the removal
scripts of 'ifupdown' before version '0.8.35+pve1' have a issue where network
is fully stopped on removal footnote:[Introduced with Debian Buster:
https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=945877] you *must* ensure
that you have a up to date 'ifupdown' package version.
For the installation itself you can then simply do:
apt install ifupdown2
With that you're all set. You can also switch back to the 'ifupdown' variant at
any time, if you run into issues.
Naming Conventions
~~~~~~~~~~~~~~~~~~