3.0

VMware, Inc. 69
Appendix A Appendix: Migration with p2vTool Command-Line Interface
Source Machines and Destination Machines
Youcanusep2vToolwithlive,hosted,andmanagedsourcemachinesorvirtualappliances,andhostedand
manageddestinationmachinesorvirtualappliances.
Alivemachinecanonlybeasourceandhastheseattributes:
 Canbeaphysicalmachineoravirtualmachine.
 Performsaliveimportthatavoidshavingtoshutdownthesourcemachine.
 Mustbepowered‐onatthetimeofimport.
Ahostedmachinecanbeasourceordestinationandhastheseattributes:
 Isaflat‐filevirtualmachine,typicallyfromaVMwareWorkstationproductorasupportedbackupformat.
 Mustbeaccessiblefromthelocalmachine’soperatingsystem.(Itcanbeonanetworkshare,butthe
networksharemustbemountedbeforerunningp2vTool.)
 Ifusedasasource,thevirtualmachinemustbepoweredoffatthetimeofimport.
Amanagedmachinecanbeasourceordestinationandhastheseattributes:
 VirtualmachinesrunningonanESXServermachine.
 TheservercanbespecifiedasanESXServermachineortheVirtualCenterserverthatismanagingit.
 Ifusedasasource,thevirtualmachinemustbepoweredoffatthetimeoftheimport.
Avirtualappliancecanbean.ovffileoran.ovafilethatcontainsagroupoffiles.Youcaninstallavirtual
appliancefromanylocalorremotefilesystemaccessiblefromthe
sourcemachineorfromaremotemachine
pathsharedoverthenetwork.
Withp2vTool,youcanmigratevolumestoseparatedisks.SettheattributeseparateDisk=”true”inthe
volumeCloneInfonodeforeachvolumeyouwanttoplaceonaseparatedisk.Donotsetthisattributefor
activeorsystemvolumes.See
Example A‐5,“ImportingaManagedSourcetoaManagedDestination,
ExplicitlySpecifyingOptionalParameters,”onpage 72andExample A‐9,“XMLOutputforthep2vTool-q
[--query]Option,”onpage 74.
Restoring VCB Images
VCBenablesitsuserstobackupentireESXServervirtualmachines,storingthebackupusingWorkstation
disks,a.vmxfile,andacatalogfile.Thep2vToolcanrestoreVCBimagesintoESXServer3.xmachines,both
standaloneandthosemanagedbyVirtualCenter,andcanalsoimportthemtohostedproducts.
Thep2vTooldoesnotpreservecertainvirtualmachinepropertiesunlesssettingsfortheattributesthatcan
preservethepropertiesareincludedintheinputXMLfile.Preservingthesepropertiesisapplicableonlytoa
managedproductdestination.Table A‐2showstheattributesthatneedattentiontopreservetheseproperties.
Fora
VMwarehostedproductdestination,donotsettheattributes,becausevirtualmachinepropertiesarenot
preserved.
Informationinthecatalogfileisnotextracted.Torestoretothesamelocation,viewtheoriginalcatalogfile
andincludethatinformationintheinputXMLfile.
Table A-2. Settings to Preserve Properties
Node Attribute Settings
ImportParams keepIdentity Defaultisfalse.Settotrue topreservethevirtual
machineidentity
preserveDeviceBackingInfo Defaultisfalse.Settotruetopreservethedevicebacking
informationforCD‐ROM,floppy,serialport,andparallel
port.
NicMappings preserveNicsInfo Defaultisfalse.Settotruetousethenetworkadapter
informationfromthesource.