You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@brooklyn.apache.org by al...@apache.org on 2015/09/25 18:12:23 UTC
[1/2] incubator-brooklyn git commit: winrm docs: more tips/limitations
Repository: incubator-brooklyn
Updated Branches:
refs/heads/master d3cefa381 -> 0c85cd90a
winrm docs: more tips/limitations
Project: http://git-wip-us.apache.org/repos/asf/incubator-brooklyn/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-brooklyn/commit/36c5df12
Tree: http://git-wip-us.apache.org/repos/asf/incubator-brooklyn/tree/36c5df12
Diff: http://git-wip-us.apache.org/repos/asf/incubator-brooklyn/diff/36c5df12
Branch: refs/heads/master
Commit: 36c5df125dd5b1194fcff4db52f5c7c78dfcb596
Parents: d3cefa3
Author: Aled Sage <al...@gmail.com>
Authored: Fri Sep 25 14:29:54 2015 +0100
Committer: Aled Sage <al...@gmail.com>
Committed: Fri Sep 25 17:08:16 2015 +0100
----------------------------------------------------------------------
docs/guide/yaml/winrm/index.md | 42 +++++++++++++++++++++++++++++++++++++
1 file changed, 42 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-brooklyn/blob/36c5df12/docs/guide/yaml/winrm/index.md
----------------------------------------------------------------------
diff --git a/docs/guide/yaml/winrm/index.md b/docs/guide/yaml/winrm/index.md
index 2a6ce6a..a29d75a 100644
--- a/docs/guide/yaml/winrm/index.md
+++ b/docs/guide/yaml/winrm/index.md
@@ -355,6 +355,18 @@ refer to [How and Why to re-authenticate withing a powershell script](#how-and-w
If using the imageId of a Windows community AMI, you may find that the AMI is deleted after a few weeks.
See [Windows AMIs on AWS](#windows-amis-on-aws) above.
+### VM Provisioning Times Out
+
+In some environments, provisioning of Windows VMs can take a very long time to return a usable VM.
+If the image is old, it may install many security updates (and reboot several times) before it is
+usable.
+
+On a VMware vCloud Director environment, the guest customizations can cause the VM to reboot (sometimes
+several times) before the VM is usable.
+
+This could cause the WinRM connection attempts to timeout. The location configuration option
+`waitForWinRmAvailable` defaults to `30m` (i.e. 30 minutes). This can be increased if required.
+
### Windows log files
Details of the commands executed, and their results, can be found in the Brooklyn log and in the Brooklyn
@@ -416,6 +428,36 @@ If a batch or Powershell file exits with an exit code greater than one (or negat
be reported as 1 over WinRM. For example, if a batch file ends with `exit /B 3`, the WinRM
result from executing that file will be 1.
+### PowerShell "Preparing modules for first use"
+
+The first command executed over WinRM has been observed to include stderr saying "Preparing
+modules for first use", such as that below:
+
+ < CLIXML
+ <Objs Version="1.1.0.1" xmlns="http://schemas.microsoft.com/powershell/2004/04"><Obj S="progress" RefId="0"><TN RefId="0"><T>System.Management.Automation.PSCustomObject</T><T>System.Object</T></TN><MS><I64 N="SourceId">1</I64><PR N="Record"><AV>Preparing modules for first use.</AV><AI>0</AI><Nil /><PI>-1</PI><PC>-1</PC><T>Completed</T><SR>-1</SR><SD> </SD></PR></MS></Obj><Obj S="progress" RefId="1"><TNRef RefId="0" /><MS><I64 N="SourceId">2</I64><PR N="Record"><AV>Preparing modules for first use.</AV><AI>0</AI><Nil /><PI>-1</PI><PC>-1</PC><T>Completed</T><SR>-1</SR><SD> </SD></PR></MS></Obj></Objs>
+
+The command still succeeded. This has only been observed on private clouds (e.g. not on
+AWS). It could be related to the specific Windows images in use. It is recommended that
+VM images are prepared carefully, e.g. so that security patches are up-to-date and the
+VM is suitably initialised.
+
+### WinRM executeScript failed: httplib.BadStatusLine: ''
+
+As described in https://issues.apache.org/jira/browse/BROOKLYN-173, a failure has been
+observed where the 10 attempts to execute the command over WinRM failed with:
+
+ httplib.BadStatusLine: ''
+
+Subsequently retrying the command worked. It is unclear what caused the failure, but could
+have been that the Windows VM was not yet in the right state.
+
+One possible workaround is to ensure the Windows VM is in a good state for immediate use (e.g.
+security updates are up-to-date). Another option is to increase the number of retries,
+which defaults to 10. This is a configuration option on the machine location, so can be set on
+the location's brooklyn.properties or in the YAML:
+
+ execTries: 20
+
### Direct Configuration of Multi-line Batch Commands Not Executed
If a command is directly configured with multi-line batch commands, then only the first line
[2/2] incubator-brooklyn git commit: This closes #921
Posted by al...@apache.org.
This closes #921
Project: http://git-wip-us.apache.org/repos/asf/incubator-brooklyn/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-brooklyn/commit/0c85cd90
Tree: http://git-wip-us.apache.org/repos/asf/incubator-brooklyn/tree/0c85cd90
Diff: http://git-wip-us.apache.org/repos/asf/incubator-brooklyn/diff/0c85cd90
Branch: refs/heads/master
Commit: 0c85cd90a7678baec73c62e238d94166d9dae817
Parents: d3cefa3 36c5df1
Author: Aled Sage <al...@gmail.com>
Authored: Fri Sep 25 17:12:12 2015 +0100
Committer: Aled Sage <al...@gmail.com>
Committed: Fri Sep 25 17:12:12 2015 +0100
----------------------------------------------------------------------
docs/guide/yaml/winrm/index.md | 42 +++++++++++++++++++++++++++++++++++++
1 file changed, 42 insertions(+)
----------------------------------------------------------------------