From 90a12f70433d96d2e417887ad76ef324c81c447a Mon Sep 17 00:00:00 2001 From: Chris Bednarski Date: Wed, 20 Apr 2016 12:34:53 -0700 Subject: [PATCH] Clarified that windows must be fully booted in order for the restart provisioner to succeed --- .../docs/provisioners/windows-restart.html.md | 22 ++++++++++++------- 1 file changed, 14 insertions(+), 8 deletions(-) diff --git a/website/source/docs/provisioners/windows-restart.html.md b/website/source/docs/provisioners/windows-restart.html.md index 05377ca23..3f736c94e 100644 --- a/website/source/docs/provisioners/windows-restart.html.md +++ b/website/source/docs/provisioners/windows-restart.html.md @@ -1,7 +1,7 @@ --- description: | - The Windows restart provisioner restarts a Windows machine and waits for it to - come back up. + The Windows restart provisioner restarts a Windows machine and waits for it + to come back up. layout: docs page_title: Windows Restart Provisioner ... @@ -16,6 +16,10 @@ waits for the machine to come back online. The Windows provisioning process often requires multiple reboots, and this provisioner helps to ease that process. +Packer expects the machine to be ready to continue provisioning after it +reboots. Packer detects that the reboot has completed by making an RPC call +through the Windows Remote Management (WinRM) service, not by ACPI functions, so Windows must be completely booted in order to continue. + ## Basic Example The example below is fully functional. @@ -32,13 +36,15 @@ The reference of available configuration options is listed below. Optional parameters: -- `restart_command` (string) - The command to execute to initiate the restart. - By default this is `shutdown /r /c "packer restart" /t 5 && net stop winrm`. - A key action of this is to stop WinRM so that Packer can detect it - is rebooting. +- `restart_command` (string) - The command to execute to initiate the + restart. By default this is `shutdown /r /c "packer restart" /t 5 && net + stop winrm`. A key action of this is to stop WinRM so that Packer can + detect it is rebooting. - `restart_check_command` (string) - A command to execute to check if the restart succeeded. This will be done in a loop. -- `restart_timeout` (string) - The timeout to wait for the restart. By default - this is 5 minutes. Example value: "5m" +- `restart_timeout` (string) - The timeout to wait for the restart. By + default this is 5 minutes. Example value: `5m`. If you are installing + updates or have a lot of startup services, you will probably need to + increase this duration.