fix #844: document first VM/CT start-up delay

adds subsection to the "PVE Node Management" section, discussing the
initial VM/CT startup delay feature.

also makes reference to this in the Qemu & LXC sections of the
documentation.

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

diff --git a/pct.adoc b/pct.adoc
index b88569f42f1e9ab75d3ae2b79989f5839d174880..c5ed243b19a05ef9760d81c2499b74d02f4bfc11 100644 (file)
--- a/pct.adoc
+++ b/pct.adoc
@@ -433,6 +433,11 @@ always start after those where the parameter is set, and this parameter only
 makes sense between the machines running locally on a host, and not
 cluster-wide.
 
+If you require a delay between the host boot and the booting of the first
+container, see the section on
+xref:first_guest_boot_delay[Proxmox VE Node Management].
+
+
 Hookscripts
 ~~~~~~~~~~~
 

diff --git a/pvenode.adoc b/pvenode.adoc
index bace13c3d038544814303c1e22ffe8a07e4c12d7..7986fa05a560428a84e23c268ab668c1a8e154d5 100644 (file)
--- a/pvenode.adoc
+++ b/pvenode.adoc
@@ -83,6 +83,24 @@ of `<node>` obtained from the `wakeonlan` property. The node specific
 pvenode config set -wakeonlan XX:XX:XX:XX:XX:XX
 ----
 
+
+[[first_guest_boot_delay]]
+First Guest Boot Delay
+~~~~~~~~~~~~~~~~~~~~~~
+
+In case your VMs/containers rely on slow-to-start external resources, for
+example an NFS server, you can also set a per-node delay between the time {pve}
+boots and the time the first VM/container that is configured to autostart boots
+(see xref:qm_startup_and_shutdown[Automatic Start and Shutdown of Virtual Machines]).
+
+You can achieve this by setting the following (where `10` represents the delay
+in seconds):
+
+----
+pvenode config set --startall-onboot-delay 10
+----
+
+
 // TODO: extend and improve chapter!
 
 ifdef::manvolnum[]

diff --git a/qm.adoc b/qm.adoc
index c291cb0c2774906e5d20a02cbee77754274cf79d..80734e335d8bc3e1f49b0da045a52217b39e5885 100644 (file)
--- a/qm.adoc
+++ b/qm.adoc
@@ -923,6 +923,9 @@ start after those where the parameter is set. Further, this parameter can only
 be enforced between virtual machines running on the same host, not
 cluster-wide.
 
+If you require a delay between the host boot and the booting of the first VM,
+see the section on xref:first_guest_boot_delay[Proxmox VE Node Management].
+
 
 [[qm_qemu_agent]]
 Qemu Guest Agent