resolveubuntu9.04

VMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMwareToolsVMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMware,Inc.
2Youcanfindthemostup-to-datetechnicaldocumentationontheVMwarewebsiteat:https://docs.
vmware.
com/Ifyouhavecommentsaboutthisdocumentation,submityourfeedbacktodocfeedback@vmware.
comCopyright2019VMware,Inc.
Allrightsreserved.
Copyrightandtrademarkinformation.
VMware,Inc.
3401HillviewAve.
PaloAlto,CA94304www.
vmware.
comContentsAboutThisBook5UpdatedInformation71IntroductiontoOperatingSystemSpecificPackagesforVMwareTools8BenefitsofInstallingVMwareToolsOSPs8SupportedGuestOperatingSystemsforVMwareToolsOSPs9WeakVersioningforVMwareToolsOSPs92PreparingforVMwareToolsOSPInstallation13UninstallExistingVMwareTools13Ubuntu8.
10OSPInstallationException14DeterminingtheConfigurationMethodforInstallingVMwareToolsOSPs14InstallingtheVMwareToolsOSPswithaPackageManager15VMwareToolsOperatingSystemSpecificInstallationPackages163InstallingVMwareToolsOSPs21DistributionSuppliedDisplayandMousePackages21DistributionSuppliedKernelModulePackages21InstallingVMwareToolsUsingOSPsforRHEL6.
x,RHEL5.
x,CentOS6.
x,andCentOS5.
xGuestOperatingSystems22InstallingVMwareToolsUsingOSPsforRHEL4,CentOS4,andRHEL3GuestOperatingSystems25InstallingVMwareToolsUsingOSPsforSLES11andlaterservicepacks,SLED11andlaterservicepacksGuestOperatingSystems27InstallingVMwareToolsUsingOSPsforSLES10andSLED10GuestOperatingSystems30InstallingVMwareToolsUsingOSPsforSLES9GuestOperatingSystem32InstallingVMwareToolsUsingOSPsforUbuntuGuestOperatingSystem34VerifyVMwareToolsInstallation374InstallingCustomizedKernelModulePackages39BuildingCustomizedKernelModulePackagesforRedHatEnterpriseLinuxandSUSELinuxEnterpriseDistributions39BuildCustomizedKernelModulePackagesforUbuntu445MaintainingVMwareToolsOSPsAcrossLinuxOSUpgrades46VMware,Inc.
36UninstallingVMwareToolsOSPs48UninstallVMwareToolsOSPsWithaPackageManager48ManuallyUninstallVMwareTools49VMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMware,Inc.
4AboutThisBookTheVMwareToolsInstallationGuideForOperatingSystemSpecificPackagesprovidesinformationabouthowtousetheoperatingsystemspecificpackages(OSP)toinstallVMwareToolsinvirtualmachines.
OSPsareseparatedownloadableVMwareToolspackages.
Thesepackagesarespecifictoeachoperatingsystem.
OSPsenableindividual,andoperatingsystem(OS)specific,downloadandinstallationofVMwareTools.
NoteUseeithertheVMwareToolsautomaticinstallationandupdatethroughtheVMwarevSphereClientorusetheOSPsforindividualmanualinstallationandupdate.
Youcannotmixthetwomethods.
TheOSPssupportaspecificlistofLinuxguestoperatingsystems.
ForacurrentlistoftheguestssupportedbyVMwareToolsOSPs,seetheonlineVMwareCompatibilityGuide.
http://www.
vmware.
com/resources/compatibility/search.
phpaction=base&deviceCategory=softwareFromtheVMwareWebsiteselectSupportandDownloads>CompatibilityGuides,andclicktheViewtheGuest/HostOStabontheVMwareCompatibilityGuideWebsitelink.
IntendedAudienceThisbookisintendedforadministratorswhowanttoinstalloruseoperatingsystemspecificpackagesforVMwareTools.
ThisbookisforexperiencedLinuxsystemadministratorswhoarefamiliarwithvirtualmachinetechnology.
TheadministratorshouldalsobefamiliarwithdatacenteroperationsandproficientwithpackagingandupdatingsystemsoftheirspecificguestOSLinuxdistribution.
VMwareTechnicalPublicationsGlossaryVMwareTechnicalPublicationsprovidesaglossaryoftermsthatmightbeunfamiliartoyou.
FordefinitionsoftermsastheyareusedinVMwaretechnicaldocumentation,gotohttp://www.
vmware.
com/support/pubs.
DocumentFeedbackVMwarewelcomesyoursuggestionsforimprovingourdocumentation.
Ifyouhavecomments,sendyourfeedbacktodocfeedback@vmware.
com.
VMware,Inc.
5TechnicalSupportandEducationResourcesThefollowingtechnicalsupportresourcesareavailabletoyou.
Toaccessthecurrentversionofthisbookandotherbooks,gotohttp://www.
vmware.
com/support/pubs.
OnlineandTelephoneSupportTouseonlinesupporttosubmittechnicalsupportrequests,viewyourproductandcontractinformation,andregisteryourproducts,gotohttp://www.
vmware.
com/support.
Customerswithappropriatesupportcontractsshouldusetelephonesupportforthefastestresponseonpriority1issues.
Gotohttp://www.
vmware.
com/support/phone_support.
html.
SupportOfferingsTofindouthowVMwaresupportofferingscanhelpmeetyourbusinessneeds,gotohttp://www.
vmware.
com/support/services.
VMwareProfessionalServicesVMwareEducationServicescoursesofferextensivehands-onlabs,casestudyexamples,andcoursematerialsdesignedtobeusedason-the-jobreferencetools.
Coursesareavailableonsite,intheclassroom,andliveonline.
Foronsitepilotprogramsandimplementationbestpractices,VMwareConsultingServicesprovidesofferingstohelpyouassess,plan,build,andmanageyourvirtualenvironment.
Toaccessinformationabouteducationclasses,certificationprograms,andconsultingservices,gotohttp://www.
vmware.
com/services.
VMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMware,Inc.
6UpdatedInformationThisVMwareToolsInstallationGuideForOperatingSystemSpecificPackagesisupdatedwitheachreleaseoftheproductorwhennecessary.
ThistableprovidestheupdatehistoryoftheVMwareToolsInstallationGuideForOperatingSystemSpecificPackagesRevisionDescriptionEN-000510-03nAddedUpdatedInformationTopicnURLchangedfromhttp://packages.
vmware.
comtohttps://packages.
vmware.
comEN-000510-02Initialrelease.
VMware,Inc.
7IntroductiontoOperatingSystemSpecificPackagesforVMwareTools1OSPsforVMwareToolsisapackaginganddistributionmechanismforVMwareTools.
TheseOSPsusethenativepackageformatsandstandardsofthesupportedguestoperatingsystems.
OSPsareanalternativetotheexistingmechanismusedtoinstallVMwareToolsthroughtheVMwarevSphereClient.
WithOSPsyoucanusethenativeupdatemechanismsofyouroperatingsystemtodownload,install,andmanageVMwareTools.
WithOSPsyoucanmanageVMwareToolsfromthevirtualmachineasyouwouldotherstandardsoftware.
Thischapterincludesthefollowingtopics:nBenefitsofInstallingVMwareToolsOSPsnSupportedGuestOperatingSystemsforVMwareToolsOSPsnWeakVersioningforVMwareToolsOSPsBenefitsofInstallingVMwareToolsOSPsVMwareToolsOSPsoccupyasmalleramountofdiskspacethanthetarinstallerusedwithvSphereClient,whichmakespackageinstallationoruninstallationfast.
ThefollowingfeaturesdescribethebenefitsofusingVMwareToolsOSPs:SeparateUpdatesVMwareToolsOSPupdatesareprovidedseparatelyfromtheVMwareplatform.
ThedecouplingallowsyoutoupdatetothelatestversionofVMwareToolswithouthavingtoupgradetothelatestversionoftheVMwareproduct.
KeepingOSPsasseparatedownloadablepackagesallowsformoreflexibilityinmanagingyourVMwareproducts'updatesandinstallations.
WithOSPsyoucanconfiguretheupdatemanagersonyourLinuxdistributionstocheckforupdatestoVMwareToolsasneeded.
Standards-compliantVMwareToolsOSPsarepackagedinthenativepackageformatandfollowthebestpracticesandstandardsofthesupportedoperatingsystems.
Forexample,RedHatEnterpriseLinuxusestheRPMpackagemanagerandDebian-baseddistributionsusetheDebianPackagingStandard.
OSPsuseVMware,Inc.
8thestandardmechanismsfordependenciesamongpackages,andthetoolsareseparatedintocomponentsforkernelanduserspace.
Thesestandardmechanismsallowyoutoauditthepackagesonvirtualmachineswithorwithoutgraphicscomponents.
VersionManageabilityWithOSPs,youcanusethestandardguestoperatingsystempackagingtoolstoexamineandeasilyunderstandhowtheOSPsbehavewhileinstallingoruninstallingVMwareTools.
Thisunderstandingallowsyoutodeterminewhichcomponentsyouwanttoinstallandthevalidityofthepackaging.
NoteDirectlyupgradingVMwareToolsOSPsisnotsupported.
ToupgradeOSPs,youmustuninstallthecurrentOSPversionandreinstalltheupgradedOSPversion.
SupportedGuestOperatingSystemsforVMwareToolsOSPsVMwareToolsOSPsareavailablefor32-bitand64-bitversionsofthesupportedguestoperatingsystem.
OSPsarealsoavailableforthemostpopularkernelvariants,suchasbigsmp,hugemem,pae,andsoon.
Thekernelmodulesourcepackagesprovidelimitedsupportforcustomizedorotherwisenonstandardkernels.
ForacurrentlistoftheguestssupportedbyVMwareToolsOSPs,seetheonlineVMwareCompatibilityGuide.
http://www.
vmware.
com/resources/compatibility/search.
phpaction=base&deviceCategory=softwareFromtheVMwareWebsiteselectSupportandDownloads>CompatibilityGuides,andclicktheViewtheGuest/HostOStabontheVMwareCompatibilityGuideWebsitelink.
WeakVersioningforVMwareToolsOSPsVMwareprovidesweakversioningforsharingLinuxkernelmodulesacrosskernelswithcompatibleapplicationbinaryinterfaces(ABIs).
YoucanusekernelmodulesbetweenmultipleABIcompatiblekernelswithoutinstallingmodulesforeachkernel.
WeakversioningusesmodulesfromanotherkernelifthemodulesareABIcompatiblewiththecurrentlyrunningkernel.
WeakversioningisappliedtoLinuxsystemswhenaknownlevelofABIcompatibilityisguaranteedbytheguestoperatingsystemvendor.
Ifyourunaguestoperatingsystemthatisnotcompatible,weakversioningmightcreatelinkstomodulesthatmightnotworkforagivenkernel.
VMwareprovidesthefollowingtypesofweakversioning:nThePartnerDriverLinuxProcess(PLDP)forSuSEandtheDriverUpdateProgram(DUP)forRHEL.
ThisdistributionmethodappliestoRHEL5.
x,RHEL6.
x,SLES10.
x,SLES11andlaterservicepacks.
VMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMware,Inc.
9nWeakversioningprovidedbyVMware.
ThisdistributionmethodappliestoRHEL3,RHEL4,andSLES9.
PLDP/DUPWeakVersioningThePLDP/DUPweakversioningmethodensuresthatVMwareToolsOSPsareABIcompatiblewiththekernelbeforetheOSPmodulesareloaded.
PLDP/DUPweakversioningtakesplacewhenyouinstallOSPsonaRHEL5,RHEL6,SLES10,SLES11andlaterservicepacks.
VMwareprovidesbinarykernelmodulesforaspecifickernel,typicallythebasekernelforarelease.
Forexample,VMwareprovideskernelmodulesforthefirstreleasedkernelofRHEL5,2.
6.
18-8.
el5.
Nowyoumightupgradethekerneloroperatingsystemtoalaterversion.
Forexample,youmightupgradetheRHEL5kernelto2.
6.
18-9.
el5ortheoperatingsystemtoRHEL5.
1.
PLDP/DUPensuresthattheVMwareToolsmodulesloadandfunctiononallkernelversionsthatareABIcompatible.
Ifamoduleisnotcompatible,itisnotinstalled.
PLDP/DUPusesRPMtoresolvedependenciesandsymbolswhenitmatchesapackageagainstthekernel.
ARPMcanhavealistofsymbolsasdependenciesthatmustberesolvedbeforeamodulecanbeinstalled.
Thesymbolsinthekernelandinmodulesarechecksummed.
Tostreamlinethepotentiallylargenumberofsymbolsthatmustbechecked,theOSjoinsfunctionsignaturesinthekernelintorelatedgroupsandchecksumstheentiregroup.
Forexample,onechecksummightbeperformedforthenetgroup,anotherforthecoregroup,andsoon.
Whenakernelmoduleisbuilt,PLDP/DUPinvokesspecialmacrosthatfindallfunctioncallstothekernel.
Iftheirsignaturesmatchthoseinthekernel,thesignaturesaregroupedandthechecksumisaddedtothemodule'sRequires:section.
Whenyouruntheinstallation,thecurrentlyinstalledkernel(whichmightbealaterversion)mustprovideamatchingchecksum.
Ifitdoesnot,themodulecannotbeinstalled.
PLDP/DUPusesthesamestrategytoresolvesymbolsthatmodulesrequirefromothermodules.
Whenakernelmoduleisbuilt,thesymbolsthatthemoduleexportsarechecksummedandaddedtoitsProvides:sections.
Symbolsrequiredfromothermodulesthatwerenotprovidedbythekernelarechecksummedandaddedtothemodule'sRequires:section.
EnforcingABICompatibilityWhenKernelsAreUpdatedWhenyouinstallVMwareToolsmodules,PLDP/DUPcontinuestoensureABIcompatibilityafterakernelisupdatedwithinamajorrelease.
ThePLDP/DUPverificationprocessensuresthatmodulesarelinkedtoallcompatiblekernels.
Forexample,youmightinstalltheVMCImoduleinthe2.
6.
18-8.
el5kernel,inthefollowingdirectory:/lib/modules/2.
6.
18-8.
el5/extra/vmware/vmci.
koIfyouupdatethekernelto2.
6.
18-9.
el5,thePLDP/DUPprocessstartstherequirementcheckstoconfirmthattheinstallationcancontinue.
PLDP/DUPperformsthefollowingtasks:1RPMverifiesallpackagedependencies.
VMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMware,Inc.
102PLDP/DUPrunstheweak-updatesprogram,whichverifiesthattheVMCImoduleintheoldkernelcanworkwiththenewkernel.
3Iftheverificationpasses,theweak-updatesprogramcreatesasymlinkinthenewkernel'smoduledirectorythatpointstotheactualmoduleintheoldkernel'smoduledirectory:/lib/modules/2.
6.
18-9.
el5/weak-updates/vmware-tools-vmci/vmci.
ko->/lib/modules/2.
6.
18-8.
el5/extra/vmware/vmci.
koThisverificationtakesplacewheneveranewkernelversionoramodulesupportedbyPLDP/DUPisinstalled.
WeakVersioningandDistributionSuppliedKernelModulePackagesBydefault,certainVMwareToolskernelmodulepackagesareinstalledonthenativeRHEL6,SLES11andlaterservicepacks.
Forthesemodules,weakversioningbehavesdifferentlyonRHELandSUSEsystems.
Thedistributionsuppliedmodulesarevmxnet3,vmw_pvscsi,andvmware_balloon.
Fordetails,seeDistributionSuppliedKernelModulePackages.
OnRHELsystems,moduleslinkedinthroughweakversioning(DUP)donottakeprecedenceoverdistributionsuppliedmodulesthatarebuiltintothekernel.
IfyouinstallVMwareToolskernelmodulepackagesforoneofthesemodules,andyouupdatethekernel,thenewkernelusesitsmodulesandnottheonesprovidedbyVMwareTools.
OnSUSEsystems,moduleslinkedinthroughweakversioning(PLDP)takeprecedenceoverdistributionsuppliedmodulesthatarebuiltintothekernel.
IfyouinstallVMwareToolskernelmodulepackagesforoneofthesemodules,thesystemcontinuestousethem,evenonlaterkernels.
ChangingtheBehaviorofDistributionSuppliedKernelModulePackagesYoucanchangethedefaultbehaviorofdistributionsuppliedkernelmodulepackageswhenthekernelisupdatedonRHELandSUSEsystems.
OnRHELsystems,youcanoverridethedefaultuseofthedistributionsuppliedmodulewhenthekernelisupdatedbydirectingthesystemtousetheweak-updatesdirectory.
OnSUSEsystems,youcanoverridethedefaultuseoftheVMwareToolsprovidedmodulewhenthekernelisupdatedbydirectingthesystemtousethedirectoryinthekernel.
Procedure1Addafileinthe/etc/depmod.
ddirectory.
Forexample,forthevmw_pvscsimodule,createthe/etc/depmod.
d/vmw_pvscsi.
conffile.
VMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMware,Inc.
112Addalinetothefileyoucreatedtooverridethedefaultbehaviorforamodule.
OptionDescriptionRHELsystemsForexample,addthefollowinglinetothe/etc/depmod.
d/vmw_pvscsi.
conffiletopointtotheweak-updatesdirectory:overridevmw_pvscsi*extra/vmware-tools-pvscsiSUSEsystemsForexample,addthefollowinglinetothe/etc/depmod.
d/vmw_pvscsi.
conffiletopointtothedirectoryinthekernel:overridevmw_pvscsi*kernel/drivers/scsiWeakVersioningforRHEL4,RHEL3,andSLES9StartingwithESXi5.
0.
x,VMwareprovidesweakversioningforVMwareToolsmodulepackagesforRHEL4,RHEL3,andSLES9bymeansofaninitscript.
TheVMwareprovidedweakversioningmethodallowsamoduletoloadaslongaskernelABIcompatibilityexistsbetweenthemoduleandthecurrentlyrunningkernel.
Thisweakversioningmethodoccurswhenthemodulepackageisinstalledorthevirtualmachineisstarted.
Itdoesnotprovideweakversioningwhenanewversionofthekernelisinstalled,asisdonebyPLDP/DUP.
WhenyouinstallaVMwareToolsmodulepackage,themoduleisinstalledinthe/lib/modules/kernel_version/extra/directoryinthekernelversionforwhichthemodulewasbuilt.
Whentheinitscriptforamoduleisstarted,thescriptchecksifthemoduleexistsintherunningkernel'sdirectory.
Ifthemoduleispresent,thescriptusesmodprobetoloadthemoduleanditsdependencies.
Ifthemoduleisnotpresent,VMwareprovidedweakversioningdetermineswherethemoduleisinstalledandaddsasymlinkfromthe/lib/modules/running_kernel/extra/directorytothemodule'slocation.
Weakversioningrunsdepmod-aagaintoallowthemoduletobepickedupinthedependencylist.
Ifneeded,itrunsmkinitrdtobuildthemoduleintotheinitialramdisk.
Afterthemoduleisinstalledandlinked,itisloadedbythemodprobeutility.
AslongaskernelABIcompatibilityexistsbetweenthemoduleandtherunningkernel,themoduleloads,behavingasifitwerepartofthekernel.
VMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMware,Inc.
12PreparingforVMwareToolsOSPInstallation2YoumustcompletecertaintasksbeforeyouinstalltheVMwareToolsOSPs.
TheOSPsareontheVMwareWebsiteathttps://packages.
vmware.
com/tools.
LocatethedirectorythatcorrespondstoyourESXiinstallationandtheoperatingsystemwhereyouwanttoinstallOSPs.
SeetheOSPWebsiteforgeneralinformationandforlinkstodownloadsandsupportinformation:http://www.
vmware.
com/download/packages.
html.
Thischapterincludesthefollowingtopics:nUninstallExistingVMwareToolsnUbuntu8.
10OSPInstallationExceptionnDeterminingtheConfigurationMethodforInstallingVMwareToolsOSPsnInstallingtheVMwareToolsOSPswithaPackageManagernVMwareToolsOperatingSystemSpecificInstallationPackagesUninstallExistingVMwareToolsTouseVMwareToolsOSPs,usetheVMwarevSphereClienttouninstalltheexistingVMwareToolstopreventpackageconflictsandincorrectoperationofVMwareTools.
Themessagesinthesamplecommandsindicatethefollowingrequirements:n#rootpermissionisrequiredn$rootpermissionisnotrequiredProcedure1Fromthevirtualmachinecommandprompt,loginasroot.
2RuntheuninstallcommandtoremoveVMwareToolsthatwereinstalledwiththetarinstaller#vmware-uninstall-tools.
pl.
VMwareToolsareuninstalled.
VMware,Inc.
13Ubuntu8.
10OSPInstallationExceptionStartingwithUbuntu8.
10,open-vm-toolsispackagedwiththemultiverserepository.
VMwaredoesnotsupporttheuseofthesepackagesinVMwarevirtualmachines.
TheversionoftoolsavailableintheUbuntu8.
10multiverserepositoryisbasedonadevelopmentsnapshotoftheopen-vm-toolsprojecthostedonhttp://sourceforge.
net.
ThesepackagesarenotofficialVMwareToolsreleases.
VMwareGlobalSupportServicesmightrequirecustomersusingtheUbuntupackagestoremovethesepackagesandinstalltheofficialVMwareToolsreleaseaspartofasupportrequestrelatedtoUbuntu8.
10.
IfyouinstallunsupportedkernelmodulesinavirtualmachinethatalreadycontainsanofficialVMwareToolsrelease,theunsupportedmodulesoverwritetheVMwaremodules.
UninstallExistingUbuntuopen-vm-toolsPackagesforUbuntu13.
10andearlierreleasesYoumustremoveUbuntuopen-vm-toolspackagesiftheyareinstalledandverifythatyouuninstalledthem.
Procedure1RunthefollowingcommandtodeterminewhetheryouhavetheUbuntuopen-vm-toolspackageinstalled.
$sudodpkg-query-sopen-vm-toolsIftheresultstatesthattheopen-vm-toolspackageisnotinstalled,youcansafelyinstalltheOSPs.
2IftheUbuntuopen-vm-toolspackageisinstalled,removethepackage.
$sudoapt-getremoveopen-vm-tools3Verifythatyoudonothavetheopen-vm-toolspackageinstalledonthesystem.
$sudodpkg-query-sopen-vm-toolsAconfirmationindicatesthattheopen-vm-toolspackageisnotinstalledandnoinformationisavailable.
DeterminingtheConfigurationMethodforInstallingVMwareToolsOSPsYoucanuseapackagemanagertoinstallOSPsinmanyguestoperatingsystemreleases.
Incertainearlieroperatingsystems,youmustinstallOSPsmanually.
VMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMware,Inc.
14TheguestoperatingsystemdetermineswhichofthefollowingmethodsyoumustusetoconfigureyourguestoperatingsystemtoinstallOSPs.
PackagemanagerAtoolprovidedwiththeoperatingsystemthatprovidesdependencyresolutionamongpackages.
Youcaninstallmultiplepackagesinasinglecommand.
ManualconfigurationRequiresthatyouruneachcommandindividually.
YoucanusethesupportedpackagemanagerstoinstallOSPsinthefollowingguestoperatingsystems.
Table21.
SupportedPackageManagersPackageManagerGuestOperatingSystemsyumRedHatEnterpriseLinux6.
x,RedHatEnterpriseLinux5.
x,CentOS6.
x,CentOS5.
xaptUbuntu10.
04,10.
10,11.
04,11.
10,12.
04and13.
04rugSUSELinuxEnterpriseServer10andSUSELinuxEnterpriseDesktop10zypperSUSELinuxEnterpriseServer11andlaterservicepacksSUSELinuxEnterpriseDesktop11andlaterservicepacksNoteUse12.
04packageforUbuntu12.
10,13.
04and13.
10releases.
Thefollowingguestoperatingsystemsrequiremanualconfiguration:nRedHatEnterpriseLinux4andRedHatEnterpriseLinux3nSUSELinuxEnterpriseServer9nCentOS4InstallingtheVMwareToolsOSPswithaPackageManagerYouinstallVMwareToolsbyrunninganoperatingsystem-specificinstallationcommandinthevirtualmachine.
NoteIfyouinstalltheVMwareToolspackagesmanually,differentcommandsarerequiredandyoumustdownloadeachpackagebeforeyouinstallthepackages.
ForalistofVMwareToolspackages,seeVMwareToolsOperatingSystemSpecificInstallationPackages.
Iftheoperatingsystemhasapackagemanagersuchasyum,apt,rug,orzypper,thecommandyouuseinstallsalloftherequiredpackagesinasinglecommand.
YouselecttheconfigurationappropriatefortheenvironmentandinstalltheVMwareToolspackages.
Thevmware-tools-esx-kmods-kernel_typeandvmware-tools-esxorvmware-tools-esx-noxpackagesinstallalltheavailablecomponentsfortheoperatingsystem.
VMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMware,Inc.
15Table22.
VMwareToolsPackagesDescriptionPackagesVMwareToolswithgraphicscomponentsvmware-tools-esx-kmods-kernel_typevmware-tools-esxVMwareToolswithoutgraphicscomponentsvmware-tools-esx-kmods-kernel_typevmware-tools-esx-noxVMwareToolsOperatingSystemSpecificInstallationPackagesVMwareprovidesinstallationpackagesforeachsupportedguestoperatingsystemenvironment.
Thesequenceofpackageinstallationremainsthesameregardlessoftheenvironmentonwhichthevirtualmachineisrunning.
VMwareToolsKernelModulePackagesTheVMwareToolskernelmodulepackagesareinstalledinthe/lib/modulesdirectoryonthevirtualmachineafterdependencieshavebeenresolved.
NoteRHEL5andRHEL6kernelmodulepackagesuseadifferentnamingconventionthanthenamesshowninthefollowingtable.
Forexample,insteadofvmware-tools-module-kmp-kernel_type,RHEL5and6usekmod-vmware-tools-module-kernel_type,wheremoduleisthemodulenameandkernel_typeisthetypeofkernelinstalledonthevirtualmachine.
Ubuntukernelmodulepackagesalsouseadifferentnamingconventionthanthenamesshowninthefollowingtable.
Forexample,insteadofvmware-tools-module-kmp-kernel_type,Ubuntuusesvmware-tools-module-modules-kernel_type.
Table23.
VMwareToolsKernelModulePackagesPackageDescriptionvmware-tools-esx-kmods-kernel_typeInstallsalltherequiredVMwareToolskernelmodulepackagesforaparticularkernel.
Thismeta-packagedependsonthedefaultsetofkernelmodulepackagesforthekerneltypespecifiedwithkernel_type.
ThispackagedoesnotinstalltheuserspacecomponentsneededforVMwareToolsfunctionality.
Youmustseparatelyinstalltheuserspacepackagesthatmatchyourneeds.
Toviewthefulllistofpackagesthatthispackageinstalls,useyourpackagemanagertoshowthedependenciesofthispackage.
Typically,thismeta-packageisrunwiththevmware-tools-esxorvmware-tools-esx-noxpackagetocreateacompleteVMwareToolsOSPinstallationonthesystem.
vmware-tools-vmblock(SRPM)LetsyoubuildbinaryKernelModulePackages(kmps)forvmblockfortherunningkernel.
vmware-tools-vmblock-commonContainsthecommonfilesusedbyallvmblockKernelModulePackages.
Thesefilesincludethecommonconfigurationandsetupscriptsresponsibleforloadingavmblockkernelmodule.
VMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMware,Inc.
16Table23.
VMwareToolsKernelModulePackages(Continued)PackageDescriptionvmware-tools-vmblock-kmp-kernel_typeThevmblockkernelmodulebuiltfortheparticularkerneltype.
vmware-tools-vmci(SRPM)LetsyoubuildbinaryKernelModulePackages(kmps)forvmci.
vmware-tools-vmci-commonContainsthedevicedriverfortheVirtualMachineCommunicationInterface(VMCI)device.
ThisPCIdeviceprovideshigh-speedcommunicationbetweenthevirtualmachineanditshypervisororhostapplications,aswellasbetweenvirtualmachinesthatresideonthesamehost.
VMCIdoesnotrelyonguestnetworking.
vmware-tools-vmci-kmp-kernel_typeThevmcikernelmodulebuiltfortheparticularkerneltype.
vmware-tools-vmmemctl(SRPM)LetsyoubuildbinaryKernelModulePackages(kmps)forvmmemctl.
vmware-tools-vmmemctl-commonContainsthecommonconfigurationandsetupscriptsresponsibleforloadingthevmmemctlkernelmodule.
Thesefilesareusedbyallvmmemctl-kmppackages.
vmware-tools-vmmemctl-kmp-kernel_typeThevmmemctlkernelmodulebuiltfortheparticularkerneltype.
vmware-tools-vmxnet(SRPM)LetsyoubuildbinaryKernelModulePackages(kmps)forvmhgfs.
vmware-tools-vmxnet-commonContainstheVMwarevmxnetVirtualEthernetdriver.
vmware-tools-vmxnet-kmp-kernel_typeThevmxnetkernelmodulebuiltfortheparticularkerneltype.
vmware-tools-vmxnet3(SRPM)LetsyoubuildbinaryKernelModulePackages(kmps)forvmxnet3.
vmware-tools-vmxnet3-commonContainstheVMwarevmxnet3virtualNICdriver.
vmware-tools-vmxnet3-kmp-kernel_typeThevmxnet3kernelmodulebuiltfortheparticularkerneltype.
vmware-tools-pvscsi(SRPM)LetsyoubuildbinaryKernelModulePackages(kmps)forpvscsi.
vmware-tools-pvscsi-commonContainsthepvscsikernelmodule.
ParavirtualSCSI(PVSCSI)adaptersarehigh-performancestorageadaptersthatcangenerategreaterthroughputandlowerCPUutilization.
PVSCSIadaptersarebestsuitedforhigh-performancestorageenvironments.
FormoreinformationonPVSCSIadapters,seethevSphereBasicSystemAdministrationGuide.
vmware-tools-pvscsi-kmp-kernel_typeThepvscsikernelmodulebuiltfortheparticularkerneltype.
vmware-tools-vmsync-commonThevmsynckernelmoduleprovidesfunctionsusedbyVMwareToolstofreezeI/Otomountedfilesystemsandflushanyin-memorydatatodisk.
Thesefunctionsareusedwhenvirtualmachinesarequiesced.
vmware-tools-vmsync-kmp-kernel_typeThevmsynckernelmodulebuiltfortheparticularkerneltype.
VMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMware,Inc.
17Table23.
VMwareToolsKernelModulePackages(Continued)PackageDescriptionvmware-tools-vsock(SRPM)LetsyoubuildbinaryKernelModulePackages(kmps)forvmsock.
vmware-tools-vsock-commonContainstheVMCIsocketskernelmodule,whichprovidesaninterfacesimilartotheBerkeleyUNIXsocketsinterfaceforusingtheVMCIdevice.
VMCIsocketsallowsforsocket-basedcommunicationbetweenprocessesinthevirtualmachineandonthehost,aswellasbetweenprocessesrunningondifferentvirtualmachines.
vmware-tools-vsock-kmp-kernel_typeThevsockkernelmodulebuiltfortheparticularkerneltype.
Table24.
VMwareToolsGuestSDKPackagePackageDescriptionvmware-tools-guestsdkProvidestheheaderfilesanddocumentationneededtodevelopapplicationsthatinteractwithVMwareToolslibraries.
VMwareToolsPlug-inPackagesVMwareToolsplug-inpackagesprovideplug-insthatareusedwiththeVMwareToolsdaemon,vmtoolsd.
Theplug-insprovidefunctionssuchasdrag-and-dropoperations,timesynchronization,andcleanshutdownandpoweroperations.
Table25.
VMwareToolsServicesPlug-insPackageDescriptionvmware-tools-plugins-autoUpgradeProvidestheautoUpgradeplug-in,whichallowsVMwareToolstobeupgradedautomatically,basedonhostsettings.
Thisplug-inisusedwiththeVMwareToolsdaemon,vmtoolsd.
vmware-tools-plugins-deployPkgCcontainsaplug-inthatisusedwiththeVMwareToolsdaemon,vmtoolsd.
Thisplug-inenablesimagecustomization,whichallowsthehosttocustomizevirtualmachineimages.
vmware-tools-plugins-guestInfoProvidesaplug-inthatcollectsguestconfigurationandstateinformation,suchasstoragecapacityandnetworkingstate,andmakestheinformationavailableviathevSphereSDK.
Theplug-inisusedwiththeVMwareToolsdaemon,vmtoolsd.
vmware-tools-plugins-hgfsServerContainsaplug-inthatprovidestheHost-GuestFileSystemfileserverforthevirtualhost'sHost-GuestFileSystemclientfilecopylibrary.
Thislibraryallowsthevirtualhosttoperformfilecopyoperationstoandfromtheguest.
Theplug-inisusedwiththeVMwareToolsdaemon,vmtoolsd.
vmware-tools-plugins-powerOpsContainsaplug-inthatprovidesthesoftpoweroperationsfeature.
Thisfeatureallowscleanpoweroffandprovideshookstoexecutescriptswhenthevirtualmachinepowerson,powersoff,suspends,andresumes.
Theplug-inisusedwiththeVMwareToolsdaemon,vmtoolsdvmware-tools-plugins-timeSyncProvidesthetimeSyncplug-in,whichmaintainsthecorrecttimeintheguestoperatingsystemintheabsenceofanNTPserver.
Italsosynchronizesguesttimewiththehostatstartupandafterresume.
Theplug-inisusedwiththeVMwareToolsdaemon,vmtoolsd.
VMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMware,Inc.
18Table25.
VMwareToolsServicesPlug-ins(Continued)PackageDescriptionvmware-tools-plugins-vixContainsaplug-inthatprovidestheguestmanagementoperationsfeatureforthevSphereWebServicesSDKandtheVMwareVIXAPI.
Thisfeatureincludesfilecopyoperationstoandfromtheguest,processmanagement,andsimilarguestoperations.
Formoreinformationaboutguestoperations,seethereferenceguidesfortheVMwareVIXAPIandtheGuestOperationsManagerobjectofthevSphereWebServicesSDK.
Thisplug-inisusedwiththeVMwareToolsdaemon,vmtoolsd.
vmware-tools-plugins-vmbackupProvidesthevmbackupplug-in,whichdeliversfunctionalityforquiescingapplicationsandfilesystemsintheguestoperatingsystemsothatthevirtualmachineisinaconsistentstatewhenyoucreatesnapshotsorbackups.
Theplug-inisusedwiththeVMwareToolsdaemon,vmtoolsd.
vmware-tools-servicesProvidesthefundamentalapplicationsthatVMwareToolsneedstofunction.
ThispackageincludesthepivotalVMwareToolsdaemon,vmtoolsd,whichallowsthemajorityofservicestofunctioninguestoperatingsystems.
ItalsoincludesthecommandlineversionoftheVMwaretoolboxtoadjustsettingswithintools,anditincludesafewotherlibrariesneededforfunctionality.
Table26.
VMwareToolsUserPlug-insPackageDescriptionvmware-tools-plugins-dndcpProvidestheguestuser-levelagentplug-in,whichprovidesdrag-and-dropandcopy-and-pasteoperations.
Variousformatsaresupported,includingfile,text,rtf,andimage.
Theplug-inisusedwiththeVMwareToolsdaemon,vmtoolsd.
vmware-tools-plugins-grabbitmqProxyEnablesAMQPconnectionsfromclientsingueststoAMQPbrokerrunningonhostmanagementnetwork.
vmware-tools-plugins-resolutionSetThispluginadjuststheguest'svirtualmonitortomatchthewindowinwhichthevirtualmonitorisdisplayed.
Theplug-inisusedwiththeVMwareToolsdaemon,vmtoolsdvmware-tools-userEnhancesthehost-guestUIexperiencebyprovidingadditionalhost-guestfeatures.
AVMwareusercanmatchthescreenresolutionbetweenhostandguest.
Thispackagealsoenablesdrag-and-dropcopyoperationsbetweentheguestandhostonsystemswherehost-guestdrag-and-dropissupported.
vmware-tools-vgauthProvidesSAMLbasedguestauthentication.
VMwareToolsPackagesWithoutGraphicsComponentsTheVMwareToolspackageswithoutgraphics(XWindow)supportaredesignedforLinuxserversthatdonotneedtoprovidewindowsoutputoracceptuserinputfromdesktopdevices.
Table27.
VMwareToolsPackagesWithoutGraphicsComponentsPackageDescriptionvmware-tools-coreContainsallessentialapplicationsandlibrariesneededbyVMwareToolstofunction.
ThispackageincludesallcomponentsthatareapartoftheVMwareToolscriticalpath.
vmware-tools-foundationProvidesasanitycheckfortheVMwareToolsinstallation,ensuringthatnootherinstallationsofVMwareToolsarepresent.
ThispackagealsoaddscriticaldatatotheVMwareToolsdatabasefile.
VMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMware,Inc.
19Table27.
VMwareToolsPackagesWithoutGraphicsComponents(Continued)PackageDescriptionvmware-tools-guestlibProvidesalibraryfortheguestoperatingsystem.
vmware-tools-helpContainsthehelp-relateddocumentationforVMwareTools.
vmware-tools-libraries-noxContainsthelibrariesnotrelatedtoXOrgthatareusedbytheapplicationsincludedwithVMwareToolsifthesystemlibrariesareinsufficient.
ThelibrariesprovidedbythispackageareusedifthenativelibrariesincludedintheguestoperatingsystemarenotrecentenoughtoruntheVMwareToolsapplications.
vmware-tools-esx-noxInstallsalightweightversionoftheVMwareToolsOSPsonasystemwithoutsupportforXWindows.
Thismeta-packagecreatesthedependenciestoproperlyinstallVMwareTools,butitprovidesonlythecommand-linebasedapplicationsincludedwithVMwareTools.
Itdoesnotincludegraphicalapplicationsortheirassociatedlibraries.
VMwareToolsPackagesWithGraphicsComponentsTheVMwareToolspackageswithgraphics(XWindow)supportaredesignedforLinuxvirtualmachinesthatmustprovidewindowsoutputandacceptuserinputfromdesktopdevices.
Table28.
VMwareToolsPackagesWithGraphicsComponentsPackageDescriptionvmware-tools-esxInstallsafulluserspaceinstallationoftheVMwareToolsOSPs.
Thismeta-packageestablishesdependenciesontheotheruserspacepackagesneededtocreateauserspaceinstallation.
Thismeta-packagedoesnotinstalltheVMwareToolskernelmodulepackagesneededbytheuserspacecomponents.
Youmustinstalltheappropriatekernelmodulepackagesseparately.
Toviewthefulllistofpackagesthatthismeta-packageinstalls,useyourpackagemanagertoshowthedependenciesofthispackage.
vmware-tools-libraries-xContainsthelibrariesrelatedtoXOrgthatareusedbytheapplicationsincludedwithVMwareToolsifthesystemlibrariesareinsufficient.
ThelibrariesprovidedbythispackageareusedifthenativelibrariesincludedintheguestoperatingsystemarenotrecentenoughtoruntheVMwareToolsapplications.
Table29.
VMwareToolsXorgPackagesPackageDescriptionvmware-tools-xorg-drv-displayContainstheXOrgdisplaydriverthatisusedinVMwarevirtualmachines.
WhenthisdriverisusedwithVMwareTools,itoptimizes2Dgraphicsperformanceandenablesanumberoffeaturessuchasunity,guestautofit,andmulti-monitorfullscreen.
vmware-tools-xorg-drv-mouseContainstheXOrgmousedriverthatisusedinVMwarevirtualmachines.
Thisdriverensuresthatthemousepointermovementintheguestisconsistentwiththehostpointermovement,withminimallatency.
VMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMware,Inc.
20InstallingVMwareToolsOSPs3TheguestoperatingsystemyouareusingdeterminestheVMwareToolsinstallationprocessesthatyouperform.
Thischapterincludesthefollowingtopics:nDistributionSuppliedDisplayandMousePackagesnDistributionSuppliedKernelModulePackagesnInstallingVMwareToolsUsingOSPsforRHEL6.
x,RHEL5.
x,CentOS6.
x,andCentOS5.
xGuestOperatingSystemsnInstallingVMwareToolsUsingOSPsforRHEL4,CentOS4,andRHEL3GuestOperatingSystemsnInstallingVMwareToolsUsingOSPsforSLES11andlaterservicepacks,SLED11andlaterservicepacksGuestOperatingSystemsnInstallingVMwareToolsUsingOSPsforSLES10andSLED10GuestOperatingSystemsnInstallingVMwareToolsUsingOSPsforSLES9GuestOperatingSystemnInstallingVMwareToolsUsingOSPsforUbuntuGuestOperatingSystemnVerifyVMwareToolsInstallationDistributionSuppliedDisplayandMousePackagesVMwareToolsOSPscontainmetapackagesthatmanagetheinstallationofthedriverpackagesandthatprovidethemouseanddisplaydriversforESXi.
Distribution-suppliedpackagesthatprovidemouseanddisplaydriversforESXitakeprecedenceoverthesamedriverssuppliedbytheVMwareToolsOSPpackages.
Theprecedenceassumesthatthedistribution-suppliedpackagesfunctionasexpectedandthatthedriverswereconfiguredproperlytomanagethedisplayandmouse.
DistributionSuppliedKernelModulePackagesBydefault,certainVMwareToolskernelmodulesareprovidedwithinthenativeRHEL6,SLESandlaterservicepacks,SLEDandlaterservicepacks,andUbuntukernelpackages.
VMware,Inc.
21OperatingSystemPackageCorrespondingVMwareToolsPackagevmxnet3vmware-tools-vmxnet3vmw_pvscsivmware-tools-pvscsivmware_balloonvmware-tools-vmmemctlNoteThevmware_balloonkernelmoduleisincludedinthekernelpackagesdistributedwithRHEL6andlaterandallkernels2.
6.
34andlater.
WhenyouinstalltheVMwareToolspackages,theVMwareprovidedpackagesarenotinstalledbydefault.
ThedistributionprovidedpackagesworkwiththeotherVMwareToolspackagesforanygivenkerneldistribution.
ToreplacethesepackageswiththecorrespondingVMwareToolsprovidedpackages,usethezyppercommandforSUSEdistributionsortheaptcommandforUbuntudistributions.
ForinstructionsonoverridingthedistributionsuppliedVMwaremodulesonRHEL6,seeInstallVMwareToolsforRHEL6.
x,RHEL5.
x,CentOS6.
x,andCentOS5.
xGuestOperatingSystems.
InstallingVMwareToolsUsingOSPsforRHEL6.
x,RHEL5.
x,CentOS6.
x,andCentOS5.
xGuestOperatingSystemsWhenyouuseapackagemanagertoinstallVMwareTools,youimporttheVMwarePackagingPublicKeys,edittheproxy,andconfigurethesoftware.
Editingtheproxyisoptional.
RegisterRHEL6andRHEL5withtheRedHatNetworkToaccessadditionalRHEL6orRHEL5packages,registeryourRHEL6orRHEL5virtualmachinewiththeRedHatNetwork.
ProcedureuFollowtheinstructionsinyourRedHatoperatingsystemdocumentationtoregistertheRHEL6orRHEL5virtualmachinewithyourRedHadNetwork.
PreparetoInstallOSPsforRHEL6.
x,RHEL5.
x,CentOS6.
x,andCentOS5.
xGuestOperatingSystemsBeforeyouinstallOSPswithapackagemanager,youmustimportVMwarepackagingkeyfiles,createandeditarepositoryfile,andtakeotherstepstopreparefortheinstallation.
TheOSPsarelocatedontheVMwareToolspackagesWebsiteathttps://packages.
vmware.
com/tools.
NoteOSPsinthe/5.
0latest/directoryontheVMwareToolspackagesWebsitearenotavailableforRHEL5andRHEL6.
PrerequisitesLocatethedirectorythatcorrespondstoyourESXireleaseandtheoperatingsystemonwhichyouwanttoinstalltheOSPs.
Forthecompletelistofpackagestoinstall,seeVMwareToolsOperatingSystemSpecificInstallationPackages.
VMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMware,Inc.
22Procedure1ObtainandimporttheVMwarePackagingPublicKeys.
aCreateadirectoryonthevirtualmachinetostoretheVMwarePackagingPublicKeys.
bUseaWebbrowsertodownloadalltheVMwarePublicPackagingPublicKeysfromthehttps://packages.
vmware.
com/tools/keysdirectory.
cSavethekeyfilestothedirectoryyoucreated.
dForeachkeythatyoudownload,runthefollowingcommandtoimportthekey.
#rpm--import/key_path/key_namekey_pathisthedirectoryinwhichyousavedthekeys.
key_nameisthefilenameofakey.
2(Optional)Setuptheproxyserverinformationin/etc/yum.
conf.
Forexample:proxy=http://squid.
example.
com:3128proxy_username=proxyuserproxy_password=proxypass3CreateandedittheVMwarerepositorydirectoryandfile.
Ifitdoesnotexist,createthedirectoryandrepositoryfileonthevirtualmachine.
Youcanselectanynameforthisfile,butitmustusethe.
repofileextension.
Forexample:/etc/yum.
repos.
d/vmware-tools.
repo4Addthefollowingcontentstotherepositoryfileandsave.
[vmware-tools]name=VMwareToolsbaseurl=https://packages.
vmware.
com/tools/esx/esxi-version/dist/archenabled=1gpgcheck=1repo_gpgcheck=1gpgkey=https://packages.
vmware.
com/tools/keys/VMWARE-PACKAGING-GPG-RSA-KEY.
pubesxi-versionistheESXiversion.
Forexample:5.
1or5.
0u1.
distisrhel5orrhel6.
archthearchitectureoptionfor32-bitisi386andfor64-bitisx86_64.
CentOS5usestherhel5baseurl.
VMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMware,Inc.
23AsanalternativetostepsStep3andStep4,youcandownloadtherepositoryconfigurationpackageforyourdistributionfromthehttps://packages.
vmware.
com/tools/esx/esxi-version/reposdirectory,whereesxi-versionisyourESXiversion.
Forexample:5.
1or5.
0u1.
Selecttheproperarchitectureforyourdistribution.
Forexample,intheESXi5.
0release,foraRHEL5distributionona64-bitsystem,youmightselectvmware-tools-repo-RHEL5-8.
6.
0-0.
x86_64.
ForaRHEL5distributionona32-bitsystem,youmightselectvmware-tools-repo-RHEL5-8.
6.
0-0.
i686.
InstallVMwareToolsforRHEL6.
x,RHEL5.
x,CentOS6.
x,andCentOS5.
xGuestOperatingSystemsRHEL6.
x,RHEL5.
x,CentOS6.
x,andCentOS5.
xusetheyumpackagemanagementtool.
WhenyouspecifytheVMwareToolspackage,theyumpackagemanagementtoolinstallsanyrequiredadditionalpackages.
Foralistofpackagestoinstall,seeVMwareToolsOperatingSystemSpecificInstallationPackages.
PrerequisitesnVerifythatyoucompletedthetasksdescribedinChapter2PreparingforVMwareToolsOSPInstallation.
nVerifythatyoucompletedthetasksdescribedinPreparetoInstallOSPsforRHEL6.
x,RHEL5.
x,CentOS6.
x,andCentOS5.
xGuestOperatingSystems.
Procedure1Openacommandwindowintheguestoperatingsystem.
2Runthe`uname-r`commandtoidentifythetypeofkernelthatisinstalledonthevirtualmachine.
Forexample,the`uname-r`commandmightdisplay2.
6.
18-53.
el5-PAE,where2.
6.
18-53.
el5isthekernelandPAEisthekerneltype.
KerneltypescanbePAEorpae.
InRHELkernels,ifthedefaulttypeisinstalled,notypeisdisplayed.
3Runtheyumcommand.
#yuminstallvmware-tools-esx-kmodsvmware-tools-esx4Restartthevirtualmachine.
OnRHEL6,thefollowingpackagesarenotinstalledbydefault,astheyareprovidedbythekernel:nvmware-tools-vmxnet3nvmware-tools-pvscsinvmware-tools-vmmemctlYoucaninstalltheVMwareToolsprovidedpackagestoreplacethecorrespondingkernel-providedpackages.
VMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMware,Inc.
24OnRHEL5,RHEL6,andlater,modulessuppliedbythekerneltakeprecedenceovermodulesthatareweaklyversioned.
Forinformation,seeWeakVersioningforVMwareToolsOSPs.
Toreplacethesepackages,youmustrecompilethemodulesfromsourceandinstalltheresultingpackages.
SeeBuildtheBinaryKernelModulePackagesforRHEL6,RHEL5,CentOS6,andCentOS5.
ImportantThedistribution-providedpackagesfunctionwithVMwareTools.
Takethissteponlyifyouhaveaspecificreasontodoso.
WhattodonextToverifytheinstallation,followtheinstructionsinVerifyVMwareToolsInstallation.
InstallingVMwareToolsUsingOSPsforRHEL4,CentOS4,andRHEL3GuestOperatingSystemsPackagemanagementtoolssuchasyumarenotcurrentlysupportedforRHEL4,CentOS4,andRHEL3.
YoumustinstalltheVMwareToolspackagesmanually.
DownloadOSPsfortheRHEL4,CentOS4,andRHEL3GuestOperatingSystemsYoumustdownloadallofthepackagesforagivendistributionandarchitecturetothevirtualmachineonwhichyouplantoinstallVMwareTools.
TheOSPsarelocatedontheVMwareToolspackagesWebsiteathttps://packages.
vmware.
com/tools.
NoteDonotusetheOSPsinthe/latest/directoryontheVMwareToolspackagesWebsite.
TheOSPsinthe/latest/directoryareforinformationalpurposesonlyanddonotworkwiththeoperatingsystempackagemanager.
PrerequisitesLocatethedirectorythatcorrespondstoyourESXireleaseandtheoperatingsystemonwhichyouwanttoinstalltheOSPs.
Forthecompletelistofpackagestoinstall,seeVMwareToolsOperatingSystemSpecificInstallationPackages.
Procedure1ObtainandimporttheVMwarePackagingPublicKeys.
aCreateadirectoryonthevirtualmachinetostoretheVMwarePackagingPublicKeys.
bUseaWebbrowsertodownloadtheVMwarePublicPackagingDSAPublicKeyfile,VMWARE-PACKAGING-GPG-DSA-KEY.
pub,fromthehttps://packages.
vmware.
com/tools/keysdirectory.
VMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMware,Inc.
25cSavethefilestothedirectoryyoucreated.
dForeachkeythatyoudownload,runthefollowingcommandtoimportthekey.
#rpm--import/key_path/key_namekey_pathisthedirectoryinwhichyousavedthekeys.
key_nameisthefilenameofakey.
2BrowsetotheESXirepositoryontheVMwareToolspackagesWebsite:https://packages.
vmware.
com/tools/releases/10.
0.
12.
3Selectthesubdirectoryforyouroperatingsystem.
CentOS4usestherhel4VMwareToolspackages.
4Selectthesubdirectorythatcontainsthepackagesforyourvirtualmachine'sarchitecture.
OptionDescriptionx86_64/64-bitpackagesi386/32-bitpackages5CreateadirectoryforthepackagesonthevirtualmachinewhereyouplantoinstallVMwareTools.
/vmware-tools-path/6Downloadthepackagestothedirectoryyoucreated.
InstallVMwareToolsforRHEL4,CentOS4,andRHEL3GuestOperatingSystemsYoumustmanuallyrunrpmcommandstoinstallVMwareToolsonRHEL4,CentOS4,andRHEL3virtualmachines.
Foralistofpackagestoinstall,seeVMwareToolsOperatingSystemSpecificInstallationPackages.
NoteWhenyouinstallVMwareToolsOSPsona64-bitRHEL3u9ASdistribution,youcannotchangethescreenresolutiontoahighervaluethan800x600.
PrerequisitesnVerifythatyoucompletedthetasksdescribedinChapter2PreparingforVMwareToolsOSPInstallation.
nVerifythatyoucompletedthetasksdescribedinDownloadOSPsfortheRHEL4,CentOS4,andRHEL3GuestOperatingSystems.
VMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMware,Inc.
26Procedure1Fromthevirtualmachinecommandline,backuptheSVGAdriver.
OptionDescription32-bit#cp/usr/X11R6/lib/modules/drivers/vmware_drv.
o/usr/X11R6/lib/modules/drivers/vmware_drv.
o.
backup64-bit#cp/usr/X11R6/lib64/modules/drivers/vmware_drv.
o/usr/X11R6/lib64/modules/drivers/vmware_drv.
o.
backup2InstalltheVMwareToolspackages.
#rpm-ivh--forcevmware-tools-*.
rpmWhenthiscommandruns,alloftheotherpackagesareinstalledinthecorrectorder.
Thiscommandinstallskernelmodulepackagesforalltheavailablekernels,whichensuresthatthepackagesrequiredfortherunningkernelareinstalled.
WhattodonextToverifytheinstallation,followtheinstructionsinVerifyVMwareToolsInstallation.
InstallingVMwareToolsUsingOSPsforSLES11andlaterservicepacks,SLED11andlaterservicepacksGuestOperatingSystemsWhenyouuseapackagemanagertoinstallVMwareTools,youimporttheVMwarePackagingPublicKeys,edittheproxy,andconfigurethesoftware.
Editingtheproxyisoptional.
PreparetoInstallOSPsforSLES11andlaterservicepacks,SLED11andlaterservicepacksGuestOperatingSystemsBeforeyouinstallOSPswithapackagemanager,youmustimportVMwarepackagingkeyfiles,createandeditarepositoryfile,andtakeotherstepstopreparefortheinstallation.
TheOSPsarelocatedontheVMwareWebsiteathttps://packages.
vmware.
com/tools.
NoteDonotusetheOSPsinthe/latest/directoryontheVMwareToolspackagesWebsite.
TheOSPsinthe/latest/directoryareforinformationalpurposesonlyanddonotworkwiththeoperatingsystempackagemanager.
PrerequisitesLocatethedirectorythatcorrespondstoyourESXireleaseandtheoperatingsystemonwhichyouwanttoinstalltheOSPs.
Forthecompletelistofpackagestoinstall,seeVMwareToolsOperatingSystemSpecificInstallationPackages.
VMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMware,Inc.
27Procedure1ObtainandimporttheVMwarePackagingPublicKeys.
aCreateadirectoryonthevirtualmachinetostoretheVMwarePackagingPublicKeys.
bUseaWebbrowsertodownloadalltheVMwarePublicPackagingPublicKeyfilesfromthehttps://packages.
vmware.
com/tools/keysdirectory.
cSavethefilesintothedirectoryyoucreated.
dForeachkeythatyoudownload,runthefollowingcommandtoimportthekey.
#rpm--import/key_path/key_namekey_pathisthedirectoryinwhichyousavedthekeys.
key_nameisthefilenameofakey.
2(Optional)Configuretheproxy.
#exporthttp_proxy=http://squid.
example.
com:31283CreateandedittheVMwarezypperrepository.
aAddtheyumstylerepositoryasazypperservice.
Youmusttypetheentirecommand.
#zypperaddservice--type=YUMhttps://packages.
vmware.
com/tools/esx/esxi-version/dist/archvmware-tools-collectionesxi-versionistheESXiversion.
Forexample:5.
1or5.
0u1.
distissles11.
2,sles11.
1,orsles11.
0.
arch.
Thearchitectureoptionfor32-bitisi586andfor64-bitisx86_64.
bVerifytherepositoryconfiguration.
#zypperpackagesvmware-tools-collectionAsanalternativetocreatingandeditingtheVMwarezypperrepository,youcandownloadtherepositoryconfigurationpackageforyourdistributionfromthehttps://packages.
vmware.
com/tools/esx/esxi-version/reposdirectory.
Replaceesxi-versionwithyourESXiversion.
Forexample:5.
1or5.
0u1.
Selecttheproperarchitectureforyourdistribution.
Forexample,intheESXi5.
0release,foraSLES11SP1distributionona64-bitsystem,youmightselectvmware-tools-repo-SLES11.
1-8.
6.
0-0.
x86_64.
ForaSLES11SP1distributionona32-bitsystem,youmightselectvmware-tools-repo-SLES11.
1-8.
6.
0-0.
i586.
VMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMware,Inc.
28InstallVMwareToolsforSLES11andlaterservicepackages,SLED11andlaterservicepackagesGuestOperatingSystemsUsethezypperpackagemanagementtooltoinstallVMwareToolsonaSLESandlaterservicepackages,SLED11andlaterservicepackagesguestoperatingsystem.
WhenyouspecifytheVMwareToolspackage,zypperinstallsanyadditionalrequiredpackages.
Foralistofpackagestoinstall,seeVMwareToolsOperatingSystemSpecificInstallationPackages.
PrerequisitesnVerifythatyoucompletedthetasksdescribedinChapter2PreparingforVMwareToolsOSPInstallation.
nVerifythatyoucompletedthetasksdescribedinPreparetoInstallOSPsforSLES11andlaterservicepacks,SLED11andlaterservicepacksGuestOperatingSystems.
Procedure1Openacommandwindowintheguestoperatingsystem.
2Runthe`uname-r`commandtoidentifythetypeofkernelthatisinstalledonthevirtualmachine.
Thiscommanddisplaysthekernelandkerneltype.
Kerneltypescanbedefault,pae,orvmi.
3RunthefollowingcommandtoinstalltheVMwareToolspackage.
#zypperinstallvmware-tools-collectionvmware-tools-esx-kmods-kernel_typevmware-tools-esxForexample,ifthekernel_typeisdefault,usevmware-tools-esx-kmods-defaultinthecommand.
Whenyourunthiscommand,alloftheotherpackagesareautomaticallyinstalledinthecorrectorder.
4(Optional)OnSLES11andlaterservicepackages,SLEDandlaterservicepackages,installcertainVMwareToolsprovidedpackagestoreplacethecorrespondingsystem-providedpackages.
ImportantThedistribution-providedpackagesfunctionwithVMwareTools.
Installthesepackagesonlyifyouhaveaspecificreasontodoso.
nvmware-tools-vmxnet3nvmware-tools-pvscsiWhenyouinstalltheVMwareToolspackagesforSLES11SP1,SLES11,andSLED11,thefollowingmessageappears:Thefollowingpackagesarenotsupportedbytheirvendor:packagenamesThemessagevariesdependingonwhichversionofVMwareToolsyouhaveinstalled.
Youcansafelyignorethismessage.
VMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMware,Inc.
29WhattodonextToverifytheinstallation,followtheinstructionsinVerifyVMwareToolsInstallation.
InstallingVMwareToolsUsingOSPsforSLES10andSLED10GuestOperatingSystemsWhenyouuseapackagemanagertoinstallVMwareTools,youimporttheVMwarePackagingPublicKeys,edittheproxy,andconfigurethesoftware.
Editingtheproxyisoptional.
PreparetoInstallOSPsfortheSLES10andSLED10GuestOperatingSystemBeforeyouinstallOSPswithapackagemanager,youmustimportVMwarepackagingkeyfiles,createandeditarepositoryfile,andtakeotherstepstopreparefortheinstallation.
TheOSPsarelocatedontheVMwareWebsiteathttps://packages.
vmware.
com/tools.
NoteDonotusetheOSPsinthe/latest/directoryontheVMwareToolspackagesWebsite.
TheOSPsinthe/latest/directoryareforinformationalpurposesonlyanddonotworkwiththeoperatingsystempackagemanager.
PrerequisitesLocatethedirectorythatcorrespondstoyourESXireleaseandtheoperatingsystemonwhichyouwanttoinstalltheOSPs.
Foracompletelistofpackagestoinstall,seeVMwareToolsOperatingSystemSpecificInstallationPackages.
Procedure1ObtainandimporttheVMwarePackagingPublicKeys.
aCreateadirectoryonthevirtualmachinetostoretheVMwarePackagingPublicKeys.
bUseaWebbrowsertodownloadalltheVMwarePublicPackagingPublicKeyfilesfromthehttps://packages.
vmware.
com/tools/keysdirectory.
cSavethefilesintothedirectoryyoucreated.
dForeachkeythatyoudownload,runthefollowingcommandtoimportthekey.
#rpm--import/key_path/key_namekey_pathisthedirectoryinwhichyousavedthekeys.
key_nameisthefilenameofakey.
2(Optional)Configuretheproxyusingtherugcommand.
#rugset-prefsproxy-urlhttp://squid.
example.
com:3128VMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMware,Inc.
303CreateandedittheVMwarerugrepository.
aAddtheyumstylerepositoryasarugservice.
#rugservice-add--type=YUMhttps://packages.
vmware.
com/tools/releases/10.
0.
12/sles10/archarch.
Thearchitectureoptionfor32-bitisi586andfor64-bitisx86_64.
bVerifytherepositoryconfiguration.
#rugpackagesvmware-tools-collection4Subscribetotherugcatalog.
#rugsubscribe-aInstallVMwareToolsfortheSLES10andSLED10GuestOperatingSystemUsetherugpackagemanagementtooltoinstallVMwareToolsonaSLES10andSLED10virtualmachine.
WhenyouspecifytheVMwareToolspackage,ruginstallsanyadditionalrequiredpackages.
Foralistofpackagestoinstall,seeVMwareToolsOperatingSystemSpecificInstallationPackages.
PrerequisitesnVerifythatyoucompletedthetasksdescribedinChapter2PreparingforVMwareToolsOSPInstallation.
nVerifythatyoucompletedthetasksdescribedinPreparetoInstallOSPsfortheSLES10andSLED10GuestOperatingSystem.
Procedure1Openacommandwindowintheguestoperatingsystem.
2Runthe`uname-r`commandtoidentifythetypeofkernelthatisinstalledonthevirtualmachine.
Thiscommanddisplaysthekernelandkerneltype.
Kerneltypescanbedefault,smp,bigsmp,vmi,orvmipae.
3RunthefollowingcommandtoinstalltheVMwareToolspackages.
#ruginstall-cvmware-tools-collectionvmware-tools-esx-kmods-kernel_typevmware-tools-esxForexample,ifthekernel_typeisdefault,usevmware-tools-esx-kmods-defaultinthecommand.
Alloftheotherpackagesareinstalledinthecorrectorder.
VMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMware,Inc.
31WhattodonextToverifytheinstallation,followtheinstructionsinVerifyVMwareToolsInstallation.
InstallingVMwareToolsUsingOSPsforSLES9GuestOperatingSystemPackagemanagementtoolssuchasrugarenotcurrentlysupportedforSLES9.
YoumustinstalltheVMwareToolspackagesmanually.
DownloadOSPsfortheSLES9GuestOperatingSystemYoumustdownloadallofthepackagesforagivendistributionandarchitecturetothevirtualmachineonwhichyouplantoinstallVMwareTools.
TheOSPsarelocatedontheVMwareWebsiteathttps://packages.
vmware.
com/tools.
NoteDonotusetheOSPsinthe/latest/directoryontheVMwareToolspackagesWebsite.
TheOSPsinthe/latest/directoryareforinformationalpurposesonlyanddonotworkwiththeoperatingsystempackagemanager.
PrerequisitesLocatethedirectorythatcorrespondstoyourESXireleaseandtheoperatingsystemonwhichyouwanttoinstalltheOSPs.
Foracompletelistofpackagestoinstall,seeVMwareToolsOperatingSystemSpecificInstallationPackages.
Procedure1ObtainandimporttheVMwarePackagingPublicKeys.
aCreateadirectoryonthevirtualmachinetostoretheVMwarePackagingPublicKeys.
bUseaWebbrowsertodownloadtheVMwarePublicPackagingDSAPublicKeyfile,VMWARE-PACKAGING-GPG-DSA-KEY.
pub,fromthehttps://packages.
vmware.
com/tools/keysdirectory.
cSavethefilesintothedirectoryyoucreated.
dForeachkeythatyoudownload,runthefollowingcommandtoimportthekey.
#rpm--import/key_path/key_namekey_pathisthedirectoryinwhichyousavedthekeys.
key_nameisthefilenameofakey.
2BrowsetotheESXirepositoryathttps://packages.
vmware.
com/tools/releases/10.
0.
12/sles9spx.
xistheminorSLES9releasenumbersuchasSLES9SP1.
Forexample:https://packages.
vmware.
com/tools/releases/10.
0.
12/sles9sp1VMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMware,Inc.
323Selectthesubdirectorythatcontainsthepackagesforyourvirtualmachine'sarchitecture.
OptionDescriptionx86_64/64-bitpackagesi586/32-bitpackages4CreateadirectoryforthepackagesonthevirtualmachineonwhichyouplantoinstallVMwareTools.
/vmware-tools-path/5Downloadthepackagestothedirectoryyoucreated.
InstallVMwareToolsfortheSLES9GuestOperatingSystemYoumustmanuallyrunrpmcommandstoinstallVMwareToolsonaSLES9virtualmachine.
Foralistofpackagestoinstall,seeVMwareToolsOperatingSystemSpecificInstallationPackages.
PrerequisitesnVerifythatyouhavecompletedthetasksdescribedinChapter2PreparingforVMwareToolsOSPInstallation.
nVerifythatyouhavecompletedthetasksdescribedinDownloadOSPsfortheSLES9GuestOperatingSystem.
Procedure1(Optional)Fromthevirtualmachinecommandline,backuptheSVGAdriverfromSUSE.
OptionDescription32-bit#cp/usr/X11R6/lib/modules/drivers/vmware_drv.
o/usr/X11R6/lib/modules/drivers/vmware_drv.
o.
backup64-bitNoSVGAdriverisprovidedbySUSE.
2RunthefollowingcommandtoinstalltheVMwareToolspackages.
#rpm-ivh--forcevmware-tools-*.
rpmWhenyourunthiscommand,alloftheotherpackagesareinstalledinthecorrectorder.
WhenyouinstalltheVMwareToolspackagesforSLES9,thefollowingmessageappears.
Warning"vmware-tools-8.
3.
0-206098.
el4.
i686.
rpm:V3RSA/MD5signature:NOKEY,keyID66fd4949.
"Youcansafelyignorethismessage.
WhattodonextToverifytheinstallation,followtheinstructionsinVerifyVMwareToolsInstallation.
VMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMware,Inc.
33InstallingVMwareToolsUsingOSPsforUbuntuGuestOperatingSystemWhenyouuseapackagemanagertoinstallVMwareTools,youimporttheVMwarePackagingPublicKeys,edittheproxy,andconfigurethesoftware.
Editingtheproxyisoptional.
PreparetoInstallOSPsfortheUbuntuGuestOperatingSystemBeforeyouinstallOSPswithapackagemanager,youmustimportVMwarepackagingkeyfiles,createandeditarepositoryfile,andtakeotherstepstopreparefortheinstallation.
TheOSPsarelocatedontheVMwareWebsiteathttps://packages.
vmware.
com/tools.
NoteDonotusetheOSPsinthe/latest/directoryontheVMwareToolspackagesWebsite.
TheOSPsinthe/latest/directoryareforinformationalpurposesonlyanddonotworkwiththeoperatingsystempackagemanager.
PrerequisitesLocatethedirectorythatcorrespondstoyourESXireleaseandtheoperatingsystemonwhichyouwanttoinstalltheOSPs.
Foracompletelistofpackagestoinstall,seeVMwareToolsOperatingSystemSpecificInstallationPackages.
Procedure1ObtainandimporttheVMwarePackagingPublicKeys.
aCreateadirectoryonthevirtualmachinetostoretheVMwarePackagingPublicKeys.
bUseaWebbrowsertodownloadalltheVMwarePublicPackagingPublicKeyfilesfromthehttps://packages.
vmware.
com/tools/keysdirectory.
cSavethefilestothedirectoryyoucreated.
dForeachkeythatyoudownload,runthefollowingcommandtoimportthekey.
$sudoapt-keyadd/key_path/key_namekey_pathisthedirectoryinwhichyousavedthekeys.
key_nameisthefilenameofakey.
VMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMware,Inc.
342(Optional)ConfiguretheproxyfromtheguestoperatingsystemonthevirtualmachinewhereyouplantoinstallVMwareTools.
a(Optional)Createaconfigurationfile.
bAddthefollowingcontentstothe/etc/apt/apt-getconffile.
ACQUIRE{http::proxy"http://[[user][:pass]@]host[:port]/"}Forexample:ACQUIRE{http::proxy"http://proxyuser:proxypass@proxy.
proxyprovider.
com:3128"}3CreateandedittheVMwarerepositorydirectoryandfile.
a(Optional)Ifitdoesnotexist,createthedirectoryandrepositoryfileonthevirtualmachineYoucanselectanynameforthisfile,butitmustusethe.
listfileextension.
Forexample:/etc/apt/sources.
list.
d/vmware-tools.
list.
bAddthefollowingcontentstotherepositoryfileandsavethefile.
debhttps://packages.
vmware.
com/tools/esx/esxi-version/ubuntudistmainesxi-versionistheESXiversion.
Forexample:5.
1or5.
0u1.
Theconfigurationsyntaxisspecifictoeachoperatingsystemversion.
ReplacedistwithpreciseforUbuntu12.
04,oneiricforUbuntu11.
10,nattyforUbuntu11.
04,maverickforUbuntu10.
10,lucidforUbuntu10.
04,karmicforUbuntu9.
10,jauntyforUbuntu9.
04,intrepidforUbuntu8.
10,andhardyforUbuntu8.
04.
NoteForUbuntu12.
04andlaterreleases,OSPswillsupportLongTermSupport(LTS)releasesonly.
cUpdatethelocalrepositorycache.
$sudoapt-getupdateThiscommandliststhepackagesavailablefordownloadingandupdatesthatarelistedontheVMwareWebsite.
AsanalternativetocreatingandeditingtheVMwarerepositorydirectoryandfile,youcandownloadtherepositoryconfigurationpackageforyourdistributionfromthehttps://packages.
vmware.
com/tools/esx/esxi-version/reposdirectory.
Replaceesxi-versionwithyourESXiversion.
Forexample:5.
1or5.
0u1.
VMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMware,Inc.
35Makesuretoselecttheproperarchitectureforyourdistribution.
Forexample,intheESXi5.
0release,foranUbuntu10.
10distributionona64-bitsystem,youmightselectvmware-tools-repo-ubuntu10.
10_8.
6.
0_amd64.
deb.
ForanUbuntu10.
10distributionona32-bitsystem,youmightselectvmware-tools-repo-ubuntu10.
10_8.
6.
0_i386.
deb.
InstallVMwareToolsforUbuntuGuestOperatingSystemsUsetheapt-getpackagemanagementtooltoinstallVMwareToolsfortheUbuntuguestoperatingsystem.
WhenyouspecifytheVMwareToolspackage,apt-getinstallsanyadditionalrequiredpackages.
Foralistofpackagestoinstall,seeVMwareToolsOperatingSystemSpecificInstallationPackages.
StartingwithUbuntu8.
10,open-vm-toolsispackagedwiththemultiverserepository.
VMwaredoesnotsupporttheuseofthesepackagesinVMwarevirtualmachines.
YoumustremoveUbuntuopen-vm-toolspackagesiftheyareinstalledandverifythatyouuninstalledthem.
Fordetails,seeUbuntu8.
10OSPInstallationException.
NoteIfthekernelversiononthevirtualmachinedoesnotmatchtheversionprovidedwiththeVMwareToolsOSPs,youmustinstallcustomizedkernelmodulepackages.
SeeBuildCustomizedKernelModulePackagesforUbuntu.
PrerequisitesnVerifythatyoucompletedthetasksdescribedinChapter2PreparingforVMwareToolsOSPInstallation.
nVerifythatyoucompletedthetasksdescribedinPreparetoInstallOSPsfortheUbuntuGuestOperatingSystem.
nForUbuntu8.
10,youmustconfigureyoursystemtoallowtheapt-getpackagemanagertousethecorrectUbunturepository.
SeeConfigureUbuntu8.
10SystemstoUsetheCorrectRepository.
Procedure1IdentifythekernelmodulefortheUbuntuoperatingsystemfromthecommandline.
$`uname-r`Thiscommandreturnsthekernelandoneofthefollowingkerneltypes:ngenericnservernvirtualngeneric-paeVMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMware,Inc.
362Installthekernelmodulesforthekernelversionandtype.
Forexample:$sudoapt-getinstallvmware-tools-esx-kmods-kernel_releasekernel_releaseisthekernelreleaseandtypereturnedbythe`uname-r`command.
3Installtheremainingcomponents.
$sudoapt-getinstallvmware-tools-esxToinstalltheremainingcomponentswithoutgraphicssupport,usethefollowingcommand:$sudoapt-getinstallvmware-tools-esx-nox4(Optional)InstallcertainVMwareToolsprovidedpackagestoreplacethecorrespondingsystem-provideddrivers.
Forexample:$sudoapt-getinstallvmware-tools-pvscsi-modules-`uname-r`ImportantThesystem-providedpackagesfunctionwithVMwareTools.
Takethissteponlyifyouhaveaspecificreasontodoso.
Alloftherequiredpackagesareinstalledinthecorrectorder.
VerifyVMwareToolsInstallationAfteryouinstallOSPsverifythatVMwareToolsareinstalledandfunctioningproperly.
Procedure1VerifythattheVMwareToolsdaemon,vmtoolsd,isrunning.
$pgrep-flvmtoolsd2Verifythattherequiredkernelmodulesloadproperly.
$/sbin/lsmodThevmmemctlkernelmoduleisalwaysloaded.
Thevmxnet,vmxnet3,andpvscsimodulesareloadedonlywhenthevirtualmachineisconfiguredwiththecorrespondingdevice.
NoteIfthedistributionhasavmxnet3,pvscsi,orvmmemctlkerneldriver,thedriversarenotupdatedwhenyouinstalloperatingsystem-specificpackages.
VMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMware,Inc.
37StatusofVMwareToolsinvSphereClientAfterVMwareToolsOSPsareinstalledonaguest,theVMwarevSphereClientreportsthestatusofVMwareToolsforthatguestasGuestManaged.
ThisstatusindicatesthatOSPsareinstalled.
Inthissituation,donotattempttoinstallthestandardVMwareToolsthroughtheVMwarevSphereClient.
VMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMware,Inc.
38InstallingCustomizedKernelModulePackages4VMwareToolsOSPsworkwithunmodifiedkernelsfromyouroperatingsystemdistributor,butalsoallowyoutousecustomizedkernels.
Whencustomizedkernelsaresimilarenoughtothedistributorkernel,OSPsfunctionbyusingkernelmodulesourcepackages.
Kernelmodulesourcepackagesarepackagesinstandarddistributorformat,sourceRPMfiles,andkernelsourceDebfiles.
PrerequisitesVerifythattherequiredpackages,suchasgcc,kernel-source/headers/devel,rpm-build,andredhad-rpm-configpackages,areinstalled.
SUSEdistributionsdonotrequirepackages.
Procedure1Unpackandrecompiletherpmordebsourcepackageswithyourownkernelintousablebinarypackages.
2(Optional)Ifyoudonotwanttoinstallthesedependenciesontheguest,useastaginghostforcompilation.
3Distributetheresultingbinarypackagestothetargetguest.
Thischapterincludesthefollowingtopics:nBuildingCustomizedKernelModulePackagesforRedHatEnterpriseLinuxandSUSELinuxEnterpriseDistributionsnBuildCustomizedKernelModulePackagesforUbuntuBuildingCustomizedKernelModulePackagesforRedHatEnterpriseLinuxandSUSELinuxEnterpriseDistributionsTherpm-baseddistributionsincludeRHEL3through6,SLES9through11SP2,SLED10through11SP2,andCentOS4through6.
Youcanbuildcustomizedbinarykernelmodulepackagesforthesedistributions.
VMware,Inc.
39BuildtheBinaryKernelModulePackagesforRHEL6,RHEL5,CentOS6,andCentOS5ForVMwareToolstofunctionproperly,youcanusetheVMwareprovidedsourcepackagestocreatebinarypackagesforspecifickernels.
NoteThevmsyncandvmhgfskernelmodulepackagesareoptionalcomponents.
Procedure1DownloadthefollowingESXikmodsourcepackagesfromtherepository.
vmware-tools-module-version.
src.
rpmmoduleisthekernelmodulepackage.
versionistheversionforthetoolsandthepackage.
Findthepackagesathttps://packages.
vmware.
com/tools/releases/tools-version/dist/SRPMSReplaceesxi-versionwiththeESXiversion.
Forexample:5.
1or5.
0u1.
Replacedistwithrhel6orrhel5.
2Installyum-utils.
#yuminstallyum-utilsyum-utilsprovidesyum-builddep.
3Runtheyum-builddepcommandtomeetbuilddependencies.
#yum-builddepvmware-tools-module-version.
src.
rpm4Runthefollowingcommandtocompilethesourcepackagesintobinarypackages.
NoteWhenyouruntherpmbuildcommand,ifyourebuildthevsockorvmhgfspackages,youmustfirstrebuildandinstallthevmcisourcepackage.
#rpmbuild--rebuildvmware-tools-module-version.
src.
rpmThiscommandbuildsabinarykmodpackagesuitableforusewiththerunningkernel.
WhattodonextInstallthebinarykernelmodulepackages.
SeeInstallCustomBuiltBinaryModulePackages.
VMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMware,Inc.
40BuildtheBinaryKernelModulePackagesforRHEL4,RHEL3,andCentOS4ForVMwareToolstofunctionproperly,youcanusetheVMwareprovidedsourcepackagestocreatebinarypackagesforspecifickernels.
Procedure1DownloadthefollowingESXikmodsourcepackagesfromtherepository.
vmware-tools-module-version.
src.
rpmmoduleisthekernelmodulepackage.
versionistheversionforthetoolsandthepackage.
Findthepackagesathttps://packages.
vmware.
com/tools/releases/tools-version/dist/SRPMSReplaceesxi-versionwiththeESXiversion.
Forexample:5.
1or5.
0u1.
Replacedistwithrhel4orrhel3.
2Installthekernelheadersforthekernelforwhichyouarebuildingthekernelmodulepackages.
3Installthegccandrpm-buildpackages.
4Runthefollowingcommandtocompilethesourcepackagesintobinarypackages.
#rpmbuild--rebuildvmware-tools-module-version.
src.
rpmThiscommandbuildsabinarykmodpackagesuitableforusewiththerunningkernel.
WhattodonextInstallthebinarykernelmodulepackages.
SeeInstallCustomBuiltBinaryModulePackages.
BuildtheBinaryKernelModulePackagesforSLES10,SLES11andlaterpackages,SLED10,SLED11andlaterpackagesForVMwareToolstofunctionproperly,youcanusetheVMwareprovidedsourcepackagestocreatebinarypackagesforspecifickernels.
Procedure1DownloadthefollowingESXikmodsourcepackagesfromtherepository.
vmware-tools-module-version.
src.
rpmmoduleisthekernelmodulepackage.
versionistheversionforthetoolsandthepackage.
VMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMware,Inc.
41Findthepackagesat:https://packages.
vmware.
com/tools/releases/tools-version/dist/SRPMSReplaceesxi-versionwiththeESXiversion.
Forexample:5.
1or5.
0u1.
Replacedistwithsles10,sles11.
0,sles11.
1,orsles11.
2.
2Installthekernelheadersforthekernelmodulepackagesyouplantobuild.
3Installthegcc,kernel-source,andkernel-symspackages.
4Runthefollowingcommandtocompilethesourcepackagesintobinarypackages.
NoteWhenyouruntherpmbuildcommand,ifyourebuildthevsockorvmhgfspackages,youmustfirstrebuildandinstallthevmcisourcepackage.
#rpmbuild--rebuildvmware-tools-module-version.
src.
rpmThiscommandbuildsabinarykmodpackagesuitableforusewiththerunningkernel.
WhattodonextInstallthebinarykernelmodulepackages.
SeeInstallCustomBuiltBinaryModulePackages.
BuildtheBinaryKernelModulePackagesforSLES9ForVMwareToolstofunctionproperly,youcanusetheVMwareprovidedsourcepackagestocreatebinarypackagesforspecifickernels.
Procedure1DownloadthefollowingESXikmodsourcepackagesfromtherepository.
vmware-tools-module-version.
src.
rpmmoduleisthekernelmodulepackage.
versionistheversionforthetoolsandthepackage.
Findthepackagesathttps://packages.
vmware.
com/tools/esx/esxi-version/sles9.
0/SRPMSReplaceesxi-versionwiththeESXiversion.
Forexample:5.
1or5.
0u12Installthekernelheadersforthekernelforwhichyouarebuildingthekernelmodulepackages.
3Installthegcc,kernel-source,andkernel-symspackages.
4Runthefollowingcommandtocompilethesourcepackagesintobinarypackages.
#rpmbuild--rebuild/vmware-tools-module-version.
src.
rpmThiscommandbuildsabinarykmodpackagesuitableforusewiththerunningkernel.
VMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMware,Inc.
42WhattodonextInstallthebinarykernelmodulepackages.
SeeInstallCustomBuiltBinaryModulePackages.
InstallCustomBuiltBinaryModulePackagesAftercreatingabinarykernelmodulepackage,youcaninstallthecustombuiltpackages.
PrerequisitesnInstallthevmware-tools-module-commonandvmware-tools-foundationpackagesonthesystem.
moduleisthenameofthekernelmodulepackageyouareinstalling.
nForthevmblockpackage,installthevmware-tools-module-common,vmware-tools-foundation,vmware-tools-core,vmware-tools-libraries-nox,andvmware-tools-guestlibpackagesonthesystem.
ProcedureuRunthefollowingcommandtoinstallyourcustombinarypackage.
nForRHEL6andRHEL5:#rpm-ivh/path/kmod-vmware-tools-module-version.
arch.
rpmForRHEL6,whenyouinstallthevsockorvmhgfspackage,runthefollowingcommand:#rpm-ivh--nodeps/path/kmod-vmware-tools-module-version.
arch.
rpmnForRHEL4,RHEL3,SLES,andSLEDreleases:#rpm-ivh/path/vmware-tools-module-version.
arch.
rpmReplacepathwiththepathforyourdistribution.
OptionDescriptionRHEL6$HOME/rpmbuild/RPMS/archRHEL3through5,andCentOS4and5/usr/src/redhat/RPMS/archSLESandSLED/usr/src/packages/RPMS/archReplacearchwithyourarchitecture.
OptionDescriptionx86_6464-biti38632-bitRedHatkernelsi58632-bitSUSEkernelsVMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMware,Inc.
43BuildCustomizedKernelModulePackagesforUbuntuYoucanbuildacustomizedUbuntubinarykernelandinstallVMwareToolsOSPs.
Formoreinformationaboutthefunctionsofmodule-assistant,seethemodule-assistantmanpage.
PrerequisitesForUbuntu8.
10,youmustconfigureyoursystemtoallowtheapt-getpackagemanagertousethecorrectUbunturepository.
SeeConfigureUbuntu8.
10SystemstoUsetheCorrectRepository.
Procedure1Updateyourrepositoryinformation.
$sudoapt-getupdate2InstalltheVMwareToolsfoundationpackagetopreparethesystemforinstallation.
$sudoapt-getinstallvmware-tools-foundationForthevmblockpackage,alsoinstallthefollowingpackages:$sudoapt-getinstallvmware-tools-corevmware-tools-libraries-noxvmware-tools-guestlib3InstallDeb-Helper.
$sudoapt-getinstalldebhelper4Installthesourcepackageandarequirementthatthecompiledpackagewillneed.
$sudoapt-getinstallvmware-tools-module-modules-sourcevmware-tools-module-commonmoduleisthenameofthemodulepackagethatyouarebuilding.
5Prepareyoursystemforbuildingthemodule.
$sudomodule-assistantprepare6Buildthekernelmodulepackage.
$sudomodule-assistantbuildvmware-tools-module-modules-source7Installthekernelmodulepackage.
$sudomodule-assistantinstallvmware-tools-module-modules-sourceVMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMware,Inc.
44ConfigureUbuntu8.
10SystemstoUsetheCorrectRepositoryUbuntu8.
10hasreacheditsendoflife.
Asaresult,UbuntumovedthepackagerepositorytothelocationwhereUbuntustoresoldreleases.
Toallowtheapt-getpackagemanagertodownloadUbuntu8.
10packages,youmusteditthe/etc/apt/sources.
listfiletopointtothecorrectrepository.
ProcedureuInthe/etc/apt/sources.
listfile,findeveryinstanceofus.
archive.
ubuntu.
comandreplaceitwithold-releases.
ubuntu.
comVMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMware,Inc.
45MaintainingVMwareToolsOSPsAcrossLinuxOSUpgrades5Linuxoperatingsystemupgradesgenerallycanbeclassifiedintothreecategories:maintenanceupgrades,minorupgrades,ormajorupgrades.
Dependingonthesignificanceoftheoperatingsystemupgrade,youmightneedtouninstallthecurrentVMwareToolsOSPsandreinstalladifferentversionoftheOSPs.
However,thedifferentLinuxvendorstreatmaintenance,minor,andmajorupgradesdifferently.
YourapproachtomaintainingVMwareToolsOSPsacrossLinuxoperatingsystemupgradesdependsontheoperatingsystemvendor.
NoteUpgradingVMwareToolsOSPsisnotsupported.
ToupgradeOSPs,youmustuninstallthecurrentOSPversionandreinstalltheupgradedOSPversion.
Typically,amaintenanceupgradeincorporateserrata,securitybugfixes,andsoon.
TheOSkernelisnotsignificantlychanged,andthecurrentVMwareToolsOSPsremaincompatiblewiththekernel.
YoudonothavetoreinstallupgradedOSPsformaintenanceupgrades.
Typically,aminorupgrademightincludenewkernelpackages,butthepackagesmaintainABIcompatibilitywiththeinitialmajorreleasewhichtheminorreleaseisupgrading.
WhenABIcompatibilityismaintained,youdonothavetoreinstalldifferentOSPs.
However,thisisnotthecasewitheveryvendor.
Upgradingbetweenminorversionsofguestoperatingsystemsvariesdependingonthevendor.
Typically,amajorupgradeincludesawhollynewkernelversionandnewpackages.
Tomaintaincompatibilitywithanupgradetoamajoroperatingsystemrelease,youmusttakethesesteps:1UninstallthecurrentVMwareToolsOSPs.
2Upgradetheguestoperatingsystemtothenewrelease.
3InstalltheVMwareToolsOSPsthatarecompatiblewiththeupgradedoperatingsystem.
ForRHEL,CentOS,andOracleLinuxoperatingsystems,ABIcompatibilityismaintainedacrossmaintenanceandminorupgrades,andyoudonothavetouninstallandreinstallOSPs.
Forexample,ifyouupgradefromRHEL6.
0to6.
1,youdonothavetoreinstallOSPs.
ForamajorupgradesuchasfromRHEL5toRHEL6,youmustuninstalltheRHEL5-compatibleOSPs,upgradetheoperatingsystem,andinstalltheRHEL6-compatibleOSPs.
ForUbuntumaintenanceandminorupgrades,youdonothavetoinstallupgradedkernelpackages,butyoumighthavetorebuildcustomOSPsfromsourcetostaycompatiblewiththeupgradedkernel.
VMware,Inc.
46ForSLESandSLEDmaintenanceupgrades,youdonothavetoreinstallOSPs.
However,forminorupgrades,youmighthavetoreinstallOSPs.
Forexample,toupgradefromSLES11SP1toSLES11SP2,youmustuninstalltheSLES11SP1-compatibleOSPs,upgradetheoperatingsystem,andinstalltheSLES11SP2-compatibleOSPs.
VMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMware,Inc.
47UninstallingVMwareToolsOSPs6Forsomeoperatingsystemreleases,youcanuninstallVMwareToolsOSPsbyusingapackagemanager.
ForotherOSreleases,youmustmanuallyuninstallVMwareToolsOSPs.
Thischapterincludesthefollowingtopics:nUninstallVMwareToolsOSPsWithaPackageManagernManuallyUninstallVMwareToolsUninstallVMwareToolsOSPsWithaPackageManagerTouninstalltheVMwareToolsOSPs,youcanuseyourpackagemanagertoremovethepackages.
DuringVMwareToolsOSPinstallation,theVMWareprovideddisplayandmousedriverpackagesareinstalledovertheoperatingsystem-provideddriverpackagesiftheVMwarepackagesarenewer.
WhenyouuninstalltheOSPs,theVMwareprovideddisplayandmousedriverpackagesareremoved,leavingtheoperatingsystemwithoutVMwareprovideddisplayandmousedrivers.
Inthissituation,youmustreinstallthenativeoperatingsystemprovideddriversorleavetheVMwareprovideddriversonthesystem.
NoteTheyumpackagemanagerdoesnotuninstallproperlybecauserpmdoesnotuninstallthepackagesinthecorrectsequence.
YoumustmanuallyuninstallOSPsontheRHEL,andCentOSdistributionsthatuseyumandtheolderdistributionsthatdonotuseyum.
SeeManuallyUninstallVMwareTools.
ProcedureuUninstallVMwareToolsOSPsbyrunningthepackagemanagerremovecommandfromthecommandlineoftheguestoperatingsystem.
OptionActionSLES11andlaterservicepackages,SLED11andlaterservicepackagesEnter#zypperremove'vmware-tools-*'SLES10Enter#rugremove'vmware-tools-*'UbuntuEnter$sudoapt-getremove--purge'vmware-tools-*'VMware,Inc.
48TheprecedingcommandremovestheVMwareprovideddisplayandmousedriverpackages.
Ifyouwanttokeepthesepackages,youmustremoveallVMwareToolsOSPsexceptvmware-tools-xorg-drv-display,vmware-tools-xorg-drv-mouse,andvmware-tools-foundation.
OnUbuntusystems,ifyouuninstalltheVMwareprovideddisplayandmousedriverpackages,youmustreinstallthedistributionprovideddriverpackagestoreturnthesystemtoitsoriginalstate.
Forexample,runthefollowingcommands:$sudoapt-getinstallxserver-xorg-video-all$sudoapt-getinstallxserver-xorg-input-allImportantIfyouuninstalltheVMwareprovideddisplayandmousedriversonanUbuntusystem,donotlogoutorrestartthesystembeforeyoureinstallthedistributionprovideddisplayandmousedrivers.
Thesystemcannotrestartproperlywithoutthesedrivers.
ManuallyUninstallVMwareToolsYoumustmanuallyuninstallVMwareToolspackagesoncertainoperatingsystemreleases.
RHEL5,RHEL6,CentOS6,andCentOS5usetheyumpackagemanager.
However,theyumpackagemanagerdoesnotuninstallproperlybecauserpmdoesnotuninstallthepackagesinthecorrectsequence.
RHEL3,RHEL4,CentOS4,andSLES9userpmdistributions.
Ondistributionsthatuseyumorrpm,youmustremovetheOSPpackagesinaspecificorderbecauseofpackagedependencies.
Procedure1RemovetheOSPmeta-packages.
#rpm-evmware-tools-esx#rpm-evmware-tools-esx-nox#forfilein`rpm-qa|grepvmware-tools-esx-kmods`;dorpm-e$filedone2RemovetheThinprintandHost-GuestFilesystempackages.
#rpm-evmware-tools-thinprint#rpm-evmware-tools-hgfs3RemovetheVMwareToolsplug-inpackages.
#forfilein`rpm-qa|grepvmware-tools-plugins`;dorpm-e$filedone#rpm-evmware-tools-user#rpm-evmware-tools-servicesVMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMware,Inc.
494Removethekernelmodulepackages.
aRemovethekernelmodules.
OnRHEL5andRHEL6distributions:#forfilein`rpm-qa|grepvmware-tools|grepkmod|grep-vvmci`;dorpm-e$filedone#forfilein`rpm-qa|grepvmware-tools|grepkmod|grepvmci`;dorpm-e$filedoneOnRHEL3,RHEL4,andSLES9distributions:#forfilein`rpm-qa|grepvmware-tools|grepkmp|grep-vvmci`;dorpm-e$filedone#forfilein`rpm-qa|grepvmware-tools|grepkmp|grepvmci`;dorpm-e$filedonebRemovethekernelmodulecommonpackages.
#forfilein`rpm-qa|grepvmware-tools|grepcommon`;dorpm-e$filedone5Removethebasepackages.
#rpm-evmware-tools-help#rpm-evmware-tools-guestsdk#rpm-evmware-tools-core#rpm-evmware-tools-libraries-x#rpm-evmware-tools-libraries-nox#rpm-evmware-tools-guestlib6(Optional)RemovetheVMwareprovideddisplayandmousedrivers.
#rpm-e--nodepsvmware-tools-xorg-drv-mouse#rpm-e--nodepsvmware-tools-xorg-drv-display#rpm-evmware-tools-foundationSkipthisstepifyoudonotwanttoremovetheVMwareprovideddisplayandmousedriverpackages.
Ifyouskipthisstep,thevmware-tools-xorg-drv-display,vmware-tools-xorg-drv-mouse,andvmware-tools-foundationpackagesremainonthesystem.
VMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMware,Inc.
50OnRHEL5andRHEL6systems,ifyouuninstalltheVMwareprovideddisplayandmousedriverpackages,youmustreinstallthedistributionprovideddriverpackagestoreturnthesystemtoitsoriginalstate.
Forexample,runthefollowingcommand:yuminstallxorg-x11-drv-vmwarexorg-x11-drv-vmmouseImportantIfyouuninstalltheVMwareprovideddisplayandmousedriversonaRHEL5orRHEL6system,donotlogoutorrestartthesystembeforeyoureinstallthedistributionprovideddisplayandmousedrivers.
Thesystemcannotrestartproperlywithoutthesedrivers.
Ifapackageisnotinstalled,thecommandskipstheactionandreturnstheprompt.
VMwareToolsInstallationGuideForOperatingSystemSpecificPackagesVMware,Inc.
51