fix #3967: add ZFS dRAID documentation

add some basic explanation how ZFS dRAID works including
links to openZFS for more details

add documentation for two dRAID parameters used in code

Signed-off-by: Stefan Hrdlicka <s.hrdlicka@proxmox.com>

Document VM.Config.Cloudinit permission

Signed-off-by: Leo Nunner <l.nunner@proxmox.com>

cloud init: use 'import-from' disk syntax to avoid a step

Put the 'scsihw' part into the previous command, so that the rather
complicated import command can stand on its own.

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

cloud init: use expected disk number in example

Starting from a storage with no disks for the VM ID in question, the
imported disk will be called vm-9000-disk-0.

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

cloud init: use 'order' variant for 'boot' property

instead of the legacy 'boot: c'+bootdisk combination.

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

bump version to 7.2-3

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

asciidoc-pve: disallow certain characters in onlineHelp keys

this removes the lazily evaluated part of the regex used to detect
`onlineHelp` keys in order to match them with asciidoc anchors in the
documentation. it uses a pattern that excludes curly braces, brackets
and quotations instead. this allows for greedy matching and also
removes an issue where keys that are set via CBind were included
incorrectly. the script would try to find an anchor name that was
equivalent to the CBind placeholder, which would fail.

since brackets, curly braces and quotation marks aren't allowed in
asciidoc anchors anyway, excluding them like this should be safe.

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

update static/schema information

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

pveum: add the "user_mgmt" reference to the documentation

since this key was missing from the PVE documentation, the TFA ui's
help buttons didn't work as they relied on it.

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

Merge branch 'taskset' into taskset-merged

fix #3593: add affinity to docs

Added affinity to the resource limiting info in qm.adoc.
Added affinity to the qemu conf spec in qm.conf.5-opts.adoc.

Signed-off-by: Daniel Bowder <daniel@bowdernet.com>

update link to debian handbook to avoid 404

seems like Bullseye is not yet ready, so the download for current
stable is 404, link to general "get book" page, which also provides a
donation option and so better for the project.

Signed-off-by: Matthias Heiserer <m.heiserer@proxmox.com>
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

it's -> its because it isn't 'it is'

Signed-off-by: Matthias Heiserer <m.heiserer@proxmox.com>
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

installations: various typo/grammar fixes

Signed-off-by: Matthias Heiserer <m.heiserer@proxmox.com>
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

installation: note that some ISO grub options moved to sub menu

Signed-off-by: Matthias Heiserer <m.heiserer@proxmox.com>
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

installation: add note that secure boot currently needs to be disabled

Signed-off-by: Matthias Heiserer <m.heiserer@proxmox.com>
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

consistently capitalize Ceph

Signed-off-by: Matthias Heiserer <m.heiserer@proxmox.com>
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

ceph: remove misplaced comma

Signed-off-by: Matthias Heiserer <m.heiserer@proxmox.com>
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

consistently use 'web interface' (two words)

Signed-off-by: Matthias Heiserer <m.heiserer@proxmox.com>
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

firewall: fix typo: ident -> identical

"the following two are ident" --> "the following two are identical"

Signed-off-by: Lukas Wagner <l.wagner@proxmox.com>

asciidoc: fix capitalization of GmbH

Signed-off-by: Lukas Wagner <l.wagner@proxmox.com>

qm: avoid using "e.g."

favor "for example", "such as" or "like", as our technical writing
guide forbids using "e.g." in the docs where possible.

Also do some small fixes in the vicinity while at it.

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

qm: rework migration sections, drop mentioning outdated limitations

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

pveum: mention Sys.Incoming privilege

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

updated copyright to current year

Updated the copyright in `pve-copyright.adoc` which is used to generate the man pages.
Pervious version was from 2019

Signed-off-by: Noel Ullreich <n.ullreich@proxmox.com>

fix #4307: installation: correct typos in prepare macOS medium section

It seems `bs=1m` needs to be `bs=1M` in apple world. Correctly refer
to `.dmg` not `.img` and reword slightly.

Also, while at it, order the `bs=1M` in the middle, making the target
of more accessible for editing after copy + paste.

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

pvesr: remove note about offline migration

It has been possible since quite a while to live migrate replicated
guests.

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

pct/qm: update cpuunits default

which is 100 on hosts running cgroup v2. Still mention the old default
relevant for hosts with legacy cgroups.

Also reword the sentence with "gets in regards to other VMs running"
which sounded a bit off.

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

qm: resource limits: update systemd setting name for cpuunits

As mentioned in man 5 systemd.resource-control, the CPUShares setting
was replaced by CPUWeight and is deprecated.

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

backup: mention max-workers performance setting

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

backup: merge sections describing jobs

keeping a short intro referring to the full section at the beginning.

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

backup: expand section for jobs

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

backup: rework storage section, mentioning and recommending PBS

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

backup: fix title case and add skelleton for new jobs section

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

cloud init: mention that serial display might not work for all images

Example from the community forum:
https://forum.proxmox.com/threads/112225/

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

cloud init: add warning to not install cloud-init on the host

From time to time, users install the cloud-init package on the host
by accident [0]. Since the other commands are intended to be run on
the host, add a warning about the one command that shouldn't.

Patch suggested by @Neobin on the community forum [1].

[0] https://forum.proxmox.com/threads/115530/post-499610
[1] https://forum.proxmox.com/threads/115530/post-499624

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

zfs: special device: update maximum for special_small_blocks

In ZFS 0.8.3, the limit was increased to 1M [0][1].

[0] https://github.com/openzfs/zfs/releases/tag/zfs-0.8.3
[1] https://github.com/openzfs/zfs/pull/9355

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

pveum: fix syntax for webauthn config

the property string needs to be on the same line as the config key

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

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>

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>

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>