Headless documentation (#3557)

* Add some notes about qemu headless mode

Partly resolves #3530
This commit is contained in:
Brian Candler 2016-05-20 18:01:41 +01:00 committed by Chris Bednarski
parent 24cf28d4b6
commit 56313450a9
2 changed files with 8 additions and 1 deletions

View File

@ -538,7 +538,7 @@ BUG FIXES:
* builder/parallels: Disconnect cdrom0 [GH-1605] * builder/parallels: Disconnect cdrom0 [GH-1605]
* builder/qemu: Don't use `-redir` flag anymore, replace with * builder/qemu: Don't use `-redir` flag anymore, replace with
`hostfwd` options. [GH-1561] `hostfwd` options. [GH-1561]
* builder/qmeu: Use `pc` as default machine type instead of `pc-1.0`. * builder/qemu: Use `pc` as default machine type instead of `pc-1.0`.
* providers/aws: Ignore transient network errors. [GH-1579] * providers/aws: Ignore transient network errors. [GH-1579]
* provisioner/ansible: Don't buffer output so output streams in. [GH-1585] * provisioner/ansible: Don't buffer output so output streams in. [GH-1585]
* provisioner/ansible: Use inventory file always to avoid potentially * provisioner/ansible: Use inventory file always to avoid potentially

View File

@ -78,6 +78,10 @@ In addition to the options listed here, a
[communicator](/docs/templates/communicator.html) can be configured for this [communicator](/docs/templates/communicator.html) can be configured for this
builder. builder.
Note that you will need to set `"headless": true` if you are running Packer
on a Linux server without X11; or if you are connected via ssh to a remote
Linux server and have not enabled X11 forwarding (`ssh -X`).
### Required: ### Required:
- `iso_checksum` (string) - The checksum for the OS ISO file. Because ISO - `iso_checksum` (string) - The checksum for the OS ISO file. Because ISO
@ -167,6 +171,9 @@ builder.
launching a GUI that shows the console of the machine being built. When this launching a GUI that shows the console of the machine being built. When this
value is set to true, the machine will start without a console. value is set to true, the machine will start without a console.
You can still see the console if you make a note of the VNC display
number chosen, and then connect using `vncviewer -Shared <host>:<display>`
- `http_directory` (string) - Path to a directory to serve using an - `http_directory` (string) - Path to a directory to serve using an
HTTP server. The files in this directory will be available over HTTP that HTTP server. The files in this directory will be available over HTTP that
will be requestable from the virtual machine. This is useful for hosting will be requestable from the virtual machine. This is useful for hosting