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  * ocaml, ocaml-extlib-devel, ocaml-pcre-devel, ocaml-xml-light-devel,
  45    ocaml-newt-devel, ocaml-libvirt-devel (all in Fedora)
  46  * qemu and/or KVM (only for testing)
  47
  48 Then:
  49
  50         ./configure --help
  51         ./configure
  52         make
  53
  54 Then:
  55
  56         make build      (as root) builds an ISO image
  57                         called virt-p2v-$VERSION.iso
  58
  59 Other useful commands:
  60
  61         make man        Build manual page
  62         make pxe        Make a PXE-boot image in tftpboot/ subdirectory
  63
  64 Burn the image on to a CD using standard tools.
  65
  66
  67 Testing
  68 ----------------------------------------------------------------------
  69
  70 If you want to test the live CD without actually P2V-ing a real
  71 server, then you can run the ISO directly in qemu.  (To do any sort of
  72 realistic testing you will also need an operating system image,
  73 eg. from /var/lib/xen/images, to experiment with).  For example:
  74
  75   cp /var/lib/xen/images/rhel5gax32fv.img .
  76   make boot HDA=rhel5gax32fv.img