certificate-managment.adoc: use xref to refer to chapter_pmxcfs

use separate wiki page for qm-cloud-init.adoc

bump version to 5.2-3

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

installation: extend parameter description

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

fixup: cloud init: correct header syntax

The header markup need to be the same length as the header itself,
else we may get an incorrect output in the following lines.

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

bump version to 5.2-2

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

cloud init: improve wording/grammar

Integrate grammar and wording improvements from Daniela.

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

bump version to 5.2-1

update API

pve-admin-guide.adoc: include pvenode synopsys

Makefile: do not use ordered dependencies

Instead, make odering explicit.

add missing file

more ACME documentation

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

add documentation for certificate managment

* new section about certificate management in sysadmin chapter.
* adaptation of pveproxy and pvenode documentation

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
Co-authored-by: René Jochum <r.jochum@proxmox.com>

bump version to 5.1-18

add two screenshots for cloud-init GUI

pvenode: extend to minimal complete chapter

add pvenode.adoc

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

qm.adoc: use new screenshots

update vm create shapshots

update container create snapshots

pvecm: add some section references

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

getting help: reword bug tracker paragraph

fix #1738: remove duplicate 'a public'

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

mention that NAT mode is not available on the WebUI

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

fix wording for new memory dialog for qemu

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

storage: nfs cannot have subvolumes

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

cleanup and improve CIFS documentation

Swap NFS reference left over from intial copying with CIFS.

Add an CLI add example.

Improve wording, grammar.

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

Add documentation for CIFS Storage Plugin.

pve-bibliography.adoc - update version of 'Mastering Proxmox'

vzdump: fix few typos and polish

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

bump version to 5.1-17

api-viewer: minor style fix

update generated docs

vzdump: add restore bwlimit docs

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

api-viewer: show full return info if available

if we have extended information available about what a API call
returns the show it.

Just stringify the items and/or properties object and put it in <pre>
tags.

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

add 'gen-qm-cloud-init-opts.pl' to doc-gen

The generator script for 'qm-cloud-init-opts.adoc' wasn't included in
the pve-doc-generator package.
Add it as else qm.1 fails to build in qemu-server:

> make[2]: *** No rule to make target 'qm-cloud-init-opts.adoc', needed by 'qm.1'.  Stop.

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

pvecm: add chapter reference

split out cloud-init docs, make it available as wiki page

start cloud-init documentation

buildsys: use git rev-parse for GITVERSION

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

export and respect SOURCE_DATE_EPOCH

to improve reproducibility of pve-docs, pve-doc-generator and
pve-doc-mediawiki builds, as well as man pages generated by
pve-doc-generator when called via dpkg-buildpackage.

timestamps embedded in the documentation now always reflect the last changelog
entry of the package to which the documentation belongs (pve-docs for html,
epub and pdf, individual packages for man pages).

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

fix typo in api viewer

authententification -> authentication
authententicated -> authenticated

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

update generated docs

pve-network.adoc: vlan - remove fixe markup for numbered list, cleanups

pve-network.adoc: vlan - s/Nic/NIC/

pve-network.adoc: vlan - use normal quotes for emphased text

add VLAN explanation.] add VLAN explanation.

minor fixup

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

add link for convenience on adding nodes to separated cluster network

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

minor fixups

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

qm: improve auto start/stop section

For VMs we wait 180 seconds (CT sxtill 60, so no need to correct
there) for stop to succeed. Reword and add a few details while
touching this.

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

cluster: document multiple clusters in same network

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

qm: update section about PCID / CPU flags

Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>
Reviewed-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

some typo fixes

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

bump version to 5.1-16

qm: fix rendering

qm/cpu: add section for PCID flag

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

Add section Ceph CRUSH and device classes for pool assignment

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

bump version to 5.1-15

vzdump.adoc: improve stop mode description

Explain why shut down VMs appear as running when backed up

Signed-off-by: Emmanuel Kasper <e.kasper@proxmox.com>

Update path to Backup.txt in new git repo

Signed-off-by: Emmanuel Kasper <e.kasper@proxmox.com>

Fix vzdump backup stop mode description

The VM goes to normal operation after the backup is started, not at end of
backup.

Signed-off-by: Emmanuel Kasper <e.kasper@proxmox.com>

png-verify.pl: allow 72dpcm for pve installer images

bump version to 5.1-14

pve-installation.adoc: include screenshots

add installer screenshots

bump version to 5.0-13

add replication panel to list of guest panels

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

add xterm.js to options in the console button

and change 'two' to 'some', because we have now a 'more' button, and
maybe want to have more buttons in the future with multiple options

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

fix typo

s/Rest/Reset/

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

api-viewer: adapt and add flex for parameter coolumns

Allow to use space better on higher resolutions.

Names, Defaults and Types can be read comfortably without the need of
resizing the colum width manually each time.

Cleanup trailing whithespace in the surrounding area.

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

api-viewer: also show the 'default' schema column

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

Create a 10 gibibytes diskimage instead of 10 gigabytes

Otherwise the disk import may fail on block storages requiring
volumes size to be a multiple of the block size, like ZFS.

This fixes the error:
'volume size must be a multiple of volume block size'
when importing the generated disk image as a zvol.

Signed-off-by: Emmanuel Kasper <e.kasper@proxmox.com>

Fix formatting failure

Signed-off-by: Emmanuel Kasper <e.kasper@proxmox.com>

pveceph: correct filestore examples

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

bump version to 5.1-12

pveceph: revert pool reference

bump version to 5.1-11

update Ceph screenshot

Update docs to the reflect the new Ceph luminous

Further:
 * explain the different services for RBD use
 * be clear about Ceph OSD types
 * more detail about pools and its PGs
 * move links into footnotes

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

reflect new PVE features for ceph pool configuration

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

bump version to 5.0-10

update generated docs

buildsys: allow re-building synopsis & opts files standalone

Add two new make targets 'update-static', 'clean-static' which split
out functionality from the 'update' target.
As the latter uses the long duration `make all` anybody which just
wants to see the current synopsis (e.g., when improving a chapter)
spends a lot time waiting here.

The new target clean or update (generate) specifically just the
synopsis, opts, apidata and firewall macro files from the current
installed package versions, allowing faster build times when one does
frequent edit-build cycles.

add pvesr synopsis to full page admin guide

cleanup typos / phrasing

various wording improvement

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

ceph: add references for onlineHelp

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

ha: document ignored state

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

Add a paragraph to explain how network models match use cases

Also :
 * explain more clearly when PVE switched to persistent device naming. (5.0)
 * use eno1 instead of eno0 everywhere when refering to the first onboard device
 * use IP addresses from the range IPv4 Address Blocks for Documentation
 (rfc5737) instead of private IPv4 addresses when giving examples of public IPs

qm.adoc: style/grammar

qm/cpu: split and add content

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

qm: improve disk controller wording a bit

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

fix a/an and repeated words

ddouble words found with /(\b\S+\b)\s+\b\1\b/
(the silver searcher `ag` can find matches even with newlines in
between without extra flags)

Adapt some wording when touching the lines.

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

Update the Windows import example to use the qm importovf command

Also create a new section, "Add an external disk image to a Virtual Machine"
using the qm importdisk command.

Typo correction

pve-network: whitspace cleanup

Do not mention the name of the first NIC in the doc, as it might differ in each install