Remove $ Id $
[virt-p2v.git] / 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
11 Binaries
12 ----------------------------------------------------------------------
13
14 Binaries are available from the website (live CD images which can be
15 burned directly to a CD and booted on the p2v candidate machine).
16
17        http://et.redhat.com/~rjones/virt-p2v/download.html
18
19
20 Usage
21 ----------------------------------------------------------------------
22
23 Please read the manual page:
24
25        man virt-p2v
26 or     make man; nroff -man virt-p2v.1 | less
27 or     http://et.redhat.com/~rjones/virt-p2v/virt-p2v.1.html
28
29
30 Building
31 ----------------------------------------------------------------------
32
33 Requirements:
34
35  * livecd-creator (on Fedora the package is 'livecd-tools')
36  * ocaml, ocaml-extlib, ocaml-pcre, ocaml-xml-light (all in Fedora)
37  * qemu and/or KVM (only for testing)
38
39 (1) Edit Makefile - there is some general configuration at the
40     top which you may want to change.
41
42 (2) 'make build' will build an ISO image called virt-p2v-$VERSION.iso
43
44 (3) Burn the image on to a CD using standard tools.
45
46
47 Testing
48 ----------------------------------------------------------------------
49
50 If you want to test the live CD without actually P2V-ing a real
51 server, then you can run the ISO directly in qemu.  (To do any sort of
52 realistic testing you will also need an operating system image,
53 eg. from /var/lib/xen/images, to experiment with).  For example:
54
55   $ cp /var/lib/xen/images/rhel5gax32fv.img .
56   $ make boot HDA=rhel5gax32fv.img
57   qemu -m 512 -cdrom virt-p2v-0.1.iso -boot d -hda rhel5gax32fv.img