add pvecm man page

diff --git a/Makefile b/Makefile
index bb85570a5f844413ed27e581ca5f8d69fc2525ca..6896e254fde247869cfcbabddc33327e70f11f50 100644 (file)
--- a/Makefile
+++ b/Makefile
@@ -22,6 +22,7 @@ DEB_SOURCES=                  \
        pve-storage-nfs.adoc            \
        pve-storage-rbd.adoc            \
        pve-storage-zfspool.adoc        \
+       pvecm.adoc                      \
        pveum.adoc              \
        vzdump.adoc             \
        pve-firewall.adoc       \
@@ -73,6 +74,7 @@ PVE_ADMIN_GUIDE_SOURCES=              \
        ${PVE_FIREWALL_MAN8_SOURCES}    \
        ${PVESM_MAN1_SOURCES}           \
        ${PCT_MAN1_SOURCES}             \
+       ${PVECM_MAN1_SOURCES}           \
        ${QM_SOURCES}                   \
        ${PVEAM_SOURCES}                \
        ${PVEUM_SOURCES}                \
@@ -123,7 +125,7 @@ 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 datacenter.cfg.5.html vm.conf.5.html pct.conf.5.html
+       $(MAKE) NOVIEW=1 pvecm.1.html 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 vm.conf.5.html pct.conf.5.html
        asciidoc -a "date=$(shell date)" -a "revnumber=${DOCRELEASE}" index.adoc
        test -n "$${NOVIEW}" || $(BROWSER) index.html &
 

diff --git a/index.adoc b/index.adoc
index d3b5d2543f1796c28d5e1a553edfab1de2c675dd..3ab9710e594c078422328d357d7ac2428f448adc 100644 (file)
--- a/index.adoc
+++ b/index.adoc
@@ -24,6 +24,7 @@ include::attributes.txt[]
 | qm           | link:qm.1.html[qm.1]
 | pct          | link:pct.1.html[pct.1]
 | pveam        | link:pveam.1.html[pveam.1]
+| pvecm        | link:pvecm.1.html[pvecm.1]
 | pvesm        | link:pvesm.1.html[pvesm.1]
 | pveum        | link:pveum.1.html[pveum.1]
 | vzdump       | link:vzdump.1.html[vzdump.1]

diff --git a/pve-admin-guide.adoc b/pve-admin-guide.adoc
index 2642665f77591c9c198a61338318147569d998a5..f3c9e4a5ae77f65970642d4d522a524c62fbe81c 100644 (file)
--- a/pve-admin-guide.adoc
+++ b/pve-admin-guide.adoc
@@ -73,6 +73,15 @@ include::pveam.1-synopsis.adoc[]
 
 :leveloffset: 0
 
+*pvecm* - {pve} Cluster Manager
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+:leveloffset: 1
+include::pvecm.1-synopsis.adoc[]
+
+:leveloffset: 0
+
+
 *pveum* - {pve} User Manager
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

diff --git a/pve-doc-generator.mk b/pve-doc-generator.mk
index 5668c217802e2f7533e60a71e67163f632c64b76..e4cd6c736bb732872a16a743bb5e0cd962e9a3f1 100644 (file)
--- a/pve-doc-generator.mk
+++ b/pve-doc-generator.mk
@@ -10,6 +10,11 @@ PVE_COMMON_DOC_SOURCES=                      \
        pve-copyright.adoc              \
        docinfo.xml
 
+PVECM_MAN1_SOURCES=                    \
+       pvecm.adoc                      \
+       pvecm.1-synopsis.adoc           \
+       ${PVE_COMMON_DOC_SOURCES}
+
 PVE_FIREWALL_MAN8_SOURCES=             \
        pve-firewall.adoc               \
        pve-firewall.8-synopsis.adoc    \
@@ -76,6 +81,10 @@ pct.1: ${PCT_MAN1_SOURCES}
        a2x -a docinfo1 -a "manvolnum=1" -a "manversion=Release ${DOCRELEASE}" -f manpage pct.adoc
        test -n "$${NOVIEW}" || man -l $@
 
+pvecm.1: ${PVECM_MAN1_SOURCES}
+       a2x -a docinfo1 -a "manvolnum=1" -a "manversion=Release ${DOCRELEASE}" -f manpage pvecm.adoc
+       test -n "$${NOVIEW}" || man -l $@
+
 %.5: %.adoc %.5-opts.adoc ${PVE_COMMON_DOC_SOURCES}
        a2x -a docinfo1 -a "manvolnum=5" -a "manversion=Release ${DOCRELEASE}" -f manpage $*.adoc
        test -n "$${NOVIEW}" || man -l $@

diff --git a/pvecm.1-synopsis.adoc b/pvecm.1-synopsis.adoc
new file mode 100644 (file)
index 0000000..91da77a
--- /dev/null
+++ b/pvecm.1-synopsis.adoc
@@ -0,0 +1,184 @@
+*pvecm* `<COMMAND> [ARGS] [OPTIONS]`
+
+*pvecm add* `<hostname>` `[OPTIONS]`
+
+Adds the current node to an existing cluster.
+
+  <hostname> string
+
+            Hostname (or IP) of an existing cluster member.
+
+  -force     boolean
+
+            Do not throw error if node already exists.
+
+  -nodeid    integer (1 - N)
+
+            Node id for this node.
+
+  -ring0_addr string
+
+            Hostname (or IP) of the corosync ring0 address of this node.
+            Defaults to nodes hostname.
+
+  -ring1_addr string
+
+            Hostname (or IP) of the corosync ring1 address, this needs an
+            valid configured ring 1 interface in the cluster.
+
+  -votes     integer (0 - N)
+
+            Number of votes for this node
+
+
+
+*pvecm addnode* `<node>` `[OPTIONS]`
+
+Adds a node to the cluster configuration.
+
+  <node>     string
+
+            The cluster node name.
+
+  -force     boolean
+
+            Do not throw error if node already exists.
+
+  -nodeid    integer (1 - N)
+
+            Node id for this node.
+
+  -ring0_addr string
+
+            Hostname (or IP) of the corosync ring0 address of this node.
+            Defaults to nodes hostname.
+
+  -ring1_addr string
+
+            Hostname (or IP) of the corosync ring1 address, this needs an
+            valid bindnet1_addr.
+
+  -votes     integer (0 - N)
+
+            Number of votes for this node
+
+
+
+*pvecm create* `<clustername>` `[OPTIONS]`
+
+Generate new cluster configuration.
+
+  <clustername> string
+
+            The name of the cluster.
+
+  -bindnet0_addr string
+
+            This specifies the network address the corosync ring 0
+            executive should bind to and defaults to the local IP address
+            of the node.
+
+  -bindnet1_addr string
+
+            This specifies the network address the corosync ring 1
+            executive should bind to and is optional.
+
+  -nodeid    integer (1 - N)
+
+            Node id for this node.
+
+  -ring0_addr string
+
+            Hostname (or IP) of the corosync ring0 address of this node.
+            Defaults to the hostname of the node.
+
+  -ring1_addr string
+
+            Hostname (or IP) of the corosync ring1 address, this needs an
+            valid bindnet1_addr.
+
+  -rrp_mode  (active | none | passive)  (default=none)
+
+            This specifies the mode of redundant ring, which may be none,
+            active or passive. Using multiple interfaces only allows
+            'active' or 'passive'.
+
+  -votes     integer (1 - N)
+
+            Number of votes for this node.
+
+
+
+*pvecm delnode* `<node>`
+
+Removes a node to the cluster configuration.
+
+  <node>     string
+
+            The cluster node name.
+
+
+
+*pvecm expected* `<expected>`
+
+Tells corosync a new value of expected votes.
+
+  <expected> integer (1 - N)
+
+            Expected votes
+
+
+
+
+*pvecm help* `[<cmd>]` `[OPTIONS]`
+
+Get help about specified command.
+
+  <cmd>      string
+
+            Command name
+
+  -verbose   boolean
+
+            Verbose output format.
+
+
+
+
+*pvecm keygen* `<filename>`
+
+Generate new cryptographic key for corosync.
+
+  <filename> string
+
+            Output file name
+
+
+
+*pvecm nodes*
+
+Displays the local view of the cluster nodes.
+
+
+
+*pvecm status*
+
+Displays the local view of the cluster status.
+
+
+
+*pvecm updatecerts* `[OPTIONS]`
+
+Update node certificates (and generate all needed files/directories).
+
+  -force     boolean
+
+            Force generation of new SSL certifate.
+
+  -silent    boolean
+
+            Ignore errors (i.e. when cluster has no quorum).
+
+
+
+

diff --git a/pvecm.adoc b/pvecm.adoc
new file mode 100644 (file)
index 0000000..3b2a75d
--- /dev/null
+++ b/pvecm.adoc
@@ -0,0 +1,34 @@
+ifdef::manvolnum[]
+PVE({manvolnum})
+================
+include::attributes.txt[]
+
+NAME
+----
+
+pvecm - Proxmox VE Cluster Manager
+
+SYNOPSYS
+--------
+
+include::pvecm.1-synopsis.adoc[]
+
+DESCRIPTION
+-----------
+endif::manvolnum[]
+
+ifndef::manvolnum[]
+Cluster Manager
+===============
+include::attributes.txt[]
+endif::manvolnum[]
+
+'pvecm' is a program to manage the cluster configuration. It can be
+used to create a new cluster, join nodes to a cluster, leave the
+cluster, get status information and do various other cluster related
+tasks.
+
+
+ifdef::manvolnum[]
+include::pve-copyright.adoc[]
+endif::manvolnum[]