certs: improve wording and styling

porting over the changes done in pmg-docs

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

fix 3372: fix typos, and impove pve-gui docs

This reformulates quite a bit of the gui section and corrects small
typos elsewhere.

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

zfs: add some emphasis on *not* upgrading features

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

zfs: add section on zpool-features

primarily in order to warn users booting from ZFS with grub.

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
Reviewed-By: Aaron Lauterer <a.lauterer@proxmox.com>
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

pvesm: mark pbs storage as stable

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

change 'Gmbh' to 'GmbH'

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

pve-network doc: remove note about ifupdown2 reload not working with ovs

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

fix #3327: qm: update link to looking glass project

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

local ZFS: improve memory-limit section

recent forum threads showed that its not clear to all that they need
to reboot to activat modprobe.d parameters, or that they can also
directly write to /sys for a non-presistent but live change

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

ceph: add explanation on the pg autoscaler

Signed-off-by: Alwin Antreich <a.antreich@proxmox.com>
Originally-by: Alwin Antreich <a.antreich@proxmox.com>
Edited-by: Dylan Whyte <d.whyte@proxmox.com>
Signed-off-by: Dylan Whyte <d.whyte@proxmox.com>
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

docs: ceph: explain pool options

Signed-off-by: Alwin Antreich <a.antreich@proxmox.com>
Originally-by: Alwin Antreich <a.antreich@proxmox.com>
Edited-by: Dylan Whyte <d.whyte@proxmox.com>
Signed-off-by: Dylan Whyte <d.whyte@proxmox.com>
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

pct: debug log: wording

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

pct: mention the new --debug flag for obtaining logs

and make minor changes like s/ID/CTID for clarity

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

update sdn documentation

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

qm: update section about audio devices

With the ability to configure the `none` backend, the audio section
needs an update.

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

external metrics server: extend docs to explain http api

and mention that 1.8.x has a compatible api (and their differences)

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

fix #3264: mention type prefix not used in rbd storage.cfg

Just to avoid future confusion.

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

qm: add guest agent section

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

followup comma fix

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

cluster manager: reword node limit, as there's not a real one

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

qm/pct: Add explanation for --purge

This was apparently not clear enough.
For example, see #3184.

A bit long, but I think this is a better place for additional
information about ACL and firewall than the GUI tooltip or the
API parameter description.

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

remove duplicate line on the ZFS advantage list

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

translation: fix link to developer documentation wiki article

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

pbs storage: consistently talk about the storage key

instead of master key.

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

bump version to 6.3-1

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

add PBS storage edit encryption screenshot

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

pbs: adapt examples heading

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

add encryption section for PBS

Some parts from the PBS docs where re-used.

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

pvecm: improve SSH section

reword some parts, fix wrong information about port forwarding

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

qm: s/Guest Boot Order/Device Boot Order/

else it sounds like the order in what guests are booted

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

qm: add section about VM boot order

...and fix outdated example config

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

images: add screenshot of bootorder dialog

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

bump version to 6.2-7

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

vdzump: extend examples to also cover relative patterns

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

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>