1virt-convert(1M)        System Administration Commands        virt-convert(1M)
2
3
4

NAME

6       virt-convert - convert virtual machines between formats
7

SYNOPSIS

9       virt-convert [option]... input.vmx | input-dir [output.xml | output-dir]
10
11

DESCRIPTION

13       The  virt-convert program is a command line tool for converting virtual
14       machines (VMs) from one format to another. It accepts either a VM defi‐
15       nition file (such as VMware vmx format) or a directory containing a VM.
16       By default, a new VM definition file, and converted disk  images,  will
17       be placed in a new output directory.
18
19
20       If  an  output directory is specified, it will be created if necessary,
21       and the output VM definition placed within  the  new  directory,  along
22       with any disk images, as needed.
23
24
25       If an output VM definition file is specified, it will be created along‐
26       side any disks in the same directory.
27

OPTIONS

29       Any of the following options can be omitted, in which  case   virt-con‐
30       vert  will  use  defaults when required. An input VM definition or con‐
31       taining directory must be provided. By default, an output directory  is
32       generated  based  upon  the name of the VM. The default input format is
33       VMware vmx, and the default output format is a libvirt "image" XML def‐
34       inition.
35
36       -a, --arch=arch
37
38           Architecture  of  the virtual machine (i686, x86_64, ppc). Defaults
39           to that of the host machine.
40
41
42       -D, --disk-format=format
43
44           Output disk format, or none if no conversion should  be  performed.
45           formatis one of:
46
47           none
48
49               No disks are converted or copied.
50
51
52           vmdk
53
54               VMWare VMDK format
55
56
57           raw
58
59               raw file
60
61
62           vdisk
63
64               vdisk format (see vdiskadm(1M))
65
66
67
68       -d, --debug
69
70           Display debugging information.
71
72
73       -h, --help
74
75           Display the help message and exit.
76
77
78       -i, --input-format format
79
80           Input format. Currently, vmx is the only supported input format.
81
82
83       --noacpi
84
85           Override  the  OS  type and variant to disable the ACPI setting for
86           fully virtualized guest.
87
88
89       --noapic
90
91           Override the OS type and variant to disable the  APIC  setting  for
92           fully virtualized guest.
93
94
95       -o, --output-format format
96
97           Output  format.  Currently,  the supported output formats are virt-
98           instance and virt-image. virt-instance is  the  recommended  format
99           for Solaris.
100
101
102       --os-type=os_type
103
104           Optimize  the  guest  configuration for a type of operating system.
105           This will attempt to pick the most suitable ACPI and APIC settings,
106           optimally  supported mouse drivers, and generally accommodate other
107           operating system quirks. See virt-install(1M) for a list  of  valid
108           operating system types.
109
110
111       --os-variant=os_variant
112
113           Further  optimize  the guest configuration for a specific operating
114           system variant. This parameter is  optional.  See  virt-install(1M)
115           for a list of valid operating system variants.
116
117
118       -p, --paravirt
119
120           Create   a  paravirtualized  guest image. Convert machine to a par‐
121           avirtualized Xen-based image.
122
123
124       -q, --quiet
125
126           Avoid verbose output.
127
128
129       -v, --hvm
130
131           Create a fully  virtualized  guest  image.  Convert  machine  to  a
132           hvm/qemu-based  image  (this  is  the  default if --paravirt is not
133           specified).
134
135

EXAMPLES

137       Example 1 Converting a VMware VMX appliance
138
139
140       The following sequence of commands converts a VMware VMX appliance  and
141       imports it into Solaris xVM.
142
143
144         # virt-convert -o virt-instance /guests/vmx-appliance/ \
145         /guests/xvm-appliance/
146         # virsh define --relative-path=/guests/xvm-appliance/ \
147         \guests/xvm-appliance/appliance.xml
148
149
150

ATTRIBUTES

152       See attributes(5) for descriptions of the following attributes:
153
154
155
156
157       ┌─────────────────────────────┬─────────────────────────────┐
158       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
159       ├─────────────────────────────┼─────────────────────────────┤
160       │Availability                 │SUNWxvmu                     │
161       ├─────────────────────────────┼─────────────────────────────┤
162       │Interface Stability          │Volatile                     │
163       └─────────────────────────────┴─────────────────────────────┘
164

SEE ALSO

166       vdiskadm(1M), virt-install(1M), attributes(5), xvm(5)
167

CAVEATS

169       Not all conversions will result in a working guest installation. If the
170       source OS image is configured to use SCSI disks, the use of  IDE  disks
171       may cause the OS boot to fail. Some images may be configured to use the
172       VMware drivers such as vlance. In  the  vlance  case  and  in  general,
173       device  emulation  support  may  not be sufficient for all OS installa‐
174       tions.
175

AUTHORS

177       Written by Joey Boggs and John Levon.
178
179
180       See the AUTHORS file in the source distribution for the  complete  list
181       of credits.
182
183
184
185SunOS 5.11                        8 Sep 2009                  virt-convert(1M)
Impressum