Updated PO files.
[virt-p2v.git] / virt-p2v.pod
index 3018389..5b57631 100644 (file)
@@ -27,14 +27,18 @@ machine over the network to the virtualization host machine over ssh.
 Therefore C<sshd> must be running on the virtualization host, and must
 be accessible to that host.  See B<SERVER REQUIREMENTS> section below.
 
-The C<virt-p2v> 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.
+The C<virt-p2v> 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.
 
 Virt-p2v does not modify the physical machine, its disks,
 configuration etc.
 
+USB key and PXE boot options are also available.  See sections
+B<PXE BOOTING> and B<BOOTING FROM A USB KEY>
+below.
+
 =head1 STANDARD USAGE
 
 After booting the live CD-R, you are presented with a series of
@@ -187,6 +191,17 @@ addresses are not tested for uniqueness so there is a very small
 chance that they could coincide, which would leave a guest unable to
 access the virtual network.
 
+=item Compression
+
+Choose whether to enable or disable compression on disk images as they
+are copied across the network.
+
+If enabled, the C<-C> option is passed to L<ssh(1)>.  On fast networks
+this can sometimes be slower.
+
+NB: The disk image is still stored uncompressed on the remote host
+however this option is set.
+
 =item Verify and proceed
 
 In this step you are asked to verify the settings above.  If any are
@@ -436,6 +451,11 @@ reserved for Xen guests.  These MAC addresses are not tested for
 uniqueness so there is a very small chance that they could coincide,
 which would leave a guest unable to access the virtual network.
 
+=item C<compression>
+
+Set this to C<Some false> to disable compression, or C<Some true> to
+enable compression, or C<None> to ask the user.
+
 =back
 
 =head2 ISO ATTACHMENTS
@@ -453,10 +473,28 @@ or the equivalent manual command:
 
  ./iso-attach virt-p2v-VERSION.iso virt-p2v
 
-=head1 BOOTING FROM A USB KEY INSTEAD OF A CD
+Note that ISO attachments only work with real (and emulated) CD-Rs,
+not with other methods of booting such as USB keys and PXE.
+
+=head1 PXE BOOTING
+
+If you wish to boot over the network using PXE, use the
+C<livecd-iso-to-pxeboot> script (part of C<livecd-tools>).
+
+ livecd-iso-to-pxeboot virt-p2v-$VERSION.iso
+
+then copy the generated subdirectory C<tftpboot/> to the
+right place for your PXE configuration.
+
+Pre-built PXE boot images are also available on the website.
+
+General configuration of DHCP, TFTP and PXE for network booting are
+outside the scope of this document.
+
+=head1 BOOTING FROM A USB KEY
 
-If you wish to boot from a USB keydrive, use the livecd-iso-to-disk
-tool:
+If you wish to boot from a USB keydrive, use the C<livecd-iso-to-disk>
+script (part of C<livecd-tools>):
 
  livecd-iso-to-disk virt-p2v-$VERSION.iso /dev/sdX1