<li><a href="#iso_attachments">ISO ATTACHMENTS</a></li>
</ul>
- <li><a href="#booting_from_a_usb_key_instead_of_a_cd">BOOTING FROM A USB KEY INSTEAD OF A CD</a></li>
+ <li><a href="#pxe_booting">PXE BOOTING</a></li>
+ <li><a href="#booting_from_a_usb_key">BOOTING FROM A USB KEY</a></li>
<li><a href="#testing_an_iso_under_qemu_or_kvm">TESTING AN ISO UNDER QEMU OR KVM</a></li>
+ <li><a href="#mailing_list">MAILING LIST</a></li>
<li><a href="#see_also">SEE ALSO</a></li>
<li><a href="#authors">AUTHORS</a></li>
<li><a href="#copyright">COPYRIGHT</a></li>
machine over the network to the virtualization host machine over ssh.
Therefore <code>sshd</code> must be running on the virtualization host, and must
be accessible to that host. See <strong>SERVER REQUIREMENTS</strong> section below.</p>
-<p>The <code>virt-p2v</code> script must only be run from the live CD. It isn't
-designed to run outside this environment and could do Bad Things to
-your machine if you try it. The script contains some checks to try to
-stop you from doing this.</p>
+<p>The <code>virt-p2v</code> script must only be run from the live CD environment.
+It isn't designed to run outside this environment and could do Bad
+Things to your machine if you try it. The script contains some checks
+to try to stop you from doing this.</p>
<p>Virt-p2v does not modify the physical machine, its disks,
configuration etc.</p>
+<p>USB key and PXE boot options are also available. See sections
+<strong>PXE BOOTING</strong> and <strong>BOOTING FROM A USB KEY</strong>
+below.</p>
<p>
</p>
<hr />
this method even though occasionally it does not work.</p>
</dd>
</li>
+<dt><strong><a name="item_ask_for_fixed_ip_address_and_gateway">Ask for fixed IP address and gateway</a></strong>
+
+<dd>
+<p>In this mode the live CD will ask you for a fixed IP address and
+gateway address, and will configure your chosen interface with these.</p>
+</dd>
+</li>
<dt><strong><a name="item_configure_from_the_shell">Configure from the shell</a></strong>
<dd>
gateway.</p>
</dd>
</li>
+<dt><strong><a name="item_qemu_user_network">QEMU user network</a></strong>
+
+<dd>
+<p>This option configures the network for use inside a QEMU user network
+(<a href="http://fabrice.bellard.free.fr/qemu/qemu-doc.html#SEC30">http://fabrice.bellard.free.fr/qemu/qemu-doc.html#SEC30</a>). It
+should only be used by developers.</p>
+</dd>
+</li>
</dl>
<dt><strong><a name="item_devices">Devices</a></strong>
access the virtual network.</p>
</dd>
</li>
+<dt><strong><a name="item_compression">Compression</a></strong>
+
+<dd>
+<p>Choose whether to enable or disable compression on disk images as they
+are copied across the network.</p>
+</dd>
+<dd>
+<p>If enabled, the <code>-C</code> option is passed to <em>ssh(1)</em>. On fast networks
+this can sometimes be slower.</p>
+</dd>
+<dd>
+<p>NB: The disk image is still stored uncompressed on the remote host
+however this option is set.</p>
+</dd>
+</li>
<dt><strong><a name="item_verify_and_proceed">Verify and proceed</a></strong>
<dd>
<dt><strong><a name="item_network"><code>network</code></a></strong>
<dd>
-<p>Set this to the choice for network setup. Use either <code>Some Auto</code> or
-<code>Some Shell</code> for auto-configuration or shell (manual) configuration
-respectively.</p>
+<p>Set this to the choice for network setup. Use one of:</p>
+</dd>
+<dl>
+<dt><strong><a name="item_some_auto"><code>Some Auto</code></a></strong>
+
+<dd>
+<p>for auto-configuration</p>
+</dd>
+</li>
+<dt><strong><a name="item_some_static"><code>Some Static</code></a></strong>
+
+<dd>
+<p>to specify the interface, address, netmask and gateway statically</p>
+</dd>
+</li>
+<dt><strong><a name="item_some_shell"><code>Some Shell</code></a></strong>
+
+<dd>
+<p>to launch a shell</p>
+</dd>
+</li>
+<dt><strong><a name="item_some_qemuusernet"><code>Some QEMUUserNet</code></a></strong>
+
+<dd>
+<p>to use a QEMU user network (developers only)</p>
+</dd>
+</li>
+</dl>
+<dt><strong><a name="item_static_network_config"><code>static_network_config</code></a></strong>
+
+<dd>
+<p>This setting only applies if <a href="#item_network"><code>network</code></a> is set to <a href="#item_some_static"><code>Some Static</code></a>,
+in which case you should set this to the static network settings,
+a tuple of (interface, address, netmask, gateway, nameserver):</p>
+</dd>
+<dd>
+<pre>
+ Some ("eth0", "192.168.2.5", "255.255.255.0", "192.168.2.1", "192.168.2.1")</pre>
</dd>
</li>
<dt><strong><a name="item_hypervisor"><code>hypervisor</code></a></strong>
which would leave a guest unable to access the virtual network.</p>
</dd>
</li>
+<dt><strong><a name="item_compression"><code>compression</code></a></strong>
+
+<dd>
+<p>Set this to <code>Some false</code> to disable compression, or <code>Some true</code> to
+enable compression, or <code>None</code> to ask the user.</p>
+</dd>
+</li>
</dl>
<p>
</p>
<p>or the equivalent manual command:</p>
<pre>
./iso-attach virt-p2v-VERSION.iso virt-p2v</pre>
+<p>Note that ISO attachments only work with real (and emulated) CD-Rs,
+not with other methods of booting such as USB keys and PXE.</p>
+<p>
+</p>
+<hr />
+<h1><a name="pxe_booting">PXE BOOTING</a></h1>
+<p>If you wish to boot over the network using PXE, use the
+<code>livecd-iso-to-pxeboot</code> script (part of <code>livecd-tools</code>).</p>
+<pre>
+ livecd-iso-to-pxeboot virt-p2v-$VERSION.iso</pre>
+<p>then copy the generated subdirectory <code>tftpboot/</code> to the
+right place for your PXE configuration.</p>
+<p>Pre-built PXE boot images are also available on the website.</p>
+<p>General configuration of DHCP, TFTP and PXE for network booting are
+outside the scope of this document.</p>
<p>
</p>
<hr />
-<h1><a name="booting_from_a_usb_key_instead_of_a_cd">BOOTING FROM A USB KEY INSTEAD OF A CD</a></h1>
-<p>If you wish to boot from a USB keydrive, use the livecd-iso-to-disk
-tool:</p>
+<h1><a name="booting_from_a_usb_key">BOOTING FROM A USB KEY</a></h1>
+<p>If you wish to boot from a USB keydrive, use the <code>livecd-iso-to-disk</code>
+script (part of <code>livecd-tools</code>):</p>
<pre>
livecd-iso-to-disk virt-p2v-$VERSION.iso /dev/sdX1</pre>
<p>(Replace /dev/sdX1 with the actual USB device).</p>
<p>
</p>
<hr />
+<h1><a name="mailing_list">MAILING LIST</a></h1>
+<p>Please direct questions to the et-mgmt-tools mailing list
+<a href="http://www.redhat.com/mailman/listinfo/et-mgmt-tools">http://www.redhat.com/mailman/listinfo/et-mgmt-tools</a>
+<et-mgmt-tools @ redhat . com></p>
+<p>
+</p>
+<hr />
<h1><a name="see_also">SEE ALSO</a></h1>
<p><em>virsh(1)</em>,
<a href="http://www.libvirt.org/ocaml/">http://www.libvirt.org/ocaml/</a>,
git.annexia.org / virt-p2v.git / blobdiff