8b61d357bbb6b0345cec2e0fdd2c6360cf5f1a16
[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 Then:
40
41         ./configure && make
42
43 As root, 'make build' will build an ISO image called
44 'virt-p2v-$VERSION.iso'.
45
46 Burn the image on to a CD using standard tools.
47
48
49 Testing
50 ----------------------------------------------------------------------
51
52 If you want to test the live CD without actually P2V-ing a real
53 server, then you can run the ISO directly in qemu.  (To do any sort of
54 realistic testing you will also need an operating system image,
55 eg. from /var/lib/xen/images, to experiment with).  For example:
56
57   cp /var/lib/xen/images/rhel5gax32fv.img .
58   make boot HDA=rhel5gax32fv.img