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>

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>

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>

update static/schema information

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

docs: intro: avoid office@ mail address for sales related questions

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

sysadmin: add missing btrfs & time sync links for wiki

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

add clarification of experimental zfs encryption status

Signed-off-by: Mira Limbeck <m.limbeck@proxmox.com>
 [ T: drop trailing white space ]
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

ceph: add quincy repo reference

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

ceph ec: fix typos and reword some sections

Signed-off-by: Aaron Lauterer <a.lauterer@proxmox.com>

limit zfs arc: add '-k all' to 'update-initramfs' command

add '-k all' to avoid confusion when older kernels are pinned or
users switch between installed kernel versions

Signed-off-by: Stefan Sterz <s.sterz@proxmox.com>

vzdump: add section about 'repeat-missed'

Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>
Reviewed-by: Fabian Ebner <f.ebner@proxmox.com>

close #4031: vm: import: simplify example for creating VM from existing disk

Now that the import-from feature is available.

Signed-off-by: Fabian Ebner <f.ebner@proxmox.com>

vm: import: avoid using deprecated bootdisk option

Signed-off-by: Fabian Ebner <f.ebner@proxmox.com>

pveceph: fix typo

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

sysadmin: update links for ifdef::wiki

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

bump version to 7.2-2

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

update static/schema info

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

ceph: rework EC structure and unify example style

add separate create/add headings below introduction about EC and
streamline a few details like not using spaces in example
<param-name>

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

ceph: ec: fix quoting of params and special values

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

pveceph: ec pool: add note about parameter usage on creation

Some optional parameters will only be used for the replicated metadata
pool.

Signed-off-by: Aaron Lauterer <a.lauterer@proxmox.com>

bump version to 7.2-1

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

update static/schema info

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

pveum: move attrs. to props. to own heading & expand

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

pveum: add paragraph about syncing user attributes

and improve wording for the remove vanished 'Properties' option.

Currently, we use both the word 'attributes' as well as 'properties'
for user fields (such as firstname, etc). I rewrote that a bit by calling
them 'attributes' for the LDAP side and 'properties' for the PVE side.

Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>

pbs storage: fix typo

Signed-off-by: Matthias Heiserer <m.heiserer@proxmox.com>

calendar-events: update format and add more examples

to indicate date support.
also add the special values we support

Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>

bump version to 7.1-3

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

pvecm: add basic next-id section

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

pveceph: add section about erasure code pools

Signed-off-by: Aaron Lauterer <a.lauterer@proxmox.com>

update static/schema information

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

qm: add very basic VirGL docs

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

vzdump: minimally rework backup notes, mostly formatting

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

vzdump: add section for notes and notes-template

Signed-off-by: Fabian Ebner <f.ebner@proxmox.com>

update documentation about sync-options

describe the new 'remove-vanished' option and what the options are doing

Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>

pvesdn: langauge and formatting fixup

Mostly improves langauge with some minor formatting fixes.

Signed-off-by: Dylan Whyte <d.whyte@proxmox.com>

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>

storage: rbd: add optional ceph client configuration

Signed-off-by: Alwin Antreich <alwin@antreich.com>

sysadmin: rework boot kernel pinning section

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

sys: boot: minimally document kernel version pinning

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>

zfs: fix #3479 rephrase boot-loader description.

since using proxmox-boot-tool also for legacy systems the distinction
of p-b-t vs grub is not accurate anymore.

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>

fix #3994: Added blockid to chapter Proxmox Node Management

to make it possible to reference it through the help button in the
GUI.

Signed-off-by: Daniel Tschlatscher <d.tschlatscher@proxmox.com>

fix #3884: Add section for kernel samepage merging

Adds a section to the "Host System Administration" section of the
Administration Guide, discussing KSM and its security risks

Signed-off-by: Dylan Whyte <d.whyte@proxmox.com>

vzdump/storage: mention protected backups limit and give an example

Signed-off-by: Fabian Ebner <f.ebner@proxmox.com>

storage: switch to prune-backups in examples

because maxfiles is deprecated.

Signed-off-by: Fabian Ebner <f.ebner@proxmox.com>

update static/schema information

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

zfs: update documentation about ZED

It's installed and enabled by default since PVE 6.1.

Signed-off-by: Fabian Ebner <f.ebner@proxmox.com>

sdn: update bgp/evpn documentation

Signed-off-by: Alexandre Derumier <aderumier@odiso.com>

pvecm: add small note for 'updatecerts' workaround in qdevice setup

sometimes the qdevice setup can fail when copying CA certificates if the
node SSH keys are not matching for some reason.

reported here:
https://forum.proxmox.com/threads/pvecm-qdevice-setup-fails.88681

Signed-off-by: Oguz Bektas <o.bektas@proxmox.com>
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

firewall: text width fixes

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

add documentation for the new icmp-type parameter

Signed-off-by: Mira Limbeck <m.limbeck@proxmox.com>
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

cluster: network: clarify and ease latency requirements

With 5 ms (stable!) even mid size cluster can work just fine, and we
know quite some smaller setups that work OK with 6 - 9 ms, so ease
on unnecessarily scaring users into thinking that their network will
cause them trouble.

we got reports of working two node clusters with ~15 ms latency, so
it can work out above 10ms, albeit things start to get really brittle
and def. not something for 3+ nodes.

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

storage: document preallocation as a common storage option

Signed-off-by: Fabian Ebner <f.ebner@proxmox.com>

pci-passthrough: add section about ID overrides

Signed-off-by: Nicholas Sherlock <n.sherlock@gmail.com>

pct/qm.conf: fixup reserved ID range

100 is not reserved, and '<=' actually showed up as '(' in the
generated man page.

Signed-off-by: Fabian Ebner <f.ebner@proxmox.com>

storage: cephfs/rbd: emphasize steps aren't needed for local cluster

Signed-off-by: Fabian Ebner <f.ebner@proxmox.com>

update Ceph codename and docs url to octopus

Signed-off-by: Aaron Lauterer <a.lauterer@proxmox.com>

storage: rbd: cephfs: update authentication section

It is not needed anymore to place the keyring/secret file manually in
the correct location as it can be done with pvesm and the GUI/API now.

Signed-off-by: Aaron Lauterer <a.lauterer@proxmox.com>

d/copyright: update years

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

storage: rbd: cephfs: replace PVE with {pve}

Signed-off-by: Aaron Lauterer <a.lauterer@proxmox.com>

pveproxy: improve TLS key override description

by explicitly stating that this only applies to the 'custom' certificate
key, not the built-in self-signed one..

Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>

pveproxy: document newly added options

Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>

pct: use code blocks in example commands for bindmounts

for better readability on the wiki page and admin guide.

Signed-off-by: Oguz Bektas <o.bektas@proxmox.com>

backup: clarify that CLI means FS-level and highlight retention-note

plus some other related, small additions/changes

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

backup: add section for protection

Signed-off-by: Fabian Ebner <f.ebner@proxmox.com>

cluster: migration: use back-ticked insecure when referring to the setting

Signed-off-by: Fabian Ebner <f.ebner@proxmox.com>

VM live migration: mention that CPU vendor should be the same

Signed-off-by: Fabian Ebner <f.ebner@proxmox.com>

bump version to 7.1-2

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

qm: adjust code blocks

adjusts the code block style where the older(?) way was used to be
consistent and more easy to distinguish as code block

Signed-off-by: Aaron Lauterer <a.lauterer@proxmox.com>

qm: pct: mention move-disk for storage and reassign

Signed-off-by: Aaron Lauterer <a.lauterer@proxmox.com>

update static/schema information

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

pveum: tfa: drop webauthn fixme

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

update TFA docs

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

buildsys: change upload dist to bullseye

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

bump version to 7.1-1

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

pveceph: typo/language followups

Reported-by: Aaron Lauterer <a.lauterer@proxmox.com>
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

pveceph: improve documentation for destroying cephfs

Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>

add pvescheduler docs and manpage

Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>

vzdump: change vzdump.cron to pvescheduler

Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>

refactor calendar events into appendix

Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>

tfa: add pseudo reference for future webauthn section

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

fixup: add missing newlines

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

pct: supported distros: do not just throw in a link without explanation

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

pct: supported distros: improve quotes

update some links/text and drop the manually added double-quote
characters

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

pct: supported distros: move a heading-level up to own section

And fix missing whitespace in `Arch Linux` and also refer to `CentOS
Stream`

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

pct: add section for supported distributions

Signed-off-by: Oguz Bektas <o.bektas@proxmox.com>

pci-passthrough: expand IOMMU section with notice about BIOS

note that one must enable IOMMU support in the BIOS/UEFI.

Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>

remove 'amd_iommu=on' from the passthrough docs

this is wrong and does nothing. see
https://www.kernel.org/doc/html/v5.11/admin-guide/kernel-parameters.html?highlight=amd_iommu

Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>

old repos: use /pve suffix, which has better compatibility

We switched configuring /etc/apt/auth.conf to use /debian/pve as path
instead of just the old /debian for better compatibility with PVE and
PBS getting co-installed on the same host.

To match that stricter server definition the sources.list for
pve-enterprise must contain the /pve at the end. Otherwise there is
no match and updating via the pve-enterprise repository doesn't work.

Signed-off-by: Mira Limbeck <m.limbeck@proxmox.com>
 [ Thomas: adapted commit message and older repos as 6.x too ]
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

qm: add section about TPM

Signed-off-by: Stefan Reiter <s.reiter@proxmox.com>

qm: add note about secure boot and new efidisk behaviour

Signed-off-by: Stefan Reiter <s.reiter@proxmox.com>

pveum: better LDAP/AD explanation + restructuring

Begin "Authentication Realms" section with brief introduction to each
realm (this was there already, but inconsistent in the level of detail
given for each part).

Give each realm type its own subsection

Adds some more information on LDAP and Active Directory configuration.

Restructure the document to bring the "Syncing LDAP-Based Realms" section
closer to the LDAP and AD sections.

Explain LDAP parameters/options individually in list format

Remove some non-relevant information such as how to add system users

Some more minor langauge and formatting fixup

pveum: add intro to 'limited API Token' section

Add a short introduction to the section "Limited API Token for
Monitoring", to provide some context

Signed-off-by: Dylan Whyte <d.whyte@proxmox.com>

pveum: language fixup

language cleanup with some minor formatting fixes

Signed-off-by: Dylan Whyte <d.whyte@proxmox.com>

pct: rephrase sentence

switch back to 'storage' instead of 'target', and add the default inside
the sentence instead of after.

Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>

pct: clarify simple restore mode default 'local' storage

"default local storage" is confusing without the backticks. reword the
sentences to make it clearer about `storage` parameter usage.

Signed-off-by: Oguz Bektas <o.bektas@proxmox.com>

fix #3375: warn user to remove replication jobs

this adds a warning in the documentation to remove any replication jobs
before deleting a cluster node

Signed-off-by: Dylan Whyte <d.whyte@proxmox.com>

pvecm: add note about corosync killnode error

Mentions the misleading error message shown, when deleting a node,
because of the failing command:
    corosync-cfgtool -k x

Some forum users were confused by this, and believed that the removal of
the node was unsuccessful.

Signed-off-by: Dylan Whyte <d.whyte@proxmox.com>

pvecm: update instructions to add redundant links

mentions the ability to add up to 8 redundant corosync links and how
it's done in the current GUI

Signed-off-by: Dylan Whyte <d.whyte@proxmox.com>

pvecm: fix command output formatting

- Remove host name from commands, where it provided no value
- Display new command output for pvecm status
- Shorten command output where unneccessary
- Change migration network example to use CIDR address rather than
  address + netmask

Signed-off-by: Dylan Whyte <d.whyte@proxmox.com>

pvecm: replace {PVE} with {pve}

although they both act the same, {pve} is more common throughout the
docs, so this helps to keep things more consistent

Signed-off-by: Dylan Whyte <d.whyte@proxmox.com>