| 1 | <?xml version='1.0' encoding='UTF-8'?>
|
|---|
| 2 | <!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
|
|---|
| 3 | <topic xml:lang="en-us" id="ovf-import-appliance">
|
|---|
| 4 | <title>Importing an Appliance in OVF Format</title>
|
|---|
| 5 |
|
|---|
| 6 | <body>
|
|---|
| 7 | <p>The following steps show how to import an appliance in OVF format. </p>
|
|---|
| 8 | <ol>
|
|---|
| 9 | <li>
|
|---|
| 10 | <p>Double-click the OVF or OVA file. </p>
|
|---|
| 11 | <p><ph conkeyref="vbox-conkeyref-phrases/product-name"/> creates file type associations automatically for any
|
|---|
| 12 | OVF and OVA files on your host OS. </p>
|
|---|
| 13 | <p>The <b outputclass="bold">Appliance Settings</b> page of the <b outputclass="bold">Import Virtual
|
|---|
| 14 | Appliance</b> wizard is shown. </p>
|
|---|
| 15 | <fig id="fig-import-appliance">
|
|---|
| 16 | <title>Import Virtual Appliance Wizard: Appliance Settings</title>
|
|---|
| 17 | <xref href="images/ovf-import.png" format="png" platform="htmlhelp">
|
|---|
| 18 | <image href="images/ovf-import.png" width="12cm" placement="break">
|
|---|
| 19 | <alt>Import Virtual Appliance Wizard: Appliance Settings</alt>
|
|---|
| 20 | </image>
|
|---|
| 21 | </xref>
|
|---|
| 22 | <image platform="ohc" href="images/ovf-import.png" width="12cm" placement="break">
|
|---|
| 23 | <alt>Import Virtual Appliance Wizard: Appliance Settings</alt>
|
|---|
| 24 | </image>
|
|---|
| 25 | </fig>
|
|---|
| 26 | </li>
|
|---|
| 27 | <li>
|
|---|
| 28 | <p>The <b outputclass="bold">Appliance Settings</b> page shows the VMs described in the OVF or OVA file and
|
|---|
| 29 | enables you to change the VM settings. </p>
|
|---|
| 30 | <p>By default, membership of VM groups is preserved on import for VMs that were initially exported from <ph
|
|---|
| 31 | conkeyref="vbox-conkeyref-phrases/product-name"/>. You can change this behavior by using the <b
|
|---|
| 32 | outputclass="bold">Primary Group</b> setting for the VM. </p>
|
|---|
| 33 | <p>The following global settings apply to all of the VMs that you import: </p>
|
|---|
| 34 | <ul>
|
|---|
| 35 | <li>
|
|---|
| 36 | <p><b outputclass="bold">Base Folder:</b> Specifies
|
|---|
| 37 | the directory on the host in which to store the imported
|
|---|
| 38 | VMs.
|
|---|
| 39 | </p>
|
|---|
| 40 | <p>If an appliance has multiple VMs, you can specify a different directory for each VM by editing the <b
|
|---|
| 41 | outputclass="bold">Base Folder</b> setting for the VM. </p>
|
|---|
| 42 | </li>
|
|---|
| 43 | <li>
|
|---|
| 44 | <p><b outputclass="bold">MAC Address Policy:</b>
|
|---|
| 45 | Reinitializes the MAC addresses of network cards in your
|
|---|
| 46 | VMs prior to import, by default. You can override the
|
|---|
| 47 | default behavior and preserve the MAC addresses on
|
|---|
| 48 | import.
|
|---|
| 49 | </p>
|
|---|
| 50 | </li>
|
|---|
| 51 | <li>
|
|---|
| 52 | <p><b outputclass="bold">Import Hard Drives as
|
|---|
| 53 | VDI:</b> Imports hard drives in the VDI format
|
|---|
| 54 | rather than in the default VMDK format.
|
|---|
| 55 | </p>
|
|---|
| 56 | </li>
|
|---|
| 57 | </ul>
|
|---|
| 58 | </li>
|
|---|
| 59 | <li>
|
|---|
| 60 | <p>Click <b outputclass="bold">Finish</b> to import the appliance. </p>
|
|---|
| 61 | <p><ph conkeyref="vbox-conkeyref-phrases/product-name"/> copies the disk images and creates local VMs with the
|
|---|
| 62 | settings described on the <b outputclass="bold">Appliance Settings</b> page. The imported VMs are shown in the
|
|---|
| 63 | list of VMs in VirtualBox Manager. </p>
|
|---|
| 64 | <p>Because disk images are large, the VMDK images that are included with virtual appliances are shipped in a
|
|---|
| 65 | compressed format that cannot be used directly by VMs. So, the images are first unpacked and copied, which
|
|---|
| 66 | might take several minutes. </p>
|
|---|
| 67 | </li>
|
|---|
| 68 | </ol>
|
|---|
| 69 | <p>You can use the <userinput>VBoxManage import</userinput> command to import an appliance. See <xref
|
|---|
| 70 | href="vboxmanage-import.dita"/>. </p>
|
|---|
| 71 | </body>
|
|---|
| 72 |
|
|---|
| 73 | </topic>
|
|---|
