a61e5f7d305be728c8a83c8b0245e356c454c36b
[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 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 (on Fedora the package is 'livecd-tools')
44  * ocaml, ocaml-extlib, ocaml-pcre, ocaml-xml-light (all in Fedora)
45  * qemu and/or KVM (only for testing)
46
47 Then:
48
49         ./configure && make
50
51 As root, 'make build' will build an ISO image called
52 'virt-p2v-$VERSION.iso'.
53
54 Burn the image on to a CD using standard tools.
55
56
57 Testing
58 ----------------------------------------------------------------------
59
60 If you want to test the live CD without actually P2V-ing a real
61 server, then you can run the ISO directly in qemu.  (To do any sort of
62 realistic testing you will also need an operating system image,
63 eg. from /var/lib/xen/images, to experiment with).  For example:
64
65   cp /var/lib/xen/images/rhel5gax32fv.img .
66   make boot HDA=rhel5gax32fv.img