update static and schema information

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

cluster: restructure ssh role section

Move the example into the bulletin points, makes it clearer that they
are connected and avoids interrupting the flow when reading.

Make the whole "important" part a admontion, as such notes should be
self-contained (not split between note and non-note), it also gives
it more visibility.

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

pvecm: explain role of ssh in PVE stack

(for #2829)

add a section describing how SSH tunnels are used in conjunction
with PVE.

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

backup: refer to our hosted prune simulator

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

add documentation for the prune-backups option

adapted from the PBS docs, and mention that maxfiles is deprecated.

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

metric server: style, grammar improvements

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

external metric server: update wording and add new info/screenshots

drop the 'since 4.0' wording and the config editing part. instead
mention the gui and add screenshots

also mentions now the new options the plugins

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

pveceph: fix typo

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

repos: document Ceph Octopus

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

pbs: fix password and encryption key file location

we namespaced them after initial addition.

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

bond: use bond-slaves instead slaves

"slaves" is deprecated (not even used in official debian docs),
and ifupdown don't support it

installation: don't mention ext3 as an option anymore

Support for ext3 was removed by commit 0abf0d3683b74421eca24ba61d1d4e100d35211a
in pve-installer.

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

sysadmin: fix the device declaration in the bonding example

We already have a "Use a bond as bridge port" example below this
one, the from reading this ones description it's cleanly meant to be
a extra bond, not on a bridge for VM internal traffic, but for things
like ceph or VM migration traffic.

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

ceph: add warning for min_size 1

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

follouwp: rewrite to active and drop trailing whitespace

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

SPAM: [PATCH docs] pveum: Add information about realm certificates

As explained by Dominik and Fabian [0].

[0] https://bugzilla.proxmox.com/show_bug.cgi?id=2827

Signed-off-by: Dominic Jäger <d.jaeger@proxmox.com>

update links to the ceph docs

* use a variable instead of hardcoded url+release name
* ceph migrated to readthedocs with a minor uri change
https://lists.ceph.io/hyperkitty/list/ceph-users@ceph.io/thread/AQZJG75IST7HFDW7OB5MNCITQOVAAUR4/

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

move footnote of Ceph's intro into TIP section

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

system requirements: minor language fixup

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

bump version to 6.2-6

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

zfs: fix typos

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

update static and schema information

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

fix broken anchor id in translation.adoc

this broke the epub build.

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

faq & pct: Improve explanation of containers

This adds more clarity to the explanation of containers and to
the different terms we use to refer to containers, in both the FAQ and
the introduction section of pct.

It also contains minor grammar fixes and rewording where appropriate.

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

translation: combine old and current wikis

This takes all of the relevant information from
an old wiki site (https://pve.proxmox.com/wiki/Translations)
and merges it into the document that is used in generating the
admin guide and current wiki
(https://pve.proxmox.com/wiki/Translating_Proxmox_VE) entry.

Also contains some rewording for better readability.

V2: - Broke up into multiple sections for further clarity
      - Separate sections for translating with and without git.
      - Separate section for various methods of testing the
translation
      - Separate section for various methods of submitting the
translation
    - Incorporate suggested changes from previous version

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

network: nat: add extra newlines between links for readability

otherwise they are all rendered in one line in all our outputs (wiki,
pdf, html)

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

pvecm: Add output for delnode

The output of "pvecm delnode someNode" is "Killing node X". Even though this
only says something about an attempt and not about success, it is not "no
output is returned".

Signed-off-by: Dominic Jäger <d.jaeger@proxmox.com>

pvecm: Add required -r to rm

/etc/corosync/* includes the directory uidgid.d.
Consequentlly, a correct rm call requires -r.

Signed-off-by: Dominic Jäger <d.jaeger@proxmox.com>

installation: Fix & move link

Dashes --- put the "Install PVE on Debian Buster" link into a code segment on
pve.proxmox.com/wiki/Installation.

Additionally, the both links are not ZFS performance tips => Move them further
below.

Signed-off-by: Dominic Jäger <d.jaeger@proxmox.com>

pvecm: whitespace fixup

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

fix #2526: network config: change underscore to dash

The network config examples use the underscore but our tooling
generates the configs with dashes.

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

qdevice: Clarify required packages

I overlooked the different package names myself. Writing out the two commands
makes this more difficult to overlook.

Signed-off-by: Dominic Jäger <d.jaeger@proxmox.com>

qdevice: Add note about root login requirements

We mention Debian as external server before. On Debian it is easily possible
that SSH root login via password is prohibited.

Signed-off-by: Dominic Jäger <d.jaeger@proxmox.com>

pvecm: Add comma after 'First'

Comma after sequence words like first, next, then, or last.

Signed-off-by: Dominic Jäger <d.jaeger@proxmox.com>

qdevice: Remove a wrong 's'

Third person plural does not require -s form.

Signed-off-by: Dominic Jäger <d.jaeger@proxmox.com>

add ZWS to avoid config snippet misinterpretation

this is not a reference that we want to include in online help.

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

metric server: remove whitespace in front of config section

The leading whitespace in the first lines of the examples caused some
confusion and problems [0] because the config would not work with it.

Removing the whitespace will make it easier to copy and paste the
examples, causing less frustation and confusion.

Signed-off-by: Aaron Lauterer <a.lauterer@proxmox.com>
[0] https://forum.proxmox.com/threads/issue-setting-up-influxdb.70687

Mention that an encrypted dataset needs to be mounted

Using load-key alone is not enough to be able to use the storage.

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

zfs: fix typo

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

qm: IO Thread: fix typo and reword section

Fix typo 'isks' => 'disks'
Reword section for better readability.

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

Add section with more infos about ZFS RAID levels

This new section explains the performance and failure properties of
mirror and RAIDZ VDEVs as well as the "unexpected" higher space usage by
ZVOLs on a RAIDZ.

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

ha-manager: fix typos and grammatical errors; improve wording

This patch improves the English throughout the "High Availability"
documentation.
It mostly consists of small typo and grammar fixes, but also contains rewording
of some sections for the sake of readability.

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

README: fix grammatical error

Fixes a grammatical error on line 143 of the README adoc

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

Fix typos and wording

Update some lines to fix spelling and grammatical errors

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

storage: fixup PBS wiki link

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

bump version to 6.2-5

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

Add man-page and notes about custom CPU models

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

update static info

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

storage: make description column wider

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

add initial PBS docs

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

cifs: modernize a bit

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

getting help: use new mailing list url

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

update static information

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

zfs: use headings and define help anchors

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

sys boot: move section a bit down and title case it

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

sysboot: add a section on how to determine the used bootloader

Besides observing the boot process, `efibootmgr` seems to be the safest
bet. It should not show anything if booted in legacy BIOS mode. If
booted in UEFI mode, the boot entries should show which bootloader is
present.

Having both present should not happen in a regular use case AFAICT and
would need more consideration, or better, a reboot.

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

zfs-local: fix #2704 add disk replacement steps for grub

The documentation only covered replacing the disk with systemd-boot but
not if grub is used.

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

pvesm: Add example & clarification for export

The literal usage of "qcow2+size" as well as what the command is supposed to do
has confused users [0].

[0] https://forum.proxmox.com/threads/trying-to-convert-raw-disk-to-vmdk-using-pvesm.70046/

save pveOnlineHelpInfo as const

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

whitespace cleanup

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

SDN: wording follouwp

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

sdn: fix qinq zone2 example

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

sdn: add vnet vlan-aware option

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

sdn: add a note to add "source /etc/network/interfaces.d/*"

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

sdn: vlan: allow non vlanaware bridge.

Also rename ove "interface" to "switch", to avoid confusion
with a ovs internal interface

update link for YubiKey documentation

Signed-off-by: Wolfgang Link <w.link@proxmox.com>

bump version to 6.2-4

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

sdn: better overview and typo fixes

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

adming guide: move SDN down, after VM/CT and before firewall

While the rationale to put it before CT/VM isn't wrong at all it's
and advanced and currently even experimental topic. Lot's of PVE
admins/users won't require to get up and running initially.

Those who search it will still find it easily.

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

sdn: add some reference anchors, some polishing

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

rework SDN docs a bit

drop thumbnails for now, would need updating anyway and the examples
are of bigger help for now anyway, IMO.

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

add sdn documentation

Signed-off-by: Alexandre Derumier <aderumier@odiso.com>
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

bump version to 6.2-3

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

cert-management: fix denglish typo

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

fix scrot density

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

pveum: add ldap sync panel screenshots

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

pveum: use correct cli command for realm sync

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

bump version to 6.2-2

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

certs: add some screenshots

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

remove SLAAC reference from cloudinit docs

As we don't currently support SLAAC in the nocloud network format code, remove
the reference from the docs.

Signed-off-by: Mira Limbeck <m.limbeck@proxmox.com>

add section about backup compression algorithms

as a short description about the different algorithms in use by vzdump.

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

rework certificates chapter, section ordering, ..

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

bump version to 6.2-1

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

html TOC: add "back to index" link

use a unicode symbol for the back arrow, should nowadays be widely
available

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

update static data and schema definitions

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

cert management: move some headings a level up for better visibility

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

avoid own chapter for meager pvenode, move to sysadmin

As else we have a big promising heading for "PVE Node Management"
with just two acme examples and a bit of Wake-On-LAN support.

Move the latter into sysadmin, the former goes only in man-page
environment, as the ACME docs are much more telling.

Ideally we move some stuff inside pvenode and see if it merits it's
own chapter, separating the more basic "Linux-y" sysadmin stuff from
PVE node, but not today.

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

ldap sync: minor wording + reference addition

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

add documenation for ldap syncing

explaining the main Requirements and limitations, as well as the
most important sync options

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

network: typo fixes

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

cert management: split examples a bit up for readabillity

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

certs: extend ACME section with DNS/plugin info

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

Also mentioning FC-based storage in pve

Signed-off-by: Andreas Steinel <A.Steinel@gmail.com>

installation: usb windows: adapt wording

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

installation: improve section for creating USB drive from Windows

For those not even having the attention span to read 4 short and
straight forward written sentences..

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

intro: s/Proxmox VE/{pve}/g

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

Revision of the pvesr documentation

Improvement of grammar and punctuation. Clarify the HA limitations.
Remove future tense in some sentences. It is not good to use it in
technical/scientific papers. Rewrite some sentences to improve
understanding.

Signed-off-by: Wolfgang Link <w.link@proxmox.com>
Reviewed-by: Aaron Lauterer <a.lauterer@proxmox.com>

fix apparmor profile config key

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

Add documentation for virtio-rng

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

pveceph: Reducing number of PGs is possible

From Ceph Nautilus onwards reducing the number of placement groups is possible.

Signed-off-by: Dominic Jäger <d.jaeger@proxmox.com>