As this procedure could *potentially* lead to data loss (however
unlikely if followed correctly), put a big warning on top, for safety.
Signed-off-by: Christoph Heiss <c.heiss@proxmox.com>
Provide installation documentation for opt-in features, document the
current support status, and rework the overview and introduction of
the whole chapter.
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
document some basics of the inner workings, can definitively get
extended (and might be then better of placed somewhere else).
This makes also a bit more sense then the non-telling 'SDN' heading
left over the recent rework.
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
This is a general style polishing rework that wants to:
- improve consistency of spellings and casing
- drop some to verbose examples that included the whole generated
ifupdown2 config, which is not only not that useful here, but will
also get outdated fast, so it is probably more confusing than
helping at the current development pace. Could be nice in some
reduced form some times in a "inner workings" section
- shorten some examples verbosity by not spelling repetitions of
steps, e.g., for those that one needs to apply to all guests in an
example.
Best to check the changes using the following git flags to avoid noise:
git show -w --word-diff=color --word-diff-regex='\w+'
Signed-off-by: Stefan Lendl <s.lendl@proxmox.com>
[ TL: fix build, squash patches to not break patch causality, add
actual commit message and reinstate some notes to avoid loss of
information ]
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
Target groups and filters have been replaced by notification matchers.
The matcher can match on certain notification properties and route
the notification to a target in case of a match.
This patch updates the docs to reflect these changes.
Signed-off-by: Lukas Wagner <l.wagner@proxmox.com>
Signed-off-by: Stefan Lendl <s.lendl@proxmox.com>
[ TL: fix subject and use more specific glob ]
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
Commandline/command line/command-line where being used interchangeably,
which is not correct
(see: https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/c/command-line).
use command-line when it is an adjective (e.g. "command-line interface")
and use command line when it is a noun (e.g. "change the setting from
the command line")
Signed-off-by: Noel Ullreich <n.ullreich@proxmox.com>
Fix consistency issues as well as grammatical mistakes with the spelling
of passthough/pass-through/pass through in the pve docs
Signed-off-by: Noel Ullreich <n.ullreich@proxmox.com>
Expand the existing section on systemd network interface names with a
link to the systemd.net-naming-scheme(7) manpage and some information
about naming scheme versions. Also mention the possibility of
interface naming changes due to a new naming scheme version, or
kernel/driver updates. This happens for quite some users during the
upgrade from PVE 7 to 8.
Further, describe how to pin a specific naming scheme version and how
to override interface names using systemd.link files.
Also, make some formatting fixes to the existing text.
Signed-off-by: Friedrich Weber <f.weber@proxmox.com>
Add more headings, update some recommendations to current HW (e.g.,
network and NVMe attached SSD) capabilities and expand recommendations
taking current upstream documentation into account.
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
expanding from the two currently existing sentences. In the first one, a
typo VMs -> VM's is fixed. In the second one, "one wants to" is changed
to "you want to", because the sentence already starts with "You can" and
it's active voice.
Adds information about the machine version, rationale behind the
defaults for it and what to do for deprecated versions.
Signed-off-by: Fiona Ebner <f.ebner@proxmox.com>
