installation: document UP indicator in network setup

See
https://git.proxmox.com/?p=pve-installer.git;a=commit;h=124ca33f9fb3780a76f0b5fd57952e69823852c8.

Signed-off-by: Maximiliano Sandoval R <m.sandoval@proxmox.com>

faq: use only major release version in EOL table

and adapt the one from Proxmox VE 6 to what was the effective date
when we stopped providing updates.

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

boot: kernel cmdline: clarify where kernel version/docs can be found

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

qemu: update the PCI(e) docs

A little update to the PCI(e) docs. The PCI wiki article has been
reworked as well, in line with changes from this patch.

Along some minor grammar fixes added:
 * how to check if kernel modules are being loaded
 * how to check which drivers to blacklist
 * how to add softdeps for module loading
 * where to find kernel params

Signed-off-by: Noel Ullreich <n.ullreich@proxmox.com>
 [ TL: squash in dropping two trailing whitespace errors ]
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

fix #2920: add cifs options parameter

Signed-off-by: Stefan Hrdlicka <s.hrdlicka@proxmox.com>
[FE: rebase + style fix]
Signed-off-by: Fiona Ebner <f.ebner@proxmox.com>

ct: update broken link to CentOS release EOL

Use Wikipedia, as it seems CentOS cannot be bothered to create a sane
supported releases + EOL dates table themselves anymore..

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

sdn: update netbox api-token docs link

Found by Fabian using the mlc tool [0].
[0]: https://crates.io/crates/mlc

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

sysadmin: add section 'Firmware Updates' and references

Firmware updates are important, their existence should not be checked
only when there are already noticeable problems.

Signed-off-by: Alexander Zeidler <a.zeidler@proxmox.com>
Reviewed-by: Dominik Csapak <d.csapak@proxmox.com>

update static/schema information

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

vzdump: mention new parameter 'pbs-entries-max'

configuring pbs-entries-max can avoid failing backups due to a high
amount of files in folders where a folder exclusion is not possible

Signed-off-by: Alexander Zeidler <a.zeidler@proxmox.com>

calendar events: fix build for wiki target

This was actually just some POC that got committed by accident and
broke build to to getting a title where not expecting it as there
where two (relatively seen) top-level titles in the calendar events
page.

Fix that by declaring an actual level-0 heading (i.e., title) in the
wiki context.

This then should also fix a dangling link to the calendar-events wiki
page for the docs-in-wiki stuff, e.g., "calendar events" in backup
chapter [0] pointint to 404 [1], that Fiona reported a few weeks ago.
[0]: https://pve.proxmox.com/wiki/Backup_and_Restore#vzdump_jobs
[1]: https://pve.proxmox.com/wiki/Schedule_Format#chapter_calendar_events

Fixes: a90b75d ("package repos: add Ceph 18.2 Reef repos")
Reported-by: Lukas Wagner <l.wagner@proxmox.com>
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

package repos: fix heading syntax

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

package repos: add Ceph 18.2 Reef repos

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

ha: document where shutdown policy is set

it's not obvious otherwise from reading the description.

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

vzdump: mention file-restore log file

it was only documented in the proxmox-backup source code so far.

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

website: update external links to www.proxmox.com

During the redesign of www.proxmox.com the menu structure and therefore
some url changed. Update the external link in order to avoid an
unneccessary redirect.

Signed-off-by: Christian Ebner <c.ebner@proxmox.com>

bump version to 8.0.5

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

add documentation for the new notification system

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

update static/schema information

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

pvecm: add qdevice status flag explanation

They are underdocumented and finding information is not that easy.

Signed-off-by: Aaron Lauterer <a.lauterer@proxmox.com>
 [TL: break footnote with long link over multiple lines ]
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

pvecm: fix pvecm status indentation

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

user management: add note about case-sensitivity for AD realm

As there its really common to do things case insensitive a docs note
should help users to discover that Proxmox VE allows one to configure
and LDAP/AD realm to also work case insensitive.

While the UI option got added only recently in pve-manager's commit
c34c5418 ("ui: active directory realm: expose case-sensitive option")
mention it already, as there's a good chance that manager gets bumped
sooner than docs.

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

fix #4866: fix install on Debian wiki link

to point at Bookworm, instead of Bullseye.

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

fix proxmox-kernel-helper package name

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

pveum: sort roles and privileges alphabetically

Signed-off-by: Max Carrara <m.carrara@proxmox.com>

pveum: add missing roles and privileges

Signed-off-by: Max Carrara <m.carrara@proxmox.com>

pmxcfs: fix incorrect exmple command

There is an error in this example. The .conf has to be moved in the
quemu-server folder of the new node for the migration to work.

Signed-off-by: Philipp Hufnagl <p.hufnagl@proxmox.com>

cgroup: update note about legacy cgroup controller support

The 7->8 upgrade guide [1] mentions that cgroup v1 will be deprecated
starting from PVE 9.0, so also mention this in the docs.

[1] https://pve.proxmox.com/wiki/Upgrade_from_7_to_8#cgroup_V1_Deprecation

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

installation: note that TUI uses same code and use thumbnail attribute

The thumbnail attribute is our preferred way to include those
screenshots, but it requires to be inside a paragraph to be replaced, and
having an admonition directly below the attribute doesn't makes it
part of a paragraph.

So, add a bit of text, which was warranted anyway, allowing us to use
the thumbnail attr again.

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

installation: add screenshot of tui installer

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

installation: update installer boot menu options and screenshot

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

gitattributes: treat .ppm as binary

They are images after all and should thus be treated as blobs. git does
not do that by default, probably because they have a text header.

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

pvesm: update documentation of the list feature

Signed-off-by: Philipp Hufnagl <p.hufnagl@proxmox.com>

pvecm: add node: let parameter use two dashes

While the '--linkX' paramter works with one dash too, let's use two so
we are in line with the man page and other uses of named parameters.

Since we are at it, prepend the command with '#' as we do throughout
this section.

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

bump version to 8.0.4

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

d/control: ensure docs are build with compatible asciidoc

As commit 5832a54 ("fix running a2x under new package structure") in
the upstream asciidoc-py repo broke overriding the backend with our
own config for the docbook target, which broke our thumbnail
attribute for paragraphs for the PDF output (HTML is done directly by
asciidoc, and there overriding the config still worked).

Reported upstream [0] and workarounded with the proposed fix applied
to an asciidoc package re-build that got uploaded to our devel repo
for bookworm, so ensure that builds are done with a new enough
version.

[0]: https://github.com/asciidoc-py/asciidoc-py/issues/266

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

docinfo: use https in link

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

package repos: fix ceph enterprise repo url

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

faq: fix typo in release names

Reported-by: Daniela Häsler <daniela@proxmox.com>
Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>

update docbook config

sync over from /etc/asciidoc/docbook45.conf shipped by asciidoc.

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

bump version to 8.0.3

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

update static/schema information

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

qm: slightly reposition mapping screenshots

to avoid that they are adjacent providing very little space for the
text flow floating besides it.

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

resource mapping: add screenshots

of the panel with some data + the edit windows

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

use correct heading level for resource mapping

otherwise it's a subchapter under hibernation

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

qm: move out known vCPU list to actual appendix

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

storage: add hint to avoid storage aliasing

Reviewed-by: Fiona Ebner <f.ebner@proxmox.com>
Signed-off-by: Aaron Lauterer <a.lauterer@proxmox.com>

update static/schema information

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

qm: move AMD and Intel CPU types list to the end of the chapter

to avoid cluttering up the CPU type section too much.

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

qm: improve list of Intel/AMD CPU types in QEMU section

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

qm: improve wording/style and fix typos in QEMU CPU Types section

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

qm: fix typos and improve wording in CPU Types section

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

qemu: add cpu models documentation

add doc for differents cpu models including
new x86-64-vX models

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

bump version to 8.0.2

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

update static/schema information

mostly for resource mapping API/Schema and disk-management permission
fixes.

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

update static/schema information

The changes stem mostly from the actual definition of our minimum and
maximum range for the pve-vmid format.

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

qm mappings: stylistic fixes

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

qemu: add documentation about cluster device mapping

explain why someone would want it, how to configure and which privileges
are necessary

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

Update and extend permission documentation

adapt to recent changes:
- PVESDNUser role, SDN.Use privilege
- Permissions.Modify no longer part of PVESysAdmin and PVEAdmin
- PVE reserved prefix for builtin roles

and add some notes and warnings about dangerous aspects of permission
management, and missing parts.

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

bump version to 8.0.1

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

update static/schema information

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

cephfs: mention fs-name parameter

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

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

This reverts commit 0025e843194130ec5223d5789fa01f916d189783.
The option is now also exposed in the GUI.

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

update static/schema information

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

user management: normalize code blocks

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

user management: small follow-up rewording/nits for TFA locks

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

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>