From: Richard Jones Date: Fri, 10 Jul 2009 09:22:47 +0000 (+0100) Subject: Added outline of the virt-v2v script. X-Git-Tag: 1.0.57~10 X-Git-Url: http://git.annexia.org/?p=libguestfs.git;a=commitdiff_plain;h=6e790a9d6b225fad4ab080489bd8226c3adb3506 Added outline of the virt-v2v script. --- diff --git a/.gitignore b/.gitignore index d68982d..643478b 100644 --- a/.gitignore +++ b/.gitignore @@ -68,6 +68,7 @@ html/guestfish.1.html html/guestfs.3.html html/recipes.html html/virt-inspector.1.html +html/virt-v2v.1.html images/100kallnewlines images/100kallspaces images/100kallzeroes @@ -158,3 +159,4 @@ src/guestfs-structs.h src/.pod2text.data src/stamp-generator stamp-h1 +v2v/virt-v2v.1 diff --git a/HACKING b/HACKING index 5be2504..747c3c5 100644 --- a/HACKING +++ b/HACKING @@ -85,6 +85,9 @@ src/ Source code to the C library. Also contains the crucial generator program. +v2v/ + Xen to KVM (V2V) conversion tool. + Debugging ---------------------------------------------------------------------- diff --git a/Makefile.am b/Makefile.am index 1cb2299..e2f7d1d 100644 --- a/Makefile.am +++ b/Makefile.am @@ -41,6 +41,9 @@ endif if HAVE_INSPECTOR SUBDIRS += inspector endif +if HAVE_V2V +SUBDIRS += v2v +endif EXTRA_DIST = \ config.rpath \ @@ -124,6 +127,7 @@ html/recipes.html: $(wildcard recipes/*.sh) $(wildcard recipes/*.html) $(wildcar HTMLFILES = html/guestfs.3.html html/guestfish.1.html \ html/virt-inspector.1.html \ + html/virt-v2v.1.html \ html/recipes.html \ html/pod.css html/recipes.css diff --git a/configure.ac b/configure.ac index e241602..2cb898a 100644 --- a/configure.ac +++ b/configure.ac @@ -506,7 +506,7 @@ AC_CHECK_PROG([GHC],[ghc],[ghc],[no]) AM_CONDITIONAL([HAVE_HASKELL], [test "x$GHC" != "xno"]) -dnl Check for Perl modules needed by the inspector. +dnl Check for Perl modules needed by the inspector and V2V. missing_perl_modules=no for pm in Pod::Usage Getopt::Long Sys::Virt Data::Dumper XML::Writer; do AC_MSG_CHECKING([for $pm]) @@ -518,11 +518,13 @@ for pm in Pod::Usage Getopt::Long Sys::Virt Data::Dumper XML::Writer; do fi done if test "x$missing_perl_modules" = "xyes"; then - AC_MSG_WARN([some Perl modules required to compile virt-inspector are missing]) + AC_MSG_WARN([some Perl modules required to compile virt-inspector and virt-v2v are missing]) fi AM_CONDITIONAL([HAVE_INSPECTOR], [test "x$PERL" != "xno" -a "x$missing_perl_modules" != "xyes"]) +AM_CONDITIONAL([HAVE_V2V], + [test "x$PERL" != "xno" -a "x$missing_perl_modules" != "xyes"]) dnl Library versioning. MAX_PROC_NR=`cat $srcdir/src/MAX_PROC_NR` @@ -558,6 +560,7 @@ AC_CONFIG_FILES([Makefile java/Makefile haskell/Makefile inspector/Makefile + v2v/Makefile libguestfs.pc ocaml/META perl/Makefile.PL]) AC_OUTPUT @@ -585,6 +588,8 @@ echo -n "Haskell bindings .................... " if test "x$HAVE_HASKELL" = "x"; then echo "yes"; else echo "no"; fi echo -n "virt-inspector ...................... " if test "x$HAVE_INSPECTOR" = "x"; then echo "yes"; else echo "no"; fi +echo -n "virt-v2v ............................ " +if test "x$HAVE_V2V" = "x"; then echo "yes"; else echo "no"; fi echo "supermin appliance .................. $enable_supermin" echo echo "If any optional component is configured 'no' when you expected 'yes'" diff --git a/v2v/Makefile.am b/v2v/Makefile.am new file mode 100644 index 0000000..69ed98c --- /dev/null +++ b/v2v/Makefile.am @@ -0,0 +1,48 @@ +# libguestfs virt-v2v +# Copyright (C) 2009 Red Hat Inc. +# +# This program is free software; you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation; either version 2 of the License, or +# (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program; if not, write to the Free Software +# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. + +EXTRA_DIST = \ + run-v2v-locally \ + virt-v2v.pl + +if HAVE_V2V + +man_MANS = virt-v2v.1 + +noinst_DATA = @top_builddir@/html/virt-v2v.1.html + +virt-v2v.1: virt-v2v.pl + $(POD2MAN) \ + --section 1 \ + -c "Virtualization Support" \ + --release "$(PACKAGE_NAME)-$(PACKAGE_VERSION)" \ + $< > $@ + +@top_builddir@/html/virt-v2v.1.html: virt-v2v.pl + mkdir -p @top_builddir@/html + cd @top_builddir@ && pod2html \ + --css 'pod.css' \ + --title 'virt-v2v, convert virtual machine from Xen to KVM' \ + --htmldir html \ + --outfile html/virt-v2v.1.html \ + v2v/$< + +install-data-hook: + mkdir -p $(DESTDIR)$(bindir) + install -m 0755 virt-v2v.pl $(DESTDIR)$(bindir)/virt-v2v + +endif diff --git a/v2v/run-v2v-locally b/v2v/run-v2v-locally new file mode 100755 index 0000000..4d792fb --- /dev/null +++ b/v2v/run-v2v-locally @@ -0,0 +1,52 @@ +#!/usr/bin/perl +# virt-v2v +# Copyright (C) 2009 Red Hat Inc. +# +# This program is free software; you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation; either version 2 of the License, or +# (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program; if not, write to the Free Software +# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. + +# This script sets up the environment so you can run virt-v2v in place +# without needing to do 'make install' first. You can also run virt-v2v +# by creating a symlink to this script and putting it in your path. +# +# Use it like this: +# ./run-v2v-locally [usual virt-v2v args ...] + +use strict; +use warnings; + +use File::Basename qw(dirname); +use File::Spec; +use Cwd qw(abs_path); + +my $path = $0; + +# Follow symlinks until we get to the real file +while(-l $path) { + my $link = readlink($path); + if(File::Spec->file_name_is_absolute($link)) { + $path = $link; + } else { + $path = File::Spec->catfile(dirname($path), $link); + } +} + +# Get the absolute path of the parent directory +$path = abs_path(dirname($path).'/..'); + +$ENV{LD_LIBRARY_PATH} = $path.'/src/.libs'; +$ENV{LIBGUESTFS_PATH} = $path.'/appliance'; +$ENV{PERL5LIB} = $path.'/perl/blib/lib:'.$path.'/perl/blib/arch'; + +exec('perl', $path.'/v2v/virt-v2v.pl', @ARGV); diff --git a/v2v/virt-v2v.pl b/v2v/virt-v2v.pl new file mode 100755 index 0000000..b7d9686 --- /dev/null +++ b/v2v/virt-v2v.pl @@ -0,0 +1,153 @@ +#!/usr/bin/perl -w +# virt-v2v +# Copyright (C) 2009 Red Hat Inc. +# +# This program is free software; you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation; either version 2 of the License, or +# (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program; if not, write to the Free Software +# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. + +use warnings; +use strict; + +use Sys::Guestfs; +use Sys::Guestfs::Lib qw(open_guest get_partitions resolve_windows_path + inspect_all_partitions inspect_partition + inspect_operating_systems mount_operating_system inspect_in_detail); +use Pod::Usage; +use Getopt::Long; +use Data::Dumper; +use File::Temp qw/tempdir/; +use XML::Writer; + +=encoding utf8 + +=head1 NAME + +virt-v2v - Convert Xen guests to KVM + +=head1 SYNOPSIS + + virt-v2v xen_name -o kvm_name + + virt-v2v guest.img [guest.img ...] + +=head1 DESCRIPTION + + + + + + +=head1 OPTIONS + +=over 4 + +=cut + +my $help; + +=item B<--help> + +Display brief help. + +=cut + +my $uri; + +=item B<--connect URI> | B<-c URI> + +If using libvirt, connect to the given I. If omitted, +then we connect to the default libvirt hypervisor. + +Libvirt is only used if you specify a C on the +command line. If you specify guest block devices directly, +then libvirt is not used at all. + +=cut + +GetOptions ("help|?" => \$help, + "connect|c=s" => \$uri, + ) or pod2usage (2); +pod2usage (1) if $help; +pod2usage ("$0: no image or VM names given") if @ARGV == 0; + +# my $g; +# if ($uri) { +# $g = open_guest (\@ARGV, rw => $rw, address => $uri); +# } else { +# $g = open_guest (\@ARGV, rw => $rw); +# } + +# $g->launch (); +# $g->wait_ready (); + +# # List of possible filesystems. +# my @partitions = get_partitions ($g); + +# # Now query each one to build up a picture of what's in it. +# my %fses = +# inspect_all_partitions ($g, \@partitions, +# use_windows_registry => $windows_registry); + +# #print "fses -----------\n"; +# #print Dumper(\%fses); + +# my $oses = inspect_operating_systems ($g, \%fses); + +# #print "oses -----------\n"; +# #print Dumper($oses); + +# # Mount up the disks and check for applications. + +# my $root_dev; +# foreach $root_dev (sort keys %$oses) { +# my $os = $oses->{$root_dev}; +# mount_operating_system ($g, $os); +# inspect_in_detail ($g, $os); +# $g->umount_all (); +# } + +=head1 SEE ALSO + +L, +L, +L, +L, +L, +L, +L. + +For Windows registry parsing we require the C program +from L. + +=head1 AUTHOR + +Richard W.M. Jones L + +=head1 COPYRIGHT + +Copyright (C) 2009 Red Hat Inc. + +This program is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +This program is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with this program; if not, write to the Free Software +Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.