thumbnail: allow to reference all images inside /images subdir

Before, we was limited to /images/screenshots/

add graphviz picture for our default bonded network setup

add graphviz picture for our default routed network setup

pve_network_templates.tt: add macro for ethernet interfaces

add graphviz picture for our default bridged network setup

add framework to generate network graphs using graphviz

vxlan-evpn : add documentation to external routing

without bgp between proxmox and external router

split sysctl.conf to symmetric and asymmetric setup

vxlan : remove vlanaware bridge documentation

fix #1850: small additions

add vxlan l3 routing

This add documentation for inter vxlan routing, with frr and anycast gateway.

add documentation for vxlan layer 2 network

Thank to Alexandre Derumier <aderumier@odiso.com> for providing these docs.

bump version to 5.2-8

add lvm/zfs anchors

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

follow up: fix preformatted-block syntax and newlines

four '-' are enough, common use and as they need to be symmetric also
easier to handle manually.

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

follow up: use higher heading level

else this is not visible in the one-page html document

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

certificate-managment.adoc: describe dir change

Adds a section with example of how to change the default ACME account from the
LE staging to production directory.

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

bump version to 5.2-7

gen-output-format-opts.pl: use correct argument syntax

output-format.adoc: fix typo

bump version to 5.2-6

Makefile GEN_SCRIPTS: add gen-output-format-opts.pl

pve-admin-guide: include pvenode and pvesh docs

pvenode.adoc: include output-format.adoc

pvesh.adoc: include output-format.adoc

output-format.adoc: documentation for output format options

pvesh.1-synopsis.adoc: update

update pvenode.1-synopsis.adoc

add pvesh.adoc

api-viewer: use our extjs package

The loading of an external hosted ExtJS is from a time where we did
not have a extra ExtJS package as it still was in the pve-manager
one, which was not desired to be installed on a non-pve machine.
Add a dependency on libjs-extjs and a link from api-viewer/extjs to
the installation directory of the ExtJS package, this allows to reuse
ExtJS on PVE node hosted docs and on the hosted docs from proxmox.com
at the same time.

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

api-viewer: use 'normal' over 'touch' theme

The touch feels super zoomed, and the api-viewer is probably much
more viewed through a desktop/laptop not a mobile device with small
high-dpi touch screen.

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

api-viewer: use much smaller minified extjs

Use the over 4 times smaller minfied version of ExtJS, not the debug
one.

Any developer can easily use the debug version if needed, but most of
the times it this isn't the case.

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

bump version to 5.2-5

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

wiki: add CephFS link to storage page

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

update static files

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

add references to storage docs

so that they can be easily referenced, by the WebUI for example

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

storage: iscsi: don't use links in headers

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

pveceph: followup: fix grammar

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

pveceph: reword RAID paragraph

The "While ..." sentence seemed unfinished, reword paragraph

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

pveceph: followup: refactor advantage list

remove duplicated 'Easy management' point.
Remove 'no signle point of failure' as it's very easy to setup a
ceph cluster with lot's of single point of failures, ceph allows to
avoid them, but does not magically do so - so do not lull an unknown
user into false hope.
Use {pve} makro and rewor heading to a more "what's cool on ceph
_with_ pve" one.

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

Update pveceph

* Combine sections from the wiki
* add section for avoiding RAID controllers
* correct command line for bluestore DB device creation
* minor rewording

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

cephfs: reduce duplication of RBD docs and reword

No point in having half of RBD section duplicated here.
Reference pveceph-chapter, note that upstream considers snapshots
still not completely stable and remind user that he needs to setup a
ceph user secret...

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

Add storage plugin CephFS to docs

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

fix #1818: use NTP instead of Servers in timesyncd.conf

'Servers' should still work but it was changed to 'NTP'
quite a while ago...

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

faq: add upgrade point

add a short FAQ point regarding upgrades (minor and major), with
anchor so that we can link better to it, e.g., from a EOL notice.

use new helper PVE::RESTHandler::api_dump_remove_refs()

bump version to 5.2-4

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>