diff --git a/website/source/docs/builders/parallels-iso.html.markdown b/website/source/docs/builders/parallels-iso.html.markdown index a79c96813..9f8cb4400 100644 --- a/website/source/docs/builders/parallels-iso.html.markdown +++ b/website/source/docs/builders/parallels-iso.html.markdown @@ -26,10 +26,11 @@ Ubuntu to self-install. Still, the example serves to show the basic configuratio
{
"type": "parallels-iso",
- "guest_os_type": "Ubuntu_64",
+ "guest_os_type": "ubuntu",
"iso_url": "http://releases.ubuntu.com/12.04/ubuntu-12.04.3-server-amd64.iso",
"iso_checksum": "2cbe868812a871242cdcdd8f2fd6feb9",
"iso_checksum_type": "md5",
+ "parallels_tools_flavor": "lin"
"ssh_username": "packer",
"ssh_password": "packer",
"ssh_wait_timeout": "30s",
@@ -68,6 +69,10 @@ each category, the available options are alphabetized and described.
* `ssh_username` (string) - The username to use to SSH into the machine
once the OS is installed.
+* `parallels_tools_flavor` (string) - The flavor of the Parallels Tools ISO to
+ install into the VM. Valid values are "win", "lin", "mac", "os2" and "other".
+ This can be ommited only if `parallels_tools_mode` is "disable".
+
### Optional:
* `boot_command` (array of strings) - This is an array of commands to type
@@ -96,17 +101,10 @@ each category, the available options are alphabetized and described.
characters (*, ?, and []) are allowed. Directory names are also allowed,
which will add all the files found in the directory to the floppy.
-* `guest_os_distribution` (string) - The guest OS distribution being
- installed. By default this is "other", but you can get dramatic
- performance improvements by setting this to the proper value. To
- view all available values for this run `prlctl create x --distribution list`.
- Setting the correct value hints to Parallels how to optimize the virtual
- hardware to work best with that operating system.
-
* `guest_os_type` (string) - The guest OS type being installed. By default
this is "other", but you can get _dramatic_ performance improvements by
setting this to the proper value. To view all available values for this
- run `prlctl create x --ostype list`. Setting the correct value hints to
+ run `prlctl create x --distribution list`. Setting the correct value hints to
Parallels Desktop how to optimize the virtual hardware to work best with
that operating system.
@@ -148,18 +146,14 @@ each category, the available options are alphabetized and described.
By default this is "output-BUILDNAME" where "BUILDNAME" is the name
of the build.
-* `parallels_tools_guest_path` (string) - The path on the guest virtual machine
- where the Parallels tools ISO will be uploaded. By default this is
- "prl-tools.iso" which should upload into the login directory of the user.
- This is a configuration template where the `Version` variable is replaced
- with the prlctl version.
+* `parallels_tools_guest_path` (string) - The path in the VM to upload Parallels
+ Tools. This only takes effect if `parallels_tools_mode` is not "disable".
+ This is a [configuration template](/docs/templates/configuration-templates.html)
+ that has a single valid variable: `Flavor`, which will be the value of
+ `parallels_tools_flavor`. By default the upload path is set to
+ `prl-tools-{{.Flavor}}.iso`.
-* `parallels_tools_host_path` (string) - The path to the Parallels Tools ISO to
- upload. By default the Parallels builder will use the "other" OS tools ISO from
- the Parallels installation:
- "/Applications/Parallels Desktop.app/Contents/Resources/Tools/prl-tools-other.iso"
-
-* `parallels_tools_mode` (string) - The method by which Parallels tools are
+* `parallels_tools_mode` (string) - The method by which Parallels Tools are
made available to the guest for installation. Valid options are "upload",
"attach", or "disable". The functions of each of these should be
self-explanatory. The default value is "upload".
@@ -260,20 +254,12 @@ an Ubuntu 12.04 installer:
]
-## Parallels Tools
-After the virtual machine is up and the operating system is installed, Packer
-uploads the Parallels Tools into the virtual machine. The path where they are
-uploaded is controllable by `parallels_tools_path`, and defaults to
-"prl-tools.iso". Without an absolute path, it is uploaded to the home directory
-of the SSH user. Parallels Tools ISO's can be found in:
-"/Applications/Parallels Desktop.app/Contents/Resources/Tools/"
-
## prlctl Commands
In order to perform extra customization of the virtual machine, a template can
define extra calls to `prlctl` to perform.
-[prlctl](http://download.parallels.com/desktop/v4/wl/docs/en/Parallels_Command_Line_Reference_Guide/)
-is the command-line interface to Parallels. It can be used to do things such as
-set RAM, CPUs, etc.
+[prlctl](http://download.parallels.com/desktop/v9/ga/docs/en_US/Parallels%20Command%20Line%20Reference%20Guide.pdf)
+is the command-line interface to Parallels Desktop. It can be used to configure
+the virtual machine, such as set RAM, CPUs, etc.
Extra `prlctl` commands are defined in the template in the `prlctl` section.
An example is shown below that sets the memory and number of CPUs within the
diff --git a/website/source/docs/builders/parallels-pvm.html.markdown b/website/source/docs/builders/parallels-pvm.html.markdown
index 74a81e9d3..8b0624291 100644
--- a/website/source/docs/builders/parallels-pvm.html.markdown
+++ b/website/source/docs/builders/parallels-pvm.html.markdown
@@ -25,6 +25,7 @@ the settings here.
{
"type": "parallels-pvm",
+ "parallels_tools_flavor": "lin"
"source_path": "source.pvm",
"ssh_username": "packer",
"ssh_password": "packer",
@@ -51,6 +52,10 @@ each category, the available options are alphabetized and described.
* `ssh_username` (string) - The username to use to SSH into the machine
once the OS is installed.
+* `parallels_tools_flavor` (string) - The flavor of the Parallels Tools ISO to
+ install into the VM. Valid values are "win", "lin", "mac", "os2" and "other".
+ This can be ommited only if `parallels_tools_mode` is "disable".
+
### Optional:
* `boot_command` (array of strings) - This is an array of commands to type
@@ -80,18 +85,14 @@ each category, the available options are alphabetized and described.
By default this is "output-BUILDNAME" where "BUILDNAME" is the name
of the build.
-* `parallels_tools_guest_path` (string) - The path on the guest virtual machine
- where the Parallels tools ISO will be uploaded. By default this is
- "prl-tools.iso" which should upload into the login directory of the user.
- This is a configuration template where the `Version` variable is replaced
- with the prlctl version.
-
-* `parallels_tools_host_path` (string) - The path to the Parallels Tools ISO to
- upload. By default the Parallels builder will use the "other" OS tools ISO from
- the Parallels installation:
- "/Applications/Parallels Desktop.app/Contents/Resources/Tools/prl-tools-other.iso"
+* `parallels_tools_guest_path` (string) - The path in the VM to upload Parallels
+ Tools. This only takes effect if `parallels_tools_mode` is not "disable".
+ This is a [configuration template](/docs/templates/configuration-templates.html)
+ that has a single valid variable: `Flavor`, which will be the value of
+ `parallels_tools_flavor`. By default the upload path is set to
+ `prl-tools-{{.Flavor}}.iso`.
-* `parallels_tools_mode` (string) - The method by which Parallels tools are
+* `parallels_tools_mode` (string) - The method by which Parallels Tools are
made available to the guest for installation. Valid options are "upload",
"attach", or "disable". The functions of each of these should be
self-explanatory. The default value is "upload".
@@ -179,9 +180,9 @@ The available variables are:
## prlctl Commands
In order to perform extra customization of the virtual machine, a template can
define extra calls to `prlctl` to perform.
-[prlctl](http://download.parallels.com/desktop/v4/wl/docs/en/Parallels_Command_Line_Reference_Guide/)
-is the command-line interface to Parallels. It can be used to do things such as
-set RAM, CPUs, etc.
+[prlctl](http://download.parallels.com/desktop/v9/ga/docs/en_US/Parallels%20Command%20Line%20Reference%20Guide.pdf)
+is the command-line interface to Parallels Desktop. It can be used to configure
+the virtual machine, such as set RAM, CPUs, etc.
Extra `prlctl` commands are defined in the template in the `prlctl` section.
An example is shown below that sets the memory and number of CPUs within the