Blame SOURCES/0183-p2v-Update-documentation.patch

ffd6ed
From 0c4505463744dafcb2fdecd5d7317f5cdf573d42 Mon Sep 17 00:00:00 2001
ffd6ed
From: "Richard W.M. Jones" <rjones@redhat.com>
ffd6ed
Date: Mon, 8 Jun 2015 14:41:46 +0100
ffd6ed
Subject: [PATCH] p2v: Update documentation.
ffd6ed
ffd6ed
- How to configure virt-p2v for PXE boot.
ffd6ed
ffd6ed
- How to test PXE boot using qemu.
ffd6ed
ffd6ed
(cherry picked from commit cca4343203f18367033a56139231ff2518ad6655)
ffd6ed
---
ffd6ed
 p2v/virt-p2v-make-kickstart.pod | 42 ++++++++++++++++++++++++++++++++++++++++-
ffd6ed
 p2v/virt-p2v.pod                |  4 ++--
ffd6ed
 2 files changed, 43 insertions(+), 3 deletions(-)
ffd6ed
ffd6ed
diff --git a/p2v/virt-p2v-make-kickstart.pod b/p2v/virt-p2v-make-kickstart.pod
ffd6ed
index a17c34c..47ca737 100644
ffd6ed
--- a/p2v/virt-p2v-make-kickstart.pod
ffd6ed
+++ b/p2v/virt-p2v-make-kickstart.pod
ffd6ed
@@ -120,7 +120,9 @@ containing the files required to PXE boot virt-p2v:
ffd6ed
  tftpboot/pxelinux.cfg:
ffd6ed
  default
ffd6ed
 
ffd6ed
-=head1 TESTING THE P2V ISO USING QEMU
ffd6ed
+=head1 TESTING VIRT-P2V USING QEMU
ffd6ed
+
ffd6ed
+=head2 TESTING THE P2V ISO USING QEMU
ffd6ed
 
ffd6ed
 You can use qemu to test-boot the P2V ISO:
ffd6ed
 
ffd6ed
@@ -130,6 +132,44 @@ Note that C<-hda> is the (virtual) system that you want to convert
ffd6ed
 (for test purposes).  It could be any guest type supported by
ffd6ed
 L<virt-v2v(1)>, including Windows or Red Hat Enterprise Linux.
ffd6ed
 
ffd6ed
+=head2 TESTING PXE SUPPORT USING QEMU
ffd6ed
+
ffd6ed
+=over 4
ffd6ed
+
ffd6ed
+=item *
ffd6ed
+
ffd6ed
+Unpack the tftpboot directory into C</tmp> (so it appears as
ffd6ed
+C</tmp/tftpboot>).
ffd6ed
+
ffd6ed
+=item *
ffd6ed
+
ffd6ed
+Copy C<pxelinux.0> and C<ldlinux.c32> from syslinux (usually from
ffd6ed
+C</usr/share/syslinux>) into C</tmp/tftpboot>.
ffd6ed
+
ffd6ed
+=item *
ffd6ed
+
ffd6ed
+Adjust the C<APPEND> line in C</tmp/tftpboot/pxelinux.cfg/default> if
ffd6ed
+required.  See L<virt-p2v(1)/KERNEL COMMAND LINE CONFIGURATION>.
ffd6ed
+
ffd6ed
+=item *
ffd6ed
+
ffd6ed
+Run qemu like this so that it acts as a TFTP and BOOTP server,
ffd6ed
+emulating a netboot:
ffd6ed
+
ffd6ed
+ qemu-kvm \
ffd6ed
+     -m 4096 -hda /tmp/guest.img \
ffd6ed
+     -boot n \
ffd6ed
+     -netdev user,id=unet,tftp=/tmp/tftpboot,bootfile=/pxelinux.0 \
ffd6ed
+     -device virtio-net-pci,netdev=unet \
ffd6ed
+     -serial stdio
ffd6ed
+
ffd6ed
+Note that this requires considerably more memory because the PXE image
ffd6ed
+is loaded into memory.  Also that qemu's TFTP server is very slow and
ffd6ed
+the virt-p2v PXE image is very large, so it can appear to "hang" after
ffd6ed
+pxelinux starts up.
ffd6ed
+
ffd6ed
+=back
ffd6ed
+
ffd6ed
 =head1 OPTIONS
ffd6ed
 
ffd6ed
 =over 4
ffd6ed
diff --git a/p2v/virt-p2v.pod b/p2v/virt-p2v.pod
ffd6ed
index 15e68bd..9c1dba1 100644
ffd6ed
--- a/p2v/virt-p2v.pod
ffd6ed
+++ b/p2v/virt-p2v.pod
ffd6ed
@@ -288,8 +288,8 @@ in the C<pxelinux.cfg> file.  For example:
ffd6ed
  TIMEOUT 20
ffd6ed
  PROMPT 0
ffd6ed
  LABEL p2v
ffd6ed
-   KERNEL virt-p2v-vmlinuz
ffd6ed
-   APPEND initrd=virt-p2v-initrd p2v.server=conv.example.com p2v.password=secret p2v.o=libvirt
ffd6ed
+   KERNEL vmlinuz0
ffd6ed
+   APPEND initrd=initrd0.img [....] p2v.server=conv.example.com p2v.password=secret p2v.o=libvirt
ffd6ed
 
ffd6ed
 You have to set some or all of the following command line arguments:
ffd6ed
 
ffd6ed
-- 
ffd6ed
1.8.3.1
ffd6ed