sysadmin.adoc
PVE_ADMIN_GUIDE_SOURCES= \
+ datacenter.cfg.adoc \
+ datacenter.cfg.5-opts.adoc \
${SYSADMIN_SOURCES} \
pve-admin-guide.adoc \
pve-intro.adoc \
ADOC_STDARG= -a icons -a data-uri -a "date=$(shell date)"
ADOC_MAN1_HTML_ARGS=-a "manvolnum=1" ${ADOC_STDARG} -a "revnumber=${RELEASE}"
+ADOC_MAN5_HTML_ARGS=-a "manvolnum=5" ${ADOC_STDARG} -a "revnumber=${RELEASE}"
ADOC_MAN8_HTML_ARGS=-a "manvolnum=8" ${ADOC_STDARG} -a "revnumber=${RELEASE}"
BROWSER?=xdg-open
%.1: %.adoc %.1-synopsis.adoc docinfo.xml
a2x -a docinfo1 -a "manvolnum=1" -a "manversion=Release ${RELEASE}" -f manpage $*.adoc
- test -z "$${NOVIEW}" && man -l $@
+ test -z "$${NOVIEW}" && man -l $@
%.1.html: %.adoc %.1-synopsis.adoc docinfo.xml
asciidoc ${ADOC_MAN1_HTML_ARGS} -o $@ $*.adoc
%.8: %.adoc %.8-synopsis.adoc docinfo.xml
a2x -a docinfo1 -a "manvolnum=8" -a "manversion=Release ${RELEASE}" -f manpage $*.adoc
- test -z "$${NOVIEW}" && man -l $@
+ test -z "$${NOVIEW}" && man -l $@
%.8.html: %.adoc %.8-synopsis.adoc docinfo.xml
asciidoc ${ADOC_MAN8_HTML_ARGS} -o $@ $*.adoc
test -z "$${NOVIEW}" && $(BROWSER) $@ &
+datacenter.cfg.5-opts.adoc:
+ ./gen-datacenter-cfg-opts-adoc.pl >$@.tmp
+ mv $@.tmp $@
+
+%.5: %.adoc %.5-opts.adoc docinfo.xml
+ a2x -a docinfo1 -a "manvolnum=5" -a "manversion=Release ${RELEASE}" -f manpage $*.adoc
+ test -z "$${NOVIEW}" && man -l $@
+
+%.5.html: %.adoc %.5-opts.adoc docinfo.xml
+ asciidoc ${ADOC_MAN5_HTML_ARGS} -o $@ $*.adoc
+ test -z "$${NOVIEW}" && $(BROWSER) $@ &
+
all: pve-admin-guide.html
index.html: index.adoc ${PVE_ADMIN_GUIDE_SOURCES}
$(MAKE) NOVIEW=1 pve-admin-guide.pdf pve-admin-guide.html pve-admin-guide.epub
- $(MAKE) NOVIEW=1 qm.1.html pct.1.html pveam.1.html pvesm.1.html pveum.1.html vzdump.1.html pve-firewall.8.html ha-manager.1.html
- asciidoc -a "date=$(shell date)" -a "revnumber=${RELEASE}" index.adoc
+ $(MAKE) NOVIEW=1 qm.1.html pct.1.html pveam.1.html pvesm.1.html pveum.1.html vzdump.1.html pve-firewall.8.html ha-manager.1.html datacenter.cfg.5.html
+ asciidoc -a "date=$(shell date)" -a "revnumber=${RELEASE}" index.adoc
$(BROWSER) index.html &
pve-admin-guide.html: ${PVE_ADMIN_GUIDE_SOURCES}
- asciidoc -a "revnumber=${RELEASE}" -a "date=$(shell date)" pve-admin-guide.adoc
+ asciidoc -a "revnumber=${RELEASE}" -a "date=$(shell date)" pve-admin-guide.adoc
test -z "$${NOVIEW}" && $(BROWSER) $@ &
pve-admin-guide.pdf: ${PVE_ADMIN_GUIDE_SOURCES} docinfo.xml pve-admin-guide-docinfo.xml
a2x -f epub pve-admin-guide.adoc
test -z "$${NOVIEW}" && $(BROWSER) $@ &
+update: clean
+ rm -f *.5-opts.adoc .1-synopsis.adoc .8-synopsis.adoc
+ make all
clean:
- rm -rf *~ *.html *.pdf *.epub *.1 *.8
+ rm -rf *~ *.html *.pdf *.epub *.tmp *.1 *.5 *.8
--- /dev/null
+`console:` `(applet | html5 | vv)` ::
+
+Select the default Console viewer. You can either use the builtin java
+applet (VNC), an external virt-viewer comtatible application (SPICE), or an
+HTML5 based viewer (noVNC).
+
+`email_from:` `string` ::
+
+Specify email address to send notification from (default is root@$hostname)
+
+`fencing:` `(both | hardware | watchdog)` (default=`watchdog`)::
+
+Set the fencing mode of the HA cluster. Hardware mode needs a valid
+configuration of fence devices in /etc/pve/ha/fence.cfg. With both all two
+modes are used. NOTE: 'hardware' and 'both' are EXPERIMENTAL & WIP
+
+`http_proxy:` `http://.*` ::
+
+Specify external http proxy which is used for downloads (example:
+'http://username:password@host:port/')
+
+`keyboard:` `(da | de | de-ch | en-gb | en-us | es | fi | fr | fr-be | fr-ca | fr-ch | hu | is | it | ja | lt | mk | nl | no | pl | pt | pt-br | sl | sv | tr)` ::
+
+Default keybord layout for vnc server.
+
+`language:` `(de | en)` ::
+
+Default GUI language.
+
+`max_workers:` `integer (1 - N)` ::
+
+Defines how many workers (per node) are maximal started on actions like
+'stopall VMs' or task from the ha-manager.
+
+`migration_unsecure:` `boolean` ::
+
+Migration is secure using SSH tunnel by default. For secure private
+networks you can disable it to speed up migration.
+
--- /dev/null
+ifdef::manvolnum[]
+PVE({manvolnum})
+================
+include::attributes.txt[]
+
+NAME
+----
+
+datacenter.cfg - Proxmox VE Datacenter Configuration
+
+
+SYNOPSYS
+--------
+
+'/etc/pve/datacenter.cfg'
+
+
+DESCRIPTION
+-----------
+endif::manvolnum[]
+
+ifndef::manvolnum[]
+Datacenter Configuration
+========================
+include::attributes.txt[]
+endif::manvolnum[]
+
+The file '/etc/pve/datacenter.cfg' is a configuration file for
+{pve}. It contains cluster wide default values used by all nodes.
+
+File Format
+-----------
+
+The file uses a simple colon separated key/value format. Each line has
+the following format:
+
+ OPTION: value
+
+Blank lines in the file are ignored, and lines starting with a '#'
+character are treated as comments and are also ignored.
+
+
+Options
+-------
+
+include::datacenter.cfg.5-opts.adoc[]
+
+
+ifdef::manvolnum[]
+include::pve-copyright.adoc[]
+endif::manvolnum[]