5
0
mirror of git://git.proxmox.com/git/pve-docs.git synced 2025-01-07 17:17:48 +03:00
Commit Graph

53 Commits

Author SHA1 Message Date
Thomas Lamprecht
62fd0400e9 sysadmin network: document disabling mac-learning on a bridge
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2022-11-19 16:25:40 +01:00
Matthias Heiserer
eec6319859 network: fix dead link
Signed-off-by: Matthias Heiserer <m.heiserer@proxmox.com>
2022-11-18 12:58:19 +01:00
Matthias Heiserer
c15cb60b8c network: fix typo
Signed-off-by: Matthias Heiserer <m.heiserer@proxmox.com>
2022-11-18 12:58:19 +01:00
Thomas Lamprecht
4faa64451a 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 <t.lamprecht@proxmox.com>
2022-09-12 18:01:47 +02:00
Aaron Lauterer
6f151d2591 network: rework introduction for people with less experience
Mentioning explicitly, that the vmbr interfaces can be thought of as a
virtual switch and what can be done overall in the introduction will
hopefully help new users to grasp the networking more quickly.

Also mention the SDN to point people in that direction if they need it

Signed-off-by: Aaron Lauterer <a.lauterer@proxmox.com>
2022-09-12 18:01:46 +02:00
Aaron Lauterer
9a08108970 network: adapt apply config section to PVE 7
ifupdown2 is now installed by default, we can therefore omit the whole
installation part except a small note for people who installed PVE on
top of Debian.

also mention the CLI variant for users who like to edit the network
config directly or are using some config management tools

Signed-off-by: Aaron Lauterer <a.lauterer@proxmox.com>
2022-09-12 18:01:28 +02:00
Thomas Lamprecht
a5604bb464 network: re-add mention of ifup/down but as warning
Due to the pitfalls possible it makes more sense to warn actively
than just removing any mention of those tools.

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2022-09-12 18:01:28 +02:00
Aaron Lauterer
f0ab6a6953 network: remove ifup ifdown as it won't reattach guests
Mentioning 'ifup' and 'ifdown' can lead to users running into situations
where they take down one interface, for example an vmbrX. In this
situation the connection to the guests will be lost and not
reestablished automatically if the interface is brought up again with
'ifup'. The better way to apply network changes is to run 'ifreload -a'.

Signed-off-by: Aaron Lauterer <a.lauterer@proxmox.com>
2022-09-12 17:25:11 +02:00
Dylan Whyte
d7a0fa2a11 pve-network: Fix routed configuration example
In my previous fixup, I forgot to update the interface name in the line
to enable proxy ARP.

Signed-off-by: Dylan Whyte <d.whyte@proxmox.com>
2022-04-26 12:48:15 +02:00
Alexandre Derumier
a59c283b4a network: add bridge-vids to vlan aware bridge example.
This is mandatory for ifupdown2.

Signed-off-by: Alexandre Derumier <aderumier@odiso.com>
2021-09-10 14:20:33 +02:00
Dylan Whyte
e4682f58a1 fix #3523: routed net: make example conform to image
Changes the example given in section "3.3.5. Routed Configuration" so
that it's more in line with the accompanying network diagram.

Signed-off-by: Dylan Whyte <d.whyte@proxmox.com>
2021-07-29 17:24:26 +02:00
Thomas Lamprecht
33349b9fad network: the netmask is depreacated
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2021-07-06 08:53:59 +02:00
Stoiko Ivanov
024d3706c0 network: shortly document disabling ipv6 support
Given that quite a few HOWTOs on the internet suggest disabling ipv6
support via kernel commandline, which can cause quite many undesired
side-effects (e.g. ip6tables as used in pve-firewall errors out)
this patch adds a short section documenting, that disabling ipv6 is
not necessary usually and if needed better done via sysctl.

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
2021-05-07 18:20:02 +02:00
Alexandre Derumier
dd0eca0da5 pve-network doc: remove note about ifupdown2 reload not working with ovs
Signed-off-by: Alexandre Derumier <aderumier@odiso.com>
2021-03-02 15:18:38 +01:00
Alexandre Derumier
5f05aad1cb bond: use bond-slaves instead slaves
"slaves" is deprecated (not even used in official debian docs),
and ifupdown don't support it
2020-11-22 19:04:13 +01:00
Wolfgang Link
61b099f5cc sysadmin: fix the device declaration in the bonding example
We already have a "Use a bond as bridge port" example below this
one, the from reading this ones description it's cleanly meant to be
a extra bond, not on a bridge for VM internal traffic, but for things
like ceph or VM migration traffic.

Signed-off-by: Wolfgang Link <w.link@proxmox.com>
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2020-11-02 07:59:36 +01:00
Oguz Bektas
217f7cd81b network: nat: add extra newlines between links for readability
otherwise they are all rendered in one line in all our outputs (wiki,
pdf, html)

Signed-off-by: Oguz Bektas <o.bektas@proxmox.com>
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2020-08-31 12:04:54 +02:00
Aaron Lauterer
7a39aabd39 fix #2526: network config: change underscore to dash
The network config examples use the underscore but our tooling
generates the configs with dashes.

Signed-off-by: Aaron Lauterer <a.lauterer@proxmox.com>
2020-08-11 15:33:03 +02:00
Thomas Lamprecht
67c9747f51 network: typo fixes
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2020-05-04 13:08:53 +02:00
Oguz Bektas
22d5244018 network: add note for possible fix/workaround in NAT setup
apparently sometimes users have problems reaching outside internet with
some network setups. this is the workaround a user suggested that
we should add in the wiki.

Signed-off-by: Oguz Bektas <o.bektas@proxmox.com>
2020-02-11 08:57:41 +01:00
Thomas Lamprecht
52e23c357d basic network reload documentation
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2019-12-02 09:31:50 +01:00
Thomas Lamprecht
e2280bf75e pve-network: bridged setup: s/VMs/virtual guests/
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2019-09-06 16:46:23 +02:00
Stefan Reiter
a22d7c24eb Fixed some wording and typos
Signed-off-by: Stefan Reiter <s.reiter@proxmox.com>
2019-06-14 07:19:33 +02:00
Thomas Lamprecht
5df2c4d54e fix #2203: network: fíx typo s/confinuration/confinguration/
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2019-05-08 07:26:37 +00:00
Daniel A. Maierhofer
552e175dc5 pve-network: fix typo
there management interface -> their management interface

Signed-off-by: Daniel A. Maierhofer <git@damadmai.at>
2019-01-16 14:51:54 +01:00
Alexandre Derumier
59b586cb29 remove note about vlan management interface
This seem wrong,
it's possible to setup management vlan interface
on vlanaware bridge without conflict with vm.

(If vlan management is setup with vmbrX.Y)
2018-09-11 09:24:54 +02:00
Alexandre Derumier
038dc7df35 add vlanaware bridge management vlan configuration 2018-09-11 09:24:25 +02:00
Dietmar Maurer
50f88938f6 install and use new network diagrams 2018-08-16 10:13:16 +02:00
Dietmar Maurer
4d8af129eb pve-network.adoc: vlan - remove fixe markup for numbered list, cleanups 2018-02-12 09:24:02 +01:00
Dietmar Maurer
2a27274123 pve-network.adoc: vlan - s/Nic/NIC/ 2018-02-12 06:50:11 +01:00
Dietmar Maurer
61105e42d9 pve-network.adoc: vlan - use normal quotes for emphased text 2018-02-12 06:49:24 +01:00
Wolfgang Link
94fd8ea59c add VLAN explanation.] add VLAN explanation. 2018-02-12 06:36:49 +01:00
Emmanuel Kasper
052130090e Add a paragraph to explain how network models match use cases
Also :
 * explain more clearly when PVE switched to persistent device naming. (5.0)
 * use eno1 instead of eno0 everywhere when refering to the first onboard device
 * use IP addresses from the range IPv4 Address Blocks for Documentation
 (rfc5737) instead of private IPv4 addresses when giving examples of public IPs
2017-10-10 10:56:01 +02:00
Thomas Lamprecht
44f38275ee fix a/an and repeated words
ddouble words found with /(\b\S+\b)\s+\b\1\b/
(the silver searcher `ag` can find matches even with newlines in
between without extra flags)

Adapt some wording when touching the lines.

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2017-10-09 10:06:54 +02:00
Fabian Grünbichler
7ea4226669 pve-network: whitspace cleanup 2017-10-09 10:01:59 +02:00
Emmanuel Kasper
04e8476dd2 Do not mention the name of the first NIC in the doc, as it might differ in each install 2017-10-09 10:00:08 +02:00
Emmanuel Kasper
649098a64e Document that active-backup is recommended for corosync 2017-10-09 10:00:08 +02:00
Dominik Csapak
470d43137c fix typos and whitespace all around
Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>
2017-09-27 10:25:20 +02:00
Alwin Antreich
1ed9085234 added missing ipv4/ip_forward in routed network section
Signed-off-by: Alwin Antreich <a.antreich@proxmox.com>
2017-08-09 13:32:27 +02:00
Dietmar Maurer
8116dea56c pve-network.adoc: fix spelling 2017-07-10 12:22:01 +02:00
Dietmar Maurer
cc3cb91218 pve-network.adoc; cleanup, only document ethernet devices
Also changed the link (do not point to source code).
2017-07-07 13:43:20 +02:00
Wolfgang Link
7a0d4784b3 Update Dokumentation to Systemd Network Interface Names 2017-07-07 13:32:45 +02:00
Dominik Csapak
e60ce90c62 some small spelling/grammar fixes
Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>
2017-01-27 11:06:33 +01:00
Dietmar Maurer
a69bfc83f6 remove attributes.txt (use asciidoc/asciidoc-pve.conf instead) 2016-11-08 06:46:43 +01:00
Dietmar Maurer
80c0adcbc3 use/define more/better block IDs 2016-10-13 08:40:48 +02:00
Dietmar Maurer
b2f242abe4 remove empty line between heading and attribute definition, fix man titles
To avoid problems with asciidoc.
2016-10-12 06:54:29 +02:00
Dietmar Maurer
5f09af76d7 mark toplevel docs 2016-10-08 17:58:35 +02:00
Wolfgang Link
3eafe338a8 Merge Bonding form Wiki 2016-10-04 12:27:07 +02:00
Wolfgang Link
cd1de2c286 Add use case for Bond example 2016-10-04 12:27:01 +02:00
Wolfgang Link
b4c06a9395 Explain Linux Bond and examples 2016-10-04 08:19:42 +02:00