README

   1 virt-p2v : P2V ("physical to virtual") migration tool
   2 ----------------------------------------------------------------------
   3
   4 Written by Richard W.M. Jones <rjones@redhat.com>
   5
   6 Copyright (C) 2007-2008 Red Hat Inc.
   7
   8         http://et.redhat.com/~rjones/virt-p2v/
   9
  10 Support
  11 ----------------------------------------------------------------------
  12
  13 Please send all queries, patches, bug reports etc. to the
  14 et-mgmt-tools mailing list:
  15
  16         http://www.redhat.com/mailman/listinfo/et-mgmt-tools
  17
  18
  19 Binaries
  20 ----------------------------------------------------------------------
  21
  22 Binaries are available from the website (live CD images which can be
  23 burned directly to a CD and booted on the p2v candidate machine).
  24
  25        http://et.redhat.com/~rjones/virt-p2v/download.html
  26
  27
  28 Usage
  29 ----------------------------------------------------------------------
  30
  31 Please read the manual page:
  32
  33        man virt-p2v
  34 or     make man; nroff -man virt-p2v.1 | less
  35 or     http://et.redhat.com/~rjones/virt-p2v/virt-p2v.1.html
  36
  37
  38 Building
  39 ----------------------------------------------------------------------
  40
  41 Requirements:
  42
  43  * livecd-creator (in Fedora the package is called 'livecd-tools')
  44  * rpmbuild (in Fedora package rpm-build)
  45  * ocaml, ocaml-findlib, ocaml-extlib, ocaml-pcre, ocaml-xml-light,
  46    ocaml-newt, ocaml-libvirt, ocaml-fileutils, ocaml-gettext,
  47    ocaml-gettext-devel (all in Fedora)
  48  * qemu and/or KVM (only for testing)
  49
  50 Then:
  51
  52         ./configure --help
  53         ./configure
  54         make
  55
  56 Then:
  57
  58         make rpm        builds the virt-p2v RPM
  59         make build      (AS ROOT) builds an ISO image
  60                         called virt-p2v-$VERSION.iso
  61
  62 Other useful commands:
  63
  64         make man        Build manual page
  65         make pxe        Make a PXE-boot image in tftpboot/ subdirectory
  66
  67 Burn the image on to a CD using standard tools.
  68
  69
  70 Testing
  71 ----------------------------------------------------------------------
  72
  73 If you want to test the live CD without actually P2V-ing a real
  74 server, then you can run the ISO directly in qemu.  (To do any sort of
  75 realistic testing you will also need an operating system image,
  76 eg. from /var/lib/xen/images, to experiment with).  For example:
  77
  78   cp /var/lib/xen/images/rhel5gax32fv.img .
  79   make boot HDA=rhel5gax32fv.img
  80
  81
  82 Serial console
  83 ----------------------------------------------------------------------
  84
  85 With livecd-tools >= 018, the CD should enable the serial console
  86 (ttyS0, 9600 8N1).
  87
  88 You can test this with:
  89   make boot [...] SERIAL=yes