path: root/v2v/virt-v2v.pl

#!/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;
use Locale::TextDomain 'libguestfs';

=encoding utf8

=head1 NAME

virt-v2v - Convert Xen or VMWare guests to KVM

=head1 SYNOPSIS

 virt-v2v xen_name -o kvm_name

 virt-v2v guest.ovf.zip -o kvm_name

 virt-v2v guest.img [guest.img ...]

=head1 DESCRIPTION

Virt-v2v converts guests from one virtualization hypervisor to
another.  Currently it is limited in what it can convert.  See the
table below.

 -------------------------------+----------------------------
 SOURCE                         | TARGET
 -------------------------------+----------------------------
 Xen domain managed by          |
 libvirt                        |
                                |
 Xen compatibility:             |
   - PV or FV kernel            |  KVM guest managed by
   - with or without PV drivers |  libvirt
   - RHEL 3.9+, 4.8+, 5.3+      |    - with virtio drivers
   - Windows XP, 2003           |
                                |
 -------------------------------+
                                |
 VMWare VMDK image with         |
 OVF metadata, exported from    |
 vSphere                        |
                                |
 VMWare compatibility:          |
   - RHEL 3.9+, 4.8+, 5.3+      |
   - VMWare tools               |
                                |
 -------------------------------+----------------------------

=head2 CONVERTING XEN DOMAINS

For Xen domains managed by libvirt, perform the initial conversion
using:

 virt-v2v xen_name -o kvm_name

where C<xen_name> is the libvirt Xen domain name, and C<kvm_name> is
the (new) name for the converted KVM guest.

Then test boot the new guest in KVM:

 virsh start kvm_name
 virt-viewer kvm_name

When you have verified that this works, shut down the new KVM domain
and I<commit> the changes by doing:

 virt-v2v --commit kvm_name

I<This command will destroy the original Xen domain>.

Or you can I<rollback> to the original Xen domain by doing:

 virt-v2v --rollback kvm_name

B<Very important note:> Do I<not> try to run both the original Xen
domain and the KVM domain at the same time!  This will cause guest
corruption.

=head2 CONVERTING VMWARE GUESTS

I<This section to be written>





=head1 OPTIONS

=over 4

=cut

my $help;

=item B<--help>

Display brief help.

=cut

my $version;

=item B<--version>

Display version number and exit.

=cut

my $uri;

=item B<--connect URI> | B<-c URI>

If using libvirt, connect to the given I<URI>.  If omitted,
then we connect to the default libvirt hypervisor.

Libvirt is only used if you specify a C<domname> on the
command line.  If you specify guest block devices directly,
then libvirt is not used at all.

=cut

my $output;

=item B<--output name> | B<-o name>

Set the output guest name.

=cut

=back

=cut

GetOptions ("help|?" => \$help,
            "version" => \$version,
            "connect|c=s" => \$uri,
            "output|o=s" => \$output,
    ) or pod2usage (2);
pod2usage (1) if $help;
if ($version) {
    my $g = Sys::Guestfs->new ();
    my %h = $g->version ();
    print "$h{major}.$h{minor}.$h{release}$h{extra}\n";
    exit
}
pod2usage (__"virt-v2v: no image or VM names given") if @ARGV == 0;

# XXX This should be an option.  Disable for now until we get
# downloads working reliably.
my $use_windows_registry = 0;

my @params = (\@ARGV);
if ($uri) {
    push @params, address => $uri;
}
my ($g, $conn, $dom) = open_guest (@params);

$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 => $use_windows_registry);

#print "fses -----------\n";
#print Dumper(\%fses);

my $oses = inspect_operating_systems ($g, \%fses);

#print "oses -----------\n";
#print Dumper($oses);

# Only work on single-root operating systems.
my $root_dev;
my @roots = keys %$oses;
die __"no root device found in this operating system image" if @roots == 0;
die __"multiboot operating systems are not supported by v2v" if @roots > 1;
$root_dev = $roots[0];

# Mount up the disks and check for applications.

my $os = $oses->{$root_dev};
mount_operating_system ($g, $os);
inspect_in_detail ($g, $os);
$g->umount_all ();























=head1 SEE ALSO

L<virt-inspector(1)>,
L<guestfs(3)>,
L<guestfish(1)>,
L<Sys::Guestfs(3)>,
L<Sys::Guestfs::Lib(3)>,
L<Sys::Virt(3)>,
L<http://libguestfs.org/>.

For Windows registry parsing we require the C<reged> program
from L<http://home.eunet.no/~pnordahl/ntpasswd/>.

=head1 AUTHOR

Richard W.M. Jones L<http://et.redhat.com/~rjones/>

Matthew Booth L<mbooth@redhat.com>

=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.