Beruflich Dokumente
Kultur Dokumente
This document supports the version of each product listed and supports all subsequent versions until the document is replaced by a new edition. To check for more recent editions of this document, see http://www.vmware.com/support/pubs.
EN-000381-00
You can find the most up-to-date technical documentation on the VMware Web site at: http://www.vmware.com/support/ The VMware Web site also provides the latest product updates. If you have comments about this documentation, submit your feedback to: docfeedback@vmware.com
Copyright 2009, 2010 VMware, Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws. VMware products are covered by one or more patents listed at http://www.vmware.com/go/patents. VMware is a registered trademark or trademark of VMware, Inc. in the United States and/or other jurisdictions. All other marks and names mentioned herein may be trademarks of their respective companies.
VMware, Inc.
Contents
AboutThisBook
UsingVMwareOVFTool 7
AboutVMwareOVFTool 7 WhatIsNewinOVFTool2.0 7 FeaturesHighlights 8 OVFStandard 8 BenefitsofOVF 8 VMwarePlatformsUsingOVF 9 ExamplesofImportingandExportingOVFPackagesUsingvSphereClient 9 SpaceRequirementsofOVFPackages 9 VMwareOVFToolDeltaDiskFacilities 10 SupportedOperatingSystems 11 InstallingVMwareOVFTool 11 LinuxandMacOSXInstallationDetails 12 WindowsInstallationDetails 12 RunningOVFToolAfterInstallation 12 UsingVMwareOVFTool 13 CommandLineOptions 13 SpecifyingaLocator 16 FileLocators 17 HTTP,HTTPS,andFTPLocators 18 vSphereLocators 18 SpecifyingtheInventoryPathtoaVirtualMachineorvApp 19 SpecifyingtheInventoryPathforaCluster,Host,orResourcePool 19 PartialLocators 19 ConfigurationFiles 21 ExamplesofUsingVMwareOVFTool 21 ConvertaVMXtoanOVF 21 ConvertaVMXtoanOVA 21 ConvertanOVFtoaVMX 21 ConvertVMXtoavSphere 22 DeployanOVFPackageDirectlyonanESXHost 22 DeployanOVFPackageandPowerItOn 22 ExportaRunningVirtualMachineorvAppfromvSphere 22 DeployanOVFPackageintoavApprunWorkspace 22 ExportavApprunEntitytoanOVFPackage 22 RenametheOVFPackage 23 OmitDisksintheVMwareOVFToolOutput 23 CompressanOVFPackage 23 ChunkorSplitOVFPackageFiles 23 ValidateanOVF1.0orOVF1.1Descriptor 23 DownloadanOVFPackagefromaProtectedWebSite 24 UseaProxy 24 OverwriteaRunningVirtualMachineorvAppfromvSphere 24 SetOVFPropertiesWhenDeployingtovSphere 24 SetOVFNetworkMappingsWhenDeployingtovSphere 25 ObtainProgressFeedbackfromVMwareOVFTool 25
VMware, Inc.
Appendix:OVFPackageSigning
27
Index 31
VMware, Inc.
ThisOVFToolUserGuideprovidesinformationabouthowtouseVMwareOVFTooltopackagevirtual machinesandvAppsintoOpenVirtualizationFormat(OVF)standardpackages.
Revision History
Arevisionofthisbookoccurswitheachreleaseoftheproduct,orasneeded.Arevisedversioncancontain minorormajorchanges.Table 1liststherevisionhistoryofthisbook. Table 1. Revision History
Revision 06/2010 05/2009 Description OVFTool2.0.1Guide(2.0.0wasneverreleased.) OVFTool1.0Guide
Intended Audience
ThisbookisintendedforanyonewhoneedstoconvertanOVFpackagetoavirtualmachine,oravirtual machinetoanOVFpackage.Userstypicallyincludepeoplewhodosoftwaredevelopmentandtestingorwork withmultipleoperatingsystemsorcomputingenvironments:systemadministrators,softwaredevelopers, QAengineers,andanyonewhowantstopackageorunpackagevirtualmachinesusingopenindustry standards.
Document Feedback
VMwarewelcomesyoursuggestionsforimprovingourdocumentation.Ifyouhavecomments,sendyour feedbacktodocfeedback@vmware.com.
VMware, Inc.
Customerswithappropriatesupportcontractsshouldusetelephonesupportforthefastestresponseon priority1issues.Gotohttp://www.vmware.com/support/phone_support.
Support Offerings
TofindouthowVMwaresupportofferingscanhelpmeetyourbusinessneeds,goto http://www.vmware.com/support/services.
VMware, Inc.
VMware, Inc.
Features Highlights
OVFTool2.0providesthefollowingkeyfeatures:
IncludesfullOVF1.0andOVF1.1supportandbackwardcompatiblemodeforimportingexistingOVF 0.9packages SupportsbothimportandgenerationofOVApackages(OVAistheportablevirtualmachineformatfrom XenSource.) DirectlyconvertsbetweenanyvSphere,VMX,orOVFsourceformattoanyvSphere,VMX,orOVFtarget format AccessesOVFsourcesusingHTTP,HTTPS,orFTP,orfromalocalfile DeploysandexportsvAppconfigurationsonvSphere4targets ProvidesoptionstopoweronaVMorvAppafterdeployment,andtopoweroffavirtualmachineor vAppbeforeexporting(cautionadvised) Showinformationaboutthecontentofanysourceinprobemode ProvidescontextsensitiveerrormessagesforvSpheresourcesandtargets,showingpossiblecompletions forcommonerrors,suchasanincompletevCenterinventorypathormissingdatastoreandnetwork mappings ProvidesanoptionaloutputformattosupportscriptingwhenanotherprogramcallsOVFTool UsesnewoptimizeduploadanddownloadAPI(optimizedforvSphere4) SignsOVFpackagesandvalidatesOVFpackagesignatures ValidatesXMLSchemaofOVF1.0andOVF1.1descriptors ImportandexportofOVFpackagesintoavApprun1.0workspace. FormoreinformationaboutvApprun,seehttp://labs.vmware.com/flings/vapprun.
OVF Standard
TheOVFspecificationdescribesasecure,portable,efficient,andflexiblemethodtopackageanddistribute virtualmachinesandcomponents.ItoriginatedfromtheDistributedManagementTaskForce(DMTF)after vendorinitiative.CompaniesthatcontributedtothestandardincludeDell,HP,IBM,Microsoft,VMware,and Citrix.Version1.1waspublishedinJanuary2010,whichsupercedesthe1.0specificationpublishedApril2009, andisavailableontheDMTFWebsite,alongwithawhitepaper.
Specification:http://www.dmtf.org/standards/published_documents/DSP0243_1.1.0.pdf Whitepaper:http://www.dmtf.org/standards/published_documents/DSP2017_1.0.0.pdf
Benefits of OVF
UsingOVFtodistributevirtualmachineshasthefollowingbenefits:
VMware, Inc.
VMware, Inc.
Table 2. VMware-Format File Sizes Compared to OVF and OVA file Sizes
VMware Format Files LinuxBasedAppliance.nvram LinuxBasedAppliance.vmdk LinuxBasedAppliances001.vmdk LinuxBasedAppliances002.vmdk LinuxBasedAppliance.vmsd LinuxBasedAppliance.vmx LinuxBasedAppliance.vmxf Total size 251MBusingthinprovisioning 4000MBusingthickprovisioning 132MB 132MB OVF Format LinuxBasedAppliance.ovf LinuxBasedAppliance0.vmdk LinuxBasedAppliance1.vmdk LinuxBasedAppliance2.vmdk OVA Format LinuxBasedAppliance.ova
10
VMware, Inc.
OVFToolsupportsthefollowingLinuxoperatingsystems:
OVFToolsupportsthefollowingMacOSX64bitoperatingsystems:
MacOSX10.5 MacOSX10.6
Installusingthemethodforyouroperatingsystem:
Operating System Linux32bit Linux64bit Mac64bit Windows32bit Windows64bit Doubleclickontheinstaller,VMware-OVF-Tool.exe Doubleclickontheinstaller,VMware-OVF-Tool.x86_64.exe Installation Method Runtheshellscriptas./VMware-OVF-Tool.sh Runtheshellscriptas./VMware-OVF-Tool.x86_64.sh
VMware, Inc.
11
Runtheinstallerscript.
./VMware-OVF-Tool.sh
ThescriptisinteractiveandpromptsfortheEULAandinstallationdirectory.
IntheRundialog,writecmd,whichopensaDOSprompt.
cmd
IfyouhavetheOVFToolfolderinyourPathenvironmentvariable,youcanrunOVFToolatthecommand line.Forinstructionsonrunningtheutility,seeUsingVMwareOVFToolonpage 13. To add VMware OVF Tool to your Path environment variable ThefollowinginstructionsareforWindowsXP,butitisdonesimilarlyonotherWindowssystems. 1 2 3 4 5 RightclickMyComputer. Selectproperties. SelectAdvanced. SelectEnvironmentVariables. FindthesystemvariablecalledPathandaddtheOVFToolinstalldirectorybyselectingthevariable,click Editandaddingthetext. Forexample,thepathmightbethefollowing:
;C:\Program Files\VMware\VMware OVF Tool\
TheleadingsemicolonisnecessarytoappendtheOVFToolpathtotheexistingpathvariable.
12
VMware, Inc.
3 4
OVFToolprintsinformationaboutthesourcesuchashardware,EULAsandOVFproperties. UseprobemodetoexamineanOVFpackagebeforedeployingit.Forexample,youcanexaminethe downloadanddeploymentsizes,determinethesetofnetworkstobemapped,determinetheOVF propertiestobeconfigured,readtheEULA,anddeterminethevirtualhardwarerequirements.OVFTool mustaccessonlytheOVFdescriptortodisplaythisinformation,sotheoperationdoesnotrequirethe entireOVAorVMDKfilestobedownloaded.Probemodealsovalidatesthecertificateifthesourceis signed. FormoreinformationaboutProbeModeandanexampleoftheoutput,seeProbeModeonpage 25. Table 3describesthesourceandtargetlocators.Formoreinformation,seeSpecifyingaLocatoron page 16.
Command-Line Options
Foreverycommand,youspecifythesourceandtargetlocators.Table 3defineseachlocatortype. Table 3. OVF Tool Definitions of Source and Target Locators
Locator <source locator> Definition Pathtothesource,whichmustbeeitheravirtualmachine,vApp,vApprunworkspace entity,oranOVFpackage. Thesourcelocatorcanbeoneofthefollowing:
<target locator>
Thetargetlocatorcanbeoneofthefollowing:
N/A
OVF, OVA
Specifiesthechunksizetouseforfilesina generatedOVFpackage.Defaultisnottochunk. Whenusingthisoption,alloutputfiles(except theOVFdescriptor,manifestandcertificatefiles) areslicedintothespecifiedchunksize.Thisis usefulifyouneedtotransportanOVFpackage onaseriesof800MBCDROMs,orareonlyable tocreatefilesupto2GBonFAT32filesystems. ChunkingcombinedwithanOVApackageas outputmakesanOVAinwhichallthefilesare chunked,likefortheOVFpackage,buttheOVA packageitselfisstillbeasinglefile. CompressesthediskwhengivenanOVForOVA targetlocator.Thevaluemustbebetween1and 9.Thefastestis1,butgivestheworst compression.Theslowestis9,butgivesthebest compression. TargetdatastorenameforavSpheredeployment. DeploymentoptionsforadeployedOVF package.AnOVFpackagecancontainseveral deploymentconfigurations.Thisoptionallows youtoselectwhichconfigurationtousewhen deployingtothevSpheretarget. Skipsvalidationofsignatureandcertificate. Binaryoption. Selectstargetdiskformat.Commonformatsare monolithicSparse,monolithicFlat, twoGbMaxExtentSparse, twoGbMaxExtentFlat,streamOptimized,thin (vSpheretarget),thick(vSpheretarget) InsertstheEULAinthefirstvirtualsystemor virtualsystemcollectionintheOVF.IftheEULA isinafile,usethefollowingoptionformat: --eula@=filename PrintstheVMwareOVFToolhelpmessagewith usageinformation. DoesnotincludetheEULAintheprobeoutput. Binaryoption. Integrationoption.Interpretargumentsfor networks,datastores,andfoldersasVIM ManagedObjectReferenceidentifiers(type:id) forvSpheresourceanddestinationlocators. Integrationoption.Specifiesthesessionticket usedforauthenticatingthevSpheresource locator.
--compress
N/A
OVF, OVA
--datastore --deploymentOption
-ds
vSphere N/A
--eula
N/A
OVF, OVA
-h
N/A N/A
--I:sourceSessionTicket
14
VMware, Inc.
--ipAllocationPolicy
OVF, OVA
N/A
IPallocationpolicyforadeployedOVFpackage. Supportedvaluesare:fixed,transient,and dhcp.InOVFdescriptors,youcanspecifya VMwarespecificIPassignmentpolicythat guidesthedeploymentprocessbyexpressing whichofthepoliciestheOVFpackagesupports. OnlyvalueslistedintheOVFdescriptorare supportedwhentheOVForOVApackageis deployed. SelectstheIPprotocoltouse.Forexample,IPv4, IPv6.AswiththeipAllocationPolicyoption, youcanspecifywhichIPversionthisOVF packageuseswhenitisdeployed.Useonlythe valueslistedintheOVFdescriptor. RelaxOVFspecificationconformanceandvirtual hardwarecompliancechecks.(Foradvanced usersonly.)
--ipProtocol
OVF, OVA
N/A
--lax
OVF, OVA N/A OVF, vSphere, VMX, vApprun -n N/A OVF, OVA
--name --net
All N/A
Specifiesthetargetname.Defaultstothesource name. SetsanetworkassignmentinthedeployedOVF package.Forexample,--net:<OVF name>=<target name>.OVFpackagescontain symbolicnamesfornetworknameswhichare assignedwiththisoption.Formultiplenetwork mappings,repeattheoption,separatingthem withablank,forexample, --net:s1=t1 --net:s2=t2 --net:s3=t3. TargetnetworkforavSpheredeployment.Use thisoptioninplaceofthe--netoptionwhen onlyonenetworkexistsintheOVFpackage.This optionmapsthesymbolicOVFnametothe specifiednetworkname. Disablediskconversion. Donotincludeimagefilesindestination.
--network
-nw
OVF, OVA
N/A
--powerOffTarget
N/A
vSphere
--powerOn
N/A
vSphere
VMware, Inc.
15
Description SignstheOVFpackagewiththegivenprivate key(.pemfile).Thefilemustcontainaprivate keyandacertificate. Passwordfortheprivatekey.Usedinconjunction with--privateKeyiftheprivatekeyrequires passwordauthentication.Ifrequiredbutnot specified,thetoolpromptsforthepassword. SetsapropertyinthedeployedOVFpackage.For example,--prop:<key>=<value>.Useprobe modetolearnwhichpropertiesanOVFpackage canset.Formultiplepropertymappings,repeat theoption,separatingthemwithablank,for example--prop:p1=v1 --prop:p2=v2 --prop:p3=v3. ProxyusedforHTTP,HTTPS,FTP,andvSphere access.TheproxyisexpressedastheURLtothe proxy.Forexample,forproxy.example.com, theoptionvalueis: https://proxy.example.com:345 OVFToolsupportsproxiesthatrequire authentication.Ifyoudonotprovidecredentials intheURL,OVFToolpromptsforthem.
--privateKeyPassword
N/A
--prop
OVF, OVA
N/A
--proxy
-q
Printsnooutputtothescreenexceptforerrors. Binaryoption. ValidatesOVFdescriptoragainsttheOVF schema.Binaryoption. SkipsvalidationoftheOVFpackagemanifest. Binaryoption. SkipsgenerationoftheOVFpackagemanifest. Binaryoption. ExplicitlyexpressesthatthesourceisOVF,OVA, VMX,vApprun,orvSphere. ExplicitlyexpressthatthetargetisOVF,OVA, VMX,vApprun,orvSphere. Donotuploadthesource;onlyverifyit.
-st -tt
All All
-v -vf
N/A N/A
N/A vSphere
Specifying a Locator
Asourceortargetlocatorpointstosomeresource.Locatorsmustspecifyaprotocol,whichdefineshowto reachtheresource.Supportedprotocolsarefileaccess,vSphere,HTTP,HTTPS,andFTP. FilelocatorscanpointtoanOVFpackage(.ovfor.ova),avirtualmachine(.vmx).HTTP,HTTPS,ora vApprunworkspaceentity.FTPlocatorscanpointtoOVFandOVAfiles.Theresourcetypeisdetermined fromthefilenamesuffix,unlessoneorbothoftheoptions--sourceTypeand--targetTypeareused explicitly.
16
VMware, Inc.
vSpherelocatorscanpointtovariousresourcetypes:virtualmachines,vApps,hosts,clusters,orresource pools.Forasourcelocator,theresourcetypemustbeavirtualmachineorvApp.Foratargetlocator,the resourcetypemustbeahost,cluster,oraresourcepool.AvSpherelocatorisusedforavSphereserver, vCenterServer,VMwareServer,oranESXhost. Atthecommandline,type--help locatorstodisplaytheonlinehelpforlocators. Table 5andTable 6listthedefaultextensionsofthedifferentsourceandtargettypes,aswellaswhich protocolsaresupported. Table 5. Source Locator
Source Type OVF OVA VMX vApprun vSphere Default File Extension .ovf .ova .vmx N/A N/A Protocol File,HTTP,HTTPS,FTP File,HTTP,HTTPS,FTP File File vSphere
File Locators
Filelocatorsarethesameforsourceandtarget.Theyarespecifiedusingordinarypathsyntax. Windows Path Syntax OnWindows,pathsarespecifiedaseitherabsoluteorrelative. ThisisanexampleofanabsolutepathonWindows:
C:\folder1\folder2\package.ovf
TheseexamplesshowrelativepathsonWindows:
..\folder1\package1.ovf package1.ovf
ThefollowingareexamplesofrelativepathsonLinux:
../folder1/package1.ovf package1.ovf
VMware, Inc.
17
80 443 21
vSphere Locators
vSpheresourcelocatorspointtoavirtualmachineorvAppwithinthevirtualinfrastructure.ThevSphere targetlocatorprovidesallrequiredinformationforimportinganOVFpackageorvirtualmachineintoa cluster,hostorresourcepool.Bothsourceandtargetlocatorusethesamesyntax:
vi://<username>:<password>@<host>:<port>/<search-term>
Ifaqueryisnotgiven,aVCinventorypathlookupisperformedusingthespecifiedpath.Otherwise,theobject matchingthequeryisused.Themeaningofthequerydependsontheobjecttype.Table 8showsthedifferent valuesthatyoucanuseinthequeryfield. Table 8. Source and Target Values for All Query Types
Name BIOS Datastore IPAddress DNS MoRef Query bios ds ip dns moref Source BIOSIDofavirtualmachine Datastorepathtoavirtualmachine IPaddressofavirtualmachine DNSnameofavirtualmachine Managedobjectreference(vSphere specificidentifier)ofavirtualmachine orvApp Target BIOSIDofahost N/A IPaddressofahost DNSnameofahost Managedobjectreference(vSpherespecific identifier)ofahost,cluster,orresource pool
18
VMware, Inc.
Youcanenterapartialsourcelocatorifyoudonotknowtheentireinventorypath.Inthiscase,thetoolfails butsuggestspossibleinventorypathcompletions.
or
<datacenter name>/host/<resource pool path>/<vm or vApp name>
Thefollowingexampleshowsaninventorypathwithtwonestedfolders:
MyDatacenter/vm/Folder 1/Sub Folder/MyVM
Thefollowingexampleisofaninventorypathwithoutaspecifiedresourcepool:
TestDatacenter/host/esx-host3.example.com
Thefollowingexampleisofaninventorypathwithaspecifiedresourcepool:
TestDatacenter/host/esx-host3.example.com/Resources/SmallResourcePool
Partial Locators
WhenusingOVFTool,itisoftennotnecessarytospecifysourceandtargettypesaslongascertainfilename conventionsareused.Itispossibletotheignorelocatortypeandspecifythesourceandtargetexplicitlyusing thearguments--sourceType=...and--targetType=.
VMware, Inc.
19
OVFToolassumesthelocatortypebasedonthefollowingrules:
Similarly,sourceandtargettypescanbeinferredfromfolderlocators.OVFToolassumesthetypeaccording thefollowingrules:
OVFToolsupportspartialvSpherelocatorswhendeployingorexporting.Foranincompletelocatorpath,the toolsuggestscompletionsatthecommandline.Example 1showsthecommandlinedialogwhenpartial locatorsareused. Example 1. Partial Locators at the Command Line
> ovftool LAMP.ovf vi://localhost/ Opening source: LAMP.ovf Opening target: vi://user@localhost/ Error: Found wrong kind of object (Folder) Possible completions are: Datacenter/ Remote Datacenter/ Secondary Datacenter/ > ovftool LAMP.ovf vi://localhost/Datacenter Opening source: LAMP.ovf Opening target: vi://user@localhost/Datacenter Error: Found wrong kind of object (Datacenter) Possible completions are: vm/ host/ > ovftool LAMP.ovf vi://localhost/Datacenter/host Opening source: LAMP.ovf Opening target: vi://user@localhost/Datacenter/host Error: Found wrong kind of object (Folder) Possible completions are: host1.foo.com/ host2.foo.com/ > ovftool LAMP.ovf vi://localhost/Datacenter/vm/host1.foo.com
20
VMware, Inc.
Configuration Files
OVFToolhasmanyoptions.Ratherthanrepeatedlyenteringlongcommandsonthecommandline,youcan createaconfigurationfile.Aconfigurationfileusesthefollowingsyntax:
option1=value ... #comment optionN=value
Thefollowingisanexampleofaconfigurationfile:
proxy=http://proxy.example.com datastore=storage-test42 # Comment on something locale=dk
OnLinux,theglobalconfigurationfileisreadfromthefollowinglocation:
$HOME/.ovftool
VMware, Inc.
21
NOTEThisoptiondoesnotperformashutdown,wheretheoperatingsystemshutsdownbyitself.Thisis onlyapoweroffoperation.
AcommonscenarioisthatthecurrentdirectoryisthevApprunworkspace(sinceallvAppruncommandsare relativetothis),soyoucanjustusea.asthetargetlocator,asshowninthefollowingexample:
> ovftool http://www.mycompany.com/ovflib/BigDemo.ovf .
Prependthenameoftheentitytoexporttothepath.IfthecurrentdirectoryisthevApprunworkspace,you onlyspecifythename,asshowninthefollowingexample:
> ovftool BigDemo vi://MyvCenterServer/...
22
VMware, Inc.
Ifthesourcecontainsonlyasinglevirtualmachine,the--makeDeltaDisksoptiondoesnotyieldany compressionboost.Inthiscase,the--compress=9optiongivesmaximumcompression.
Forexample,tocreateanOVFpackageoptimizedforaFAT32filesystem,usethefollowingcommand:
> ovftool --chunkSize=2gb <source> package.ovf
Eachfilechunkhasasequentiallynumberedsuffix.Forexample,fora6GBdisk,thechunkshavethesenames:
disk1.vmdk.000000000, disk1.vmdk.000000001, disk1.vmdk.000000002
VMware, Inc.
23
Ifyouomittheusernameandpassword,inwhichcaseOVFToolpromptsyouforthem.
Use a Proxy
YoucanspecifyaproxyforOVFTool.Thefollowingexamplesshowtheuseofthe--proxyoption:
> ovftool --proxy=proxy.example.com http://external-site.com/ovf/package.ovf > ovftool --proxy=http://proxy.example.com http://external-site.com/ovf/package.ovf
OVFToolallowsproxiesthatrequireauthentication.Credentialsaresuppliedintheproxypathasshownin thefollowingexample:
> ovftool --proxy=user:pass@proxy.example.com http://external-site.com/ovf/package.ovf
Youcanomittheusernameandpasswordforaproxyserverthatrequiresauthentication.OVFToolprompts forthem.
Thefollowingexamplesetstwoproperties:theadministratorsemailaddressandthenumberofconcurrent sessions.
> ovftool --prop:adminEmail=john@example.com --prop:concurrentSessions=200 package.ovf vi://localhost/?dns=fast-esx=host1.example.com
24
VMware, Inc.
Inthefollowingexample,anetworkisselected.
> ovftool --net:Example net 1=VM Network <source> <vSphere locator>
IftheOVFdescriptoronlyspecifiesonenetworkname,youcanspecifythetargetnetworknameofthe networkmapping,asinthefollowingexample:
> ovftool --network=VM Network <source> <vSphere locator>
Probe Mode
Probemoderevealsinformationaboutthecontentofasource.YoucanprobeOVAandOVFpackages,VMX, andvSpheresourcetypes.Youcanusetheinformationgatheredtofindouthowitcanbeconfiguredwhen youdeployit. Tousetheprobefeature,omitthetargetlocatorwheninvokingOVFTool.Forexample,atthecommandline, type:ovftool LAMP.ovf.ThetooldisplaysallavailableinformationabouttheLAMP.ovf. WhenprobemodeisusedonanOVForOVApackage,OVFToolalsovalidatesthecertificatefile,ifpresent. Aspartoftheinformationdisplayedinprobemode,theEULAisdisplayedbydefault.TopreventtheEULA fromdisplaying,usethe --hideEulaoption.
> ovftool --hideEula LAMP.ovf
ThefollowingexampleshowstheresultofprobingtheLAMP.ovf.
OVF version: Name: Version: Vendor: Product URL: 1.0 LAMP running PHP-Fusion 0.1 VMware Aarhus http://example.com/ovf/1.0/LAMP/readme.txt
Annotation: This vApp offers the programming environment stack: Linux, Apache, MySQL and PHP prgramming environmnent, LAMP. More specifically the vApp contains a database server running MySQL and a Web server VM running Apache2 and PHP. End-user License Agreements: Present: Yes (1) Download Size: 604.07 MB
VMware, Inc.
25
Deployment Sizes: Flat disks: 16.00 GB Sparse disks: Unknown Networks: Name: VM Network Description: The VM Network network Virtual Hardware: Family: vmx-04 Disk Types: SCSI-lsilogic Properties: Key: Label: Type: Description: Key: Label: Type: Description:
db-ip IP address ip:VM Network The IP address of the database server. ws-ip IP address ip:VM Network The IP address of the Web server.
26
VMware, Inc.
VMware, Inc.
27
Thecontentsofthefiledisplayasfollows:
Certificate: Data: Version: 3 (0x2) Serial Number: ....
Tocreateatrustedcertificate,usetheOpenSSLcommand,omittingthe--x509option.Thiscreatesacertificate requestina.pemfilethatyoucansendtoanypublicauthority,suchasVerisign.
Whenthisoptionisused,OVFToolusestheprivatekeyandcertificatetogenerateasignaturebasedonthe SHA1digestofeachfilethatisincludedintheOVFpackage,includingtheOVFdescriptoritself. OVFToolgeneratesanadditional.certfilewithasignedSHA1signatureandthecertificateusedtosignit. Example A2showsanexampleofthe.certfilegeneratedbyOVFTool. Example A-2. Certificate File Created by OVF Tool
SHA1(signed-package.mf)=5d9a307f0acdc1a424079eb38ff8954c153f978e599ed374dd784c853bab1856415fa16ef 378bde3487cd5dfa4d11a3017eda91886f98e3bba3adc2f4e28ce6d0ba3a19eef80ac0729511311603 dcb221f9ba7a6008f1a87fe15ebf3699c8a8744bd05c43b1387dd53d73723e7f0a3720d489e147e31c 4570d15fb7a3beae770 -----BEGIN CERTIFICATE----MIIDTzCCArigAwIBAgIJAKDgFLg9WvBwMA0GCSqGSIb3DQEBBQUAMHkxCzAJBgNV BAYTAkRLMQ8wDQYDVQQHEwZBYXJodXMxFTATBgNVBAoTDFZNd2FyZSwgSW5jLjEM MAoGA1UECxMDVklNMREwDwYDVQQDEwhLcmlzdGlhbjEhMB8GCSqGSIb3DQEJARYS a2xhc3NlbkB2bXdhcmUuY29tMB4XDTA5MDMwNjEzMDUwNFoXDTEwMDMwNjEzMDUw NFoweTELMAkGA1UEBhMCREsxDzANBgNVBAcTBkFhcmh1czEVMBMGA1UEChMMVk13 YXJlLCBJbmMuMQwwCgYDVQQLEwNWSU0xETAPBgNVBAMTCEtyaXN0aWFuMSEwHwYJ KoZIhvcNAQkBFhJrbGFzc2VuQHZtd2FyZS5jb20wgZ8wDQYJKoZIhvcNAQEBBQAD gY0AMIGJAoGBAM2xxX9a1YITiiRrxpXGg9xbEP4Oepcs71ZcNp8Z3mQIb95mpEc6 SZemmjOsqwpkvV/82RALOBgmJ/hot1noSkiAZi0liPmX1M0BU3OS/pSim7VNKBmV SUJfOC4T6/MygVpyfkSUhB5EWx0JCUvowRex6Ytl220MOGcXnLpvdfO9AgMBAAGj gd4wgdswHQYDVR0OBBYEFM2KkX7pWTQmMg+iD6HWMOZRLrfJMIGrBgNVHSMEgaMw gaCAFM2KkX7pWTQmMg+iD6HWMOZRLrfJoX2kezB5MQswCQYDVQQGEwJESzEPMA0G A1UEBxMGQWFyaHVzMRUwEwYDVQQKEwxWTXdhcmUsIEluYy4xDDAKBgNVBAsTA1ZJ TTERMA8GA1UEAxMIS3Jpc3RpYW4xITAfBgkqhkiG9w0BCQEWEmtsYXNzZW5Adm13 YXJlLmNvbYIJAKDgFLg9WvBwMAwGA1UdEwQFMAMBAf8wDQYJKoZIhvcNAQEFBQAD gYEANaNxv4QrN7iI0rDCordYDh1G7Z3jl28ntSoxehGmz6ghYAfBNhTVhWUZuX9X UXKn8QltOF/Ynijuo6JTJwO/5V1o6TAaCmFahDW/Om02AXPdSbw4UQdidGmmgrAs DYVQz2CNPk2YbkXITNeGBNHomTqsVU7MGDjReu96+V6O2zY= -----END CERTIFICATE-----
28
VMware, Inc.
VMware, Inc.
29
30
VMware, Inc.
Index
B
benefits of OVF 8
C
command line, running OVF Tool from 13 command-line options 13 --compress 10 compression 10 configuration files 21
Windows details 12 installing OVF Tool 11 integration options 26 introduction to OVF Tool 7 inventory path host or resource pool 19 virtual machine or vApp 19
L
Linux path syntax for file locators 17 Linux installation of OVF 12 Linux operating systems supported 11
D
delta disk compression introduction 10 limitations 10 download file names 11
M
Mac OS 11 Mac OS installation of OVF 12 --makeDeltaDisks 10
E
examples cancelling OVF Tool while running 25 chunking 23 convert .ovf to .vmx 21 convert .vmx to .ova 21 convert .vmx to .ovf 21 convert source to target 22 deploying and powering on 22 deploying OVF package 22 downloading from a protected site 24 exporting a running virtual machine or vApp 22 maximum compression 23 obtaining progress feedback 25 omitting disks in output 23 overwriting a running virtual machine or vApp 24 probe mode 25 renaming the OVF package 23 setting OVF network mappings 25 setting OVF properties 24 using a proxy 24 validating 23
N
new since 1.0 7
O
opeating systems supported Linux 11 operating systems supported Mac 11 Windows 11 OVF package space requirements 9 OVF standard 8 OVF support in vSphere 9 OVF Tool adding to PATH variable 12 command-line options 13 examples 21 installation 11 installing 11 partial locators 19 running 12 running from command line 13 source and target locator definitions 13 OVT Tool as a helper process, integration options 26
F
feature highlights 8 file locators 17
I
installing OVF 11 Linux and Mac OS details 12
VMware, Inc.
P
partial locators command-line dialog 20
31
OVF Tool assumptions 19 PATH variable, adding OVF Tool 12 platforms supported 9 protocol locators, HTTP, HTTPS, FTP 18
R
running OVF Tool after install 12
S
source locator definition 13 vSpherer 18 space requirements 9 supported platforms 9
T
target locator definition 13 technical support resources 5
U
URI, using for file locators 18 URI, using for locators 17
V
vApprun deploying an OVF package to 22 exporting a vApprun entity to an OVF package 22 virtual machine file extensions 9 vSphere source locators query values 19 source and target values 18 vSphere support for OVF 9 vSphereI source locators definition 18
W
whats new 7 Windows path syntax for file locators 17 Windows installation details 12 Windows operating systems supported 11
32
VMware, Inc.