user management: document TFA lockout

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

faq: add link for 7 to 8 upgrade

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

faq: split upgrade Q into minor and major upgrades

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

faq: update future Proxmox VE 7 EOL date and track 8

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

package repos: update for upcoming PVE 8 and Ceph enterprise repo

Switch overt to Bookworm / Proxmox VE 8 repos, drop older Ceph
Pacific and Octopus repos, mention the ceph enterprise repo and add
the old repos entry for the wiki

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

pvesm: mark ZFS level as both

ZFS can do both, and we do use both, block and file level functionality.

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

backup: Fix wrong unit for bandwidth limit

The correct unit for the bwlimit is actually Kibibyte per second
rather than Kibibit per second.

Signed-off-by: Stefan Hanreich <s.hanreich@proxmox.com>

tree-wide: properly use {pve} instead of PVE

where applicable, or expand/replace where it's not a good fit or automatic
expansion doesn't work.

there are a few more in generated files, those need to be cleaned up
separately.

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

network: rephrase corosync and bonds recommendations

I suspect that the old one seems to be related to multicast traffic and
LACP bonds.

The link in the comment is dead by now. It seems this is one occasion
where the internet actually forgets as I cannot find the actual message
of that mailing list thread anymore. Therefore I cannot say for sure
what the exact issue was. But it was introduced in commit
649098a64ecaffc7215ec0556e76787595b38e88 which unfortunately also
doesn't have more information.

Since with Corosync 3, unicast is used, that recommentation is probably
not accurate anymore. At least I am not aware of any issues with
Corosync on LACP bonds in recent years. Therefore, rather recommend to
configure Corosync on multiple networks instead of bonds to follow best
practice.

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

buildsys: remove odd xdg-open stanza

this does *NOT* belong in a build system, just open the browser and
hit F5 after built...

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

buildsys: derive upload dist automatically

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

bump version to 8.0.0

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

d/source: override false-positive lintian errors

api-viewer's API data is generated here from the API JSONSchema and
we already use the GFDL varian that Debian is happy with, and it
recognizes that for d/control and the like, but the "</simpara>" tags
seem to throw the detection off for the docinfo XML. so just override
that.

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

avoid duplicate GFDL, just reuse LICENSE file

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

asciidoc config: work around missing icon bug

The inline icons for admotions (note, tip, warning, ...) are missing
on builts with the asciidoc package shipped by Debian Bookworm.

As workaround set the "iconsdir" attribute manually to
"/usr/share/asciidoc/icons", as recommend by the DM in the respective
Debian bug report [0].

[0]: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1036030#10

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

mark pve-doc-generator an arch-independent package

only contains a bit of perl code and some asciidoc files.

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

d/control: raise standards version compliance to 4.6.2

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

d/control: define compat level via build-depends and raise to 13

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

d/control: add missing ${misc:Depends}

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

buildsys: add DSC target

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

buildsys: improve build dir generation and cleanup

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

drop addendum from license

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

d/copyright: use machine readable format

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

makefile: convert to use simple parenthesis

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

commit cpu-models.conf.5-opts.adoc

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

update static/schema information

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

pmxcfs: update size limit to 128 MiB

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

use datacenter consitently

we almost always use 'datacenter', but had three places where we used
'data center and while both are fine to use, keep it consistent.

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

fix #4641: qm: fix typo

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

d/changelog: fix typos/spelling

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

updated tags docs

updated the tags doc with slight rephrasing, corrected grammar,
and fixed typos.

Signed-off-by: Noel Ullreich <n.ullreich@proxmox.com>
Reviewed-by: Stefan Sterz <s.sterz@proxmox.com>

user management: ldap: specify space and number sign escaping

number sign at the beginning (was missing completely)
space only needs escaping at the start and end

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

bump version to 7.4-2

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

qm: freeze-fs-on-backup: remove reference to GUI

The config option is currently not exposed in the GUI.

Signed-off-by: Friedrich Weber <f.weber@proxmox.com>

remove storage view

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

readme: document TIP admontion

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

fix #2641: document subdir parameter for CIFS backend

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

qm: qga: add references and increase visibility of fsfreeze note

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

qm: Add section explaining fs-freeze/-thaw QGA option

Signed-off-by: Christoph Heiss <c.heiss@proxmox.com>
 [ T: resolve trivial merge conflict due to context additions ]
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

sdn: improve formatting, language and reflow to 80cc

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

sdn: add rp_filter sysctl tuning when mulitple evpn nodes are used

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

config: remove reference to preceeding / from content-dirs

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

d/copyright: update years

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

bump version to 7.4-1

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

update static/schema information

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

ha crs: document scheduling points and new ha-rebalance-on-start option

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

ha crs: improve introduction and add screenshot of option

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

ha: document manual maintenance mode

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

pveum: add RFC reference for reserved characters

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

user management: drop extra newlines and avoid broken monospace quote

asciidoc isn't really made for monospace quoting a single space
characters, so just print it without backticks

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

pveum: Document reserved characters and quoting of LDAP DNs

Signed-off-by: Christoph Heiss <c.heiss@proxmox.com>

user management: add doc references for realm types

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

conf: add support for a dark mode in the documentation

this commit adds support for a dark theme that behaves similarly to
that one used by the api viewer.

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

pveproxy: add some explicit references

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

qm: guest trim: add note mentioning issue with ext4

It is rather unexpected and seems worth mentioning. Reported in the
community forum [0] and the explanation found by Alwin [1].

[0]: https://forum.proxmox.com/threads/123819/
[1]: https://serverfault.com/questions/1113127/fstrim-is-very-slow-on-xfs-and-always-return-same-value-unlike-ext4/1113129#1113129

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

docs: add dark mode support to the api viewer

adds dark mode support to the api viewer that is activated depending
on the users theme preference. similar to the main gui's "auto"
theme.

this requires a bumps of the widget toolkit so the loaded css file is
present

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

track pvescheduler.8-synopsis.adoc

it was never committed, but needs to be, else there's effectively a build-dep
cycle between pve-docs and pve-manager..

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

qm: emulated devices: make recommendation for virtio devices more visible

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

qm: emulated devices: mention that virtio devices are better maintained

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

qm: hard disk controllers: recommend VirtIO controllers

Quoting from [0]:
> In general, I advise against using AHCI in production as better
> performance (and dev support) can be achieved through virtio.

[0]: https://lists.nongnu.org/archive/html/qemu-devel/2023-02/msg03915.html

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

qm: hard disk controllers: reword and update section

Most importantly, mention that VirtIO SCSI single in combination with
IO thread is the new recommendation and default. The controller type
used for the QEMU commandline is still the same (but one for each
disk), so information about when OSes started supporting it should be
accurate.

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

node: record todo in comment

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

fix #4194: clarify that its a bulk shutdown, not immediate hard stop

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

pveum: remove `auth` part from Keycloak issuer URL

Keycloak seems to have dropped the `auth` part with their 18.0
release.

Signed-off-by: Lukas Wagner <l.wagner@proxmox.com>
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

access control: remove misleading 'additionally' in perm-modify description

'additionally' in this context is a bit misleading, as it suggests
that e.g. 'VM.Allocate' AND 'Permissions.Modify' are needed, conflicting
with the previous paragraph.

Signed-off-by: Lukas Wagner <l.wagner@proxmox.com>
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

installation: drop dead link to spanish youtube channel

Reported-by: Daniela Häsler <daniela@proxmox.com>
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

cluster join: mention that storage config from cluster is inherited

and what to do about it. It's a rather common topic in forum threads.

Suggested in the community forum:
https://forum.proxmox.com/threads/118492/post-513743

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

qm: fix two grammar issues

Fixed two small grammar errors in the qm chapter. Rephrased a
sentence before the fixed sentence so that it would be more legible.

Signed-off-by: Noel Ullreich <n.ullreich@proxmox.com>
 [ T: resolve context merge conflict on current master ]
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

attrs: update cephdocs template to quincy

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

whitespace fixup

docs: rename "dirs" parameter, clarify paths

Chagne the name of the "dirs" parameter to "content-dirs" and be less
misleading with "absolute paths".

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

docs: document 'dirs' parameter for directory storage

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

asciidoc-pve: small code/style cleanups

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

qm: IO-Thread: rework and add a bit more context

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

qm: IO thread: mention that setting can also help with hangs

See https://bugzilla.kernel.org/show_bug.cgi?id=199727

Reported-by: Roland Kletzing <devzero@web.de>
Signed-off-by: Fiona Ebner <f.ebner@proxmox.com>

qm: IO thread: be more precise about how QEMU handles IO

Reported in the community forum[0].

The setting can already help with a single disk. Without the option,
there is not one IO thread as the old wording suggested, but IO is
handled in the main event loop or vCPU threads (see the kvm man page).

[0]: https://forum.proxmox.com/threads/118390/post-518532

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

fix #4422: correct hdiutil parameter order

the input file has to come as first positional argument.

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

tree-wide: switch to offical spelling of QEMU

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

storage: iscsi direct: update information about packages

As reported in the community forum [0], libiscsi-bin is required. The
library package on Bullseye would be libiscsi7, but there is no real
need to mention the package explicitly, because it is a dependency of
both, libiscsi-bin and pve-qemu-kvm.

[0]: https://forum.proxmox.com/threads/119369

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

install: update wiki link for debian bullseye guide

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

intro: add some references

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

bump version to 7.3-1

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

ha: crs: clarify that non-HA-managed services are currently not counted

Without explicitly stating this, it's rather easily missed.

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

ha: crs: fix typo

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

update static/schema information

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

ha: crs: remove outdated comment about restarting service

Commit 086f707 ("manager: update crs scheduling mode once per round")
in pve-ha-manager made it obsolete. Mention that a change will be
effective with the next round instead.

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

sysadmin network: document disabling mac-learning on a bridge

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

sysadmin zfs: document pool naming rules

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

bump version to 7.2-5

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

ha crs: add reference for online help

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

gui: document tags with screenshots

and list some examples

Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>
 [ T: commit screen shots ]
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

gui: document tags with screenshots

and list some examples

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

ha: fix section levels for crs sub-sections

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

ha crs: split tech-preview and many-service warning into two

And reduce the level from warning to important, as the warning symbol
is a "stop hand" which is rather too discouraging for readers.

rename section to Cluster Resource Scheduling

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

ha: add warning against using 'static' mode with many services

In HA manager, the function recompute_online_node_usage() is called
very often currently and the 'static' mode needs to read the guest
configs which adds a bit of overhead.

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

ha: add section about scheduler modes

briefly describing the 'basic' and 'static' modes and with a note
mentioning plans for balancers.

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

qm: use monospace for mtu=1

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

qm: add documentation for vm network MTU setting

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

bibliography: update debian handbook meta info

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

Update ExtJS version

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