Professional Documents
Culture Documents
Guide
ESX Server 3.5
You can find the most up-to-date technical documentation on our 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
2007 VMware, Inc. All rights reserved. Protected by one or more of U.S. Patent Nos. 6,397,242,
6,496,847, 6,704,925, 6,711,672, 6,725,289, 6,735,601, 6,785,886, 6,789,156, 6,795,966, 6,880,022,
6,944,699, 6,961,806, 6,961,941, 7,069,413, 7,082,598, 7,089,377, 7,111,086, 7,111,145, 7,117,481,
7,149,843, 7,155,558, 7,222,221, 7,260,815, 7,260,820, 7,269,683, 7,275,136, 7,277,998, 7,277,999,
7,278,030, 7,281,102, and 7,290,253; patents pending.
VMware, the VMware boxes logo and design, Virtual SMP and VMotion are registered trademarks or
trademarks 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.
3401 Hillview Ave.
Palo Alto, CA 94304
www.vmware.com
2
VMware, Inc.
Contents
AboutThisBook
ManagingPatchesforESX Server3.5Hosts 7
IntroductiontoPatchProcessing 7
AboutPatches 8
AboutPatchRepositoriesandPatchDepots 10
Aboutextractingbundle.zipfiles 10
Aboutextractingrollup.zipfiles 11
AbouttheesxupdateUtility 12
AboutBundleDependencies 13
AboutScanningforApplicableBundles 14
SampleOutput:scanCommand 15
SampleOutput:--explain scanCommand 16
AboutInstallingBundlesandRollups 16
PatchMaintenanceStrategy 18
AboutCustomizingYourPatchProcess 18
ManagingPatches 19
SettingupPatchDepots 19
MaintainingPatchDepots 21
DownloadingandExtractingPatchFiles 22
ScanningforApplicableBundles 22
UsingaWildcard(*)toScanMultipleBundles 23
RetrievingBundleInformation 24
SampleOutput:queryCommand 25
SampleOutput:infoCommand 26
VerifyingDiskSpace 27
RunningaTestInstall 27
InstallingBundlesonanESX Server3.5Host 29
UsingaWildcard(*)toInstallMultipleBundles 30
VerifyingBundleInstallations 31
OmittingRPMsfromtheInstallation 31
ReinstallingBundles 32
VMware, Inc.
ReferenceInformation 33
esxupdateOptionsandCommands 33
esxupdateOptions 33
esxupdateCommands 36
esxupdateExitCodesandErrorMessages 37
VMwareReleaseTerminology 41
AboutMajorReleases 41
AboutMinorReleases 42
AboutMaintenanceReleases 42
AboutUpdateReleases 42
ESX ServerPatchManagementTools 42
AboutVMwareUpdateManager 43
AboutVMwareInfrastructureUpdate 43
AboutvihostupdateRemoteCLI 43
FrequentlyAskedQuestions 43
InstallationChecklist 44
Index 45
VMware, Inc.
Thisbook,ESXServer3PatchManagementGuide,providesbackgroundinformationon
processingpatchesforESXServer3.5hostsanddescribeshowtousetheesxupdate
utilitytoapplysoftwareupdatesandtotracksoftwareinstalledonESXServer3.5hosts.
ThisbookprovidesinformationspecifictoESXServer3.5hostsandtheesxupdate
utility.Itdoesnotdiscussthefollowing:
HowtopatchESXServer3.5hostsautomaticallywiththeVMwareUpdateService
andtheVMwareUpdateManager.Forinformationonthesetools,seeESX Server
PatchManagementToolsonpage 42.
HowtopatchESXServer3ihostswiththevihostupdateremotecommandline
interface(remoteCLI).Forinformationonvihostupdate,seeESX ServerPatch
ManagementToolsonpage 42.
HowtopatchESXServersreleasedpriortoversion3.5.Forinformationonthis
process,seethePatchManagementforESXServerstechnote.
HowtoupgradeESXServerhosts.Forinformationonupgrading,seetheUpgrade
Guide.ForalistofVMwarereleasedefinitions,seeVMwareRelease
Terminologyonpage 41.
NOTEYoumusthaveavalidVMwareproductlicensetodownloadVMwarepatches.
Intended Audience
ThismanualisintendedforanyonewhoneedstomanuallyapplypatchestoESX
Server3.5hosts.Theinformationinthismanualiswrittenforsystemadministrators
whomanageESXServersbyusingaserviceconsole.
VMware, Inc.
Document Feedback
VMwarewelcomesyoursuggestionsforimprovingourdocumentation.Ifyouhave
comments,sendyourfeedbackto:
docfeedback@vmware.com
Support Offerings
FindouthowVMwaresupportofferingscanhelpmeetyourbusinessneeds.Goto
http://www.vmware.com/support/services.
VMware, Inc.
VMware, Inc.
Eachrollupcontainsallbundlesreleasedfromthelatestmaintenanceorupdate
release.Forexample,VMwaremayreleasethefollowing,inorder:
Maintenancerelease.
5individualbundles,releasedovertime.
1rollup,whichpackagesthe5bundlesreleasedsincethemaintenancerelease.
5individualbundles,releasedovertime.
1rollup,whichpackagesthe10bundlesreleasedsincethemaintenancerelease.
Updaterelease.
5individualbundles,releasedovertime.
1rollup,whichpackagesthe5bundlesreleasedsincetheupdaterelease.
Forinformationonreleaseterminology,seeVMwareReleaseTerminologyon
page 41.Forinformationonhowtoinstallrollupsandindividualbundles,see
InstallingBundlesonanESX Server3.5Hostonpage 29.
About Patches
Softwarepatchesprovideimmediatefixesforoneormoresecurityfixesorcriticalfixes
foraspecificareaoftheproduct.Forinformationaboutaspecificpatch,gotothe
VMwareInfrastructureDownloadCenterathttp://www.vmware.com/download/vi.
ESX Server3.5patchesusethefollowingnamingconvention:
<ProductName><VersionNumber>-<BundleID>-<Classification><SupportLevel>
Where:
VersionNumberistheESX Serverversion,forexample,3.5.0.
BundleIDisauniqueIDcomprisedoftheyearandmonththebundlewasreleased
anda3digituniqueID.ItisintheformatYYYYMM###.Forexample,thefirst
patchreleasedinJanuary2008mighthaveaBundleIDof200801001.
Classification isoneof:
BBug
Bugpatchesfixminorflawsthataffectproductfunctionalityorbehavior.Bug
patchesareoptional.Beforeyouapplythem,determinewhethertheyare
necessaryforyourenvironment.
VMware, Inc.
UUpdate
Updatepatchescancontainnewdriverupdatesandsmallnonintrusive
enhancements.Updatepatchesareoptional.Beforeyouapplythem,
determinewhethertheyarenecessaryforyourinstallation.
SSecurity
Securitypatchesfixoneormorepotentialsecurityvulnerabilitiesinthe
product.Theyshouldbeimplementedimmediatelytopreventthe
vulnerabilitiesfrombeingexploited.
RRollup
RolluppatchescontainanynumberofbundlesforESX Server3.5hosts.They
cancontainbugpatches,updatepatches,andsecuritypatches.Theydonot
containupgradebundlesforminorreleasesorupdatebundlesfor
maintenancereleases.
SupportLevelisoneof:
GGAPatch
GApatchesarereleasedtoallcustomersandhavebeenthoroughlytested.
TheycontainfixesforESX Server3softwareissues.
HHotPatch
Hotpatchesarereleasedtospecificcustomersforsolvingcriticalproblems
specifictotheirenvironment.Theycontainfixesforsecurityissuesor
problemsthatcanpotentiallycausedatalossorsevereservicedisruptions.
Hotpatchesshouldbeimplementedimmediately.
DDebuggingPatch
DebuggingpatchesarereleasedtoallcustomersandareusedbyVMwareto
troubleshootcomplexproductissues.Theycancontaindebugmessagesand
code,anddrivers.DebuggingpatchesusuallyrequireVMwareassistanceto
install.
CCustomPatch
Custompatchesarespecialfixesprovidedtoacustomer.Theyareusually
specifictocustomersenvironment,andaremostlikelynotrequiredby
customersnotreportingtheissue.Custompatcheshavebeentestedinthe
customersenvironment.
VMware, Inc.
10
Acontents.xmlfileforthebundle,whichcontainsareferencetothebundles
descriptor.xmlfileandalistofeveryRPMpackageanditsassociatedsignature.
Acontents.xml.sigfile,whichisadetachedGPGsignatureofthecontentsfile.
Thisisusedtovalidatethecontentsfileforintegrity.
Adescriptor.xmlfile,whichcontainsinformationaboutabundle,includinga
summaryofthefix,dependencydetails,andRPMdetails.esxupdateusesthe
descriptorfiletodeterminehowtohandlebundleorsystemdependenciesandto
determinewhichbundlesandRPMsareapplicabletothehostsystem.
VMware, Inc.
TheRPMsoftwarepackages.
Adirectoryfortheheaderfiles.
Afolderfortherollupbundle,namedwiththerollupID,containinga
contents.xml,contents.xml.sig,anddescriptor.xmlfilefortherollup.
Afolderforeachindividualbundleintherollup,namedwiththebundleID.Each
bundlefoldercontainsadescriptorfile,acontentsfile,acontentssignaturefile,
andtheRPMsoftwarepackages.
Forexample,sayyouhaveadepotnamedESX350.Youdownloadandextractthe
contents.zipfileandarollupESX350-Rollup-01.zip.Iftherollupcontains2
bundles,ESX350-200801001-BG,andESX350-200801002-BG,thedepotwill
containthreefoldersonefortherollupandoneforeachbundle:
/VMware_Patches <----Patch repository
/ESX350 <----Depot
contents.xml
contents.xml.sig
/ESX350-200801003-RG <----Roll-up folder
contents.xml
contents.xml.sig
descriptor.xml
/ESX350-200801001-BG <----Bundle folder
contents.xml
contents.xml.sig
descriptor.xml
headers/
VMware-esx-vmkernel-3.5.0-65312.i386.rpm
/ESX350-200801002-BG <----Bundle folder
contents.xml
contents.xml.sig
descriptor.xml
headers/
VMware-esx-apps-3.5.0-65312.i386.rpm
Formoreinformationonbundledependencies,seeAboutBundleDependencieson
page 13.Forinformationoncreatingpatchdepots,seeSettingupPatchDepotson
page 19.
VMware, Inc.
11
Inspectionmodequeriesyoursystemforbundlesandbundledetails.Therearetwo
commandsyouusetoretrievebundleinformation:esxupdatequeryand
esxupdateinfo.
Usetheesxupdatequerycommandtodisplayalistofbundlesinstalledon
ESX Server3.5host.Theoutputliststhebundlesinascendinginstallation
order,andincludesthebundlename,installationdate,anda40character
summaryofthebundle.Bundlesthathavebeensupersededbyanother
bundle,andthereforeobsolete,arenotlisted.
Usetheesxupdateinfocommandtodisplayinformationthecontentsofone
ormorebundles.Theoutputincludesthebundlename,releasedate,and
detailsaboutthemetadatafiles,includingtheRPMpackagesthathavebeen
installed,removed,orupgradedonanESX Server3.5host.Theinfocommand
alsoreturnsinformationaboutRPMpackagesnothandledbyesxupdate,such
asthosethathaveversionsnotdefinedbyVMware.Thisallowsyoutotrack
RPMpackagesthatwereinstalledbythirdpartyagents.
Youcanusetheinfocommandforbothinstalledanduninstalledbundles.
Formoreinformation,seeRetrievingBundleInformationonpage 24.
12
VMware, Inc.
ScanmodedetermineswhichbundlesareapplicabletotheESX Server3.5hostby
queryingthebundlesinadepotandthebundlesinstalledonthehostforbundle
andsystemdependencies.Usetheesxupdatescancommandbeforeyouinstall
bundlestoseewhichoneshavedependenciesandwhichonesareapplicabletothe
host.Formoreinformation,seeAboutScanningforApplicableBundleson
page 14.
Testmodeenablesesxupdatetogothroughallinstallationoperationswithout
installingthespecifiedbundles.Itdownloadstheappropriatefiles,preloadsthe
esxupdatedepotcacheforHTTPandFTPservers,checksforbundleandsystem
dependencies,anddeterminesthebundleorderandRPMstobeinstalled.Itdoes
notcheckforRPMconflictsordependencies.Formoreinformation,seeRunning
aTestInstallonpage 27.
UpdatemodeinstallsbundlesonESX Server3.5hosts.Usetheesxupdateupdate
commandtoinstallindividualbundlesandrollups.Updatemodescansthedepot
fordependenciesandhandlesthem,ifpossible,beforeinstalling.Formore
information,seeInstallingBundlesonanESX Server3.5Hostonpage 29.
Forinformationonesxupdatesyntaxandcommands,seeesxupdateOptionsand
Commandsonpage 33
VMware, Inc.
13
Ifesxupdatecantresolvealldependencies,itexitswithoutperformingtheinstallation.
Insuchcases,youmustmanuallyresolvethedependenciesbeforerunningtheupdate
again.Forexample,ifabundlerequiresthatvirtualmachinesmustbeinmaintenance
modeandtheyarepoweredon,youmustpowerthemoffbeforeupdatingthehost.For
alistofdependencyflags,seeAboutScanningforApplicableBundlesonpage 14.
Formoreinformationondependencychecking,seeAboutScanningforApplicable
Bundlesonpage 14.
ThebundleID.
Whetherthebundleismissingfromthedepotorisnotapplicable.Insuchcases,
thebundleisdisplayedwithoneofthefollowingapplicabilityflags:
Table 1. ScanCommandApplicabilityFlags
14
AppFlgs
Description
Thebundleisalreadyinstalled.
Arequiredbundlewasreturnedbythescanselectionandwillbe
installed.
Arequiredbundleisnotinthedepotandmustbeinstalled.Download
thebundlesoitcanbeinstalled.
Thereisaconflictbetweenbundles.Ifthespecifiedbundleconflicts
withaninstalledbundle,itcannotbeinstalledwithoutremovingthe
installedbundle.Ifthespecifiedbundleconflictswithanotherbundle,
removingtheotherbundlefromthebundleselectionwillallowthis
bundletobeinstalled.
VMware, Inc.
Description
Thebundlehasbeenobsoletedbyanotherbundleintheselectionand
doesnotneedtobeinstalled.Notethatesxupdatehandlesobsolete
bundles;youdonotneedtoremovethemmanually.
Oneormorefilesorsignaturescouldnotbevalidated.Thisindicates
anunauthenticatedbundle.
ThisbundlerequirestheESX Server3.5hosttobeinmaintenance
mode,andatleaseonevirtualmachineispoweredon.
Toretrievethereasonwhyabundleisnotapplicable,runthescancommandwith
the--explainoption.
Abriefsummaryofthebundle.
Oneofthefollowinghostinstallationflags(iFlag):
Table 2. ScanCommandInstallationFlags
iFlag
Description
Rebootrequired.
Maintenancemoderequired.
Hostagentrestartrequired.
Ifesxupdatecanhandlealldependenciesanddoesnotfindanyconflicts,itcaninstall
thepatchesincludedinthescan.Ifconflictsexist,theyarelistedintheAppFlags
columnofthescanoutput.Foranexample,seeSampleOutput:scanCommandon
page 15.
AppFlags
iFlags
ESX350-200801030-BG
---c----
-mh
ESX350-200804044-SG
---c----
-mh
ESX350-200801115-RG
----o---
--h
ESX350-200811190-RG
--------
--h
VMware, Inc.
15
Ifthescanreturnsconflictsordependencyproblems(AppFlags)andyouwantmore
information,runthescancommandwiththe--explainoption.Foranexample,see
SampleOutput:--explain scanCommandonpage 16.
AppFlags
iFlags
ESX350-200801030-BG
---c----
-mh
---c----
-mh
----o---
--h
--------
--h
Forinformationonscanningadepotfordependencies,seeScanningforApplicable
Bundlesonpage 22.
16
IfyoudonotspecifybundleIDstoinstall,esxupdateinstallsallapplicablebundles
inthedepot.
IfyouspecifyoneormorebundleIDstoinstall,thefollowingcanhappen:
Ifnodependenciesexist,esxupdateinstallsonlythosebundles.
Ifdependenciesexistandaspecifiedbundlerequiresoneormoreunspecified
bundlestoalsobeinstalled,esxupdateinstallstheunspecifiedbundlesalong
withthespecifiedbundles.
VMware, Inc.
IfyouspecifyarollupIDtoinstall,esxupdateinstallsallbundlespackagedinthat
rollupandignoresallotherbundlesandrollupsinthedepot.
Toensureyouhaveadequatediskspacefortheinstallation,thehostsystemshould
havethefollowingspaceavailable:
Aminimumof24MBforthe/tmpand/boot directories.
Aminimumof50MBforthe/rootdirectory.
Ingeneral,twicethesizeofthedownloadedbundles.
Beforeyouinstallbundlesorrollups,scanthedepottomakesurethereareno
bundletobundledependenciesthatcannotbehandled.Forexample,ifyouare
installingasinglebundle,anditisdependentonanotherbundlebeinginstalled,make
surebothbundlesareinthedepot.Iftheyarenot,esxupdatecannotproceedwiththe
installation.
Duringtheinstallationprocess,esxupdatevalidateseachbundlebyusingasetof
signaturekeys.Thebundle.zipfiles,contents.zipfiles,andallfilesinabundle
containVMwaresignaturekeys.Ifapatchcontainsamissingorinvalidsignature,
esxupdatedoesnotconsiderthebundleforinstallation.
Aftervalidatingthebundles,esxupdateperformsthefollowingtasksduringtheinstall:
Checksforsoftwaredependenciesandprerequisites,forexampleifthebundleis
thecorrectESX Serverversion,ifvirtualmachinesarepoweredoff,andsoforth.
CheckstheintegrityofthemetadatafilesandRPMsineachbundle.
Orderstheapplicablebundlesaccordingtotheirdependenciesandreleasedate.
Checksforadequatediskspace.
RemovesobsoleteRPMsfromtheESX Server3.5host.
InstallstheRPMs.RPMsinstalledalreadyorsupersededbyanewerinstalled
versionarenotinstalled.
Ifnecessary,performssystemstaterequirementssuchasasystemrebootorhostd
restart.
Duringtheinstallation,ifanesxupdatepatchisavailable,theutilitywillupdateitself.
Iftheinitrdanddriverconfigurationsrequirechanges,thechangesaremadeafterall
bundlesareinstalled.
Forinformationoninstallingbundles,seeInstallingBundlesonanESX Server3.5
Hostonpage 29.Forinformationoncheckingforpatchdependencies,seeAbout
ScanningforApplicableBundlesonpage 14.
VMware, Inc.
17
Keepyourenvironmentascurrentaspossible.Determinewhetherabundleis
necessaryforyourenvironmentandapplythosebundles.Minimizethechangeto
yoursoftwareenvironmentwheneverpossible.Formoreinformationon
determiningbundleapplicability,seeAboutScanningforApplicableBundleson
page 14.
Analyzetheriskfactorofapplyingthebundle.Forexample,assessthevirtual
machineandESX Server3.5hostdowntimerequirements.Thescancommand
providesagoodwaytoanalyzerisksandserverdowntime.
Downloadandinstallrollupsratherthanindividualbundles.Thissavesyou
downloadtimeandensures,whendependenciesexist,thatyourdepotcontainsall
necessarybundles.Inaddition,alwaysdownloadthecurrentcontents.zipfile
whenyoudownloadbundlesorrollups.
Foramultihostenvironment,setuppatchdepotsonacentralizedserver
accessiblebyallESX Serverhosts.CreateaseparatedepotforeachESX Server
versioninyourenvironment.YoucanputdepotsonanESX Serverhost;however,
VMwaredoesnotrecommendit.Formoreinformation,seeAboutPatch
RepositoriesandPatchDepotsonpage 10.
18
VMware, Inc.
Managing Patches
Theproceduresinthissectiondescribehowtosetupyourpatchenvironmentand
installbundlesonyourESX Server3.5hosts.
SettingupPatchDepotsonpage 19.
DownloadingandExtractingPatchFilesonpage 22.
ScanningforApplicableBundlesonpage 22.
RetrievingBundleInformationonpage 24.
VerifyingDiskSpaceonpage 27.
RunningaTestInstallonpage 27.
VerifyingBundleInstallationsonpage 31.
OmittingRPMsfromtheInstallationonpage 31.
ReinstallingBundlesonpage 32.
Setupthepatchrepository.
a
SettheApacheDocumentRoot directivetothedirectoryfromwhichhttpd
willservefiles.Forexample:
DocumentRoot "/var/www/html"
Defineadepotdirectory.Forexample:
<Directory /var/www/html/esx35>
Options +Indexes
</Directory>
VMware, Inc.
19
RestarttheApacheservice.
NOTEIfyoudonotchangedirectoriestothedepotdirectorywhenyourunesxupdate,
youmustspecifytheHTTPdirectoryinthecommand.Forexample:
esxupdate -d http://<HTTP_Server_Hostname>/<Depot_Directory>
Setupthepatchrepository.
a
CreatethedirectoryfromwhichtheFTPserverwillprovidethefiles.For
example:
/var/updates
Createadepotdirectory.Forexample:
/var/updates/esx35
NOTEIfyoudonotchangedirectoriestothedepotdirectorywhenyourunesxupdate,
youmustspecifytheFTPdirectoryinthecommand.Forexample:
esxupdate -d ftp://<FTP_Server_Hostname>/<Depot_Directory>
Setupthepatchrepository.
a
CreateadirectoryfromwhichtheNFSserverwillprovidethefiles.For
example:
/var/updates
Openthe/etc/exportsfileandaddthedirectorypathasreadonly(ro).For
example:
/var/updates *(ro)
Createadepotdirectory.Forexample:
/var/updates/esx35
d
2
RestarttheNFSservice.
UsethemountcommandtomaketheNFSshareavailabletoeachESX Server3.5
host.
NOTEIfyoudonotchangedirectoriestothedepotdirectorywhenyourunesxupdate,
youmustspecifythedepotNFSSharedirectoryinthecommand.Forexample:
esxupdate -d file:///<NFS_Share_Hostname>/<Depot_Directory>
20
VMware, Inc.
LogintotheserviceconsoleontheESX Server3.5hostasuserroot.
NOTEIfyoudonothavedirectaccesstotheESX Server3.5host,connectremotely
totheserviceconsoleusingssh.
Enterthefollowingcommandtocheckthespoolusage:
du -sh /var/spool/esxupdate
Enterthefollowingcommandtocheckthediskspace:
df -l
Checkthecachesizeand,ifnecessary,clearthecachebyrunningtheesxupdate
scan commandwiththeflushcacheoption:
esxupdate -d <DepotURL> --flushcache scan
Formoreinformationonthe -flushcachecommand,see--flushcacheon
page 34.
VMware, Inc.
21
Ifnecessary,setupapatchdepot.SeeSettingupPatchDepotsonpage 19.
GototheVMwareInfrastructure3.5DownloadCenter
(http://vmware.com/download/vi)anddownloadthepatch.zipfilesandthe
latestcontents.zip file.
Useafileextractionutilitytoextractthe.zipfilestothedepot.
Forinformationonthedepotdirectorystructure,seeAboutPatchRepositoriesand
PatchDepotsonpage 10.
LogintotheserviceconsoleontheESX Server3.5hostasuserroot.
NOTEIfyoudonothavedirectaccesstotheESX Server3.5host,connectremotely
totheserviceconsoleusingssh.
IfthedepotisnotontheESX Server3.5host,typethefollowingcommandto
enableanoutgoingconnectionfortheserviceconsole:
esxcfg-firewall --AllowOutgoing
Runtheesxupdatescancommand.
NOTEYoudonotneedtospecifythe-d<depotURL>optioninthecommandif
youarerunningesxupdatefromthedepotdirectory.
22
VMware, Inc.
Toscanallbundlesinadepot:
esxupdate -d <depotURL> scan
Toscanspecificbundlesinadepot:
esxupdate -d <depotURL> -b <bundleID1> -b <bundleID2> scan
Ifyouaredoneaccessingthedepot,resettheserviceconsolefirewalltohigh
security:
esxcfg-firewall --blockOutgoing
Forinformationonscanning,seeAboutScanningforApplicableBundlesonpage 14.
Forinformationonesxupdatesyntaxandcommands,seeesxupdate scanon
page 37.
To retrieve information about the scan results
Ifthescanoutputcontainsoneormorebundleswithconflictsorbundledependency
issues,runthescancommandwiththe--explainoptiontoretrievedetailsaboutthe
issue.
NOTEYoudonotneedtospecifythe-d<depotURL>optioninthefollowing
commandsifyouarerunningesxupdatefromthedepotdirectory.
Toretrievedetailsaboutallbundlesinadepot:
esxupdate -d <DepotURL> --explain scan
Toretrievedetailsaboutspecificbundlesinadepot:
esxupdate -d <DepotURL> -b <BundleID> -b <BundleID> --explain scan
Forasampleoutputofthe--explainoption,seeSampleOutput:--explain scan
Commandonpage 16.
ForinformationontheVMwarebundlenamingconvention,seeAboutPatcheson
page 8.Forinformationonesxupdatesyntaxandcommands,seeesxupdate scan
onpage 37.
VMware, Inc.
23
Fromtheserviceconsole,logontotheESX Server3.5hostasuserroot.
NOTEIfyoudonothavedirectaccesstotheESX Server3.5host,connectremotely
totheserviceconsoleusingssh.
Runtheesxupdatequeryorinfocommand.
Toretrieveabriefsummaryofallinstalledbundles:
esxupdate query
Thiscommandlistsallinstalledbundlesinascendinginstallationorderand
includestheinstallationdateandabriefsummaryforeachbundle.Obsolete
bundlesarenotlisted.
Toretrievedetailedinformationaboutinstalledbundles,includingRPMs:
esxupdate -l query
NOTEYoudonotneedtospecifythe-d<depotURL>optioninthefollowing
commandsifyouarerunningesxupdatefromthedepotdirectory.
Toretrieveasummaryaboutbundlesreturnedbythequery:
esxupdate info <bundleID1> <bundleID2>
Toretrievedetailedinformationaboutbundlesreturnedbythequery,
includingRPMdetails:
esxupdate -l info <bundleID1> <bundleID2>
Forinformationonesxupdatesyntaxandcommands,seeesxupdate queryon
page 36andesxupdate infoonpage 36.
24
VMware, Inc.
--Install Date--
--------Summary--------
3.5.0-56329
23:37:26 11/04/08
ESX350-200802055-BG
23:49:26 11/04/08
ESX350-200803066-SG
23:50:02 11/04/08
Fromtheserviceconsole,logontotheESX Server3.5hostasuserroot.
NOTEIfyoudonothavedirectaccesstotheESX Server3.5host,connectremotely
totheserviceconsoleusingssh.
IfthedepotisnotontheESX Server3.5host,typethefollowingcommandto
enableanoutgoingconnectionfortheserviceconsole:
esxcfg-firewall --AllowOutgoing
Runtheesxupdateinfocommand.
NOTEYoudonotneedtospecifythe-d<depotURL>optioninthecommandif
youarerunningesxupdatefromthedepotdirectory.
Toretrieveasummaryofallbundlesinadepot:
esxupdate -d <DepotURL> info
Toretrieveasummaryofspecificbundlesinadepot:
esxupdate -d <DepotURL> -b <bundleID1> -b <bundleID2> info
ToretrievedetailedinformationonallbundlesandRPMpackagesinadepot:
esxupdate -d <DepotURL> -l info
VMware, Inc.
25
Toretrievedetailedinformationonspecificbundlesinadepot,includingall
RPMpackages:
esxupdate -d <DepotURL> -l -b <bundleID1> -b <bundleID2> info
or
esxupdate -d <DepotURL> -l -b *<partial_bundleID> info
ToretrievedetailedinformationonthebundlesorRPMpackagesinaspecific
rollup:
esxupdate -d <DepotURL> -l -b <RollupID> info
Ifyouaredoneaccessingthedepot,resettheserviceconsolefirewalltohigh
security:
esxcfg-firewall --blockOutgoing
Forinformationonesxupdatesyntaxandcommands,seeesxupdate infoon
page 36.
26
VMware, Inc.
The/partitiondirectoryhasatleast50MBoffreespace.
Thediskspaceallocatedtotheserviceconsolehasanamountoffreespacethatis
twicethesizeofthebundletobeinstalled(thatis,thesizeofthe.zipfile).
Tip Beforeinstallingpatches,runatestinstall.The--testoptionautomatically
checksthediskspaceforyou.SeeRunningaTestInstallonpage 27.
Downloadstheappropriatebundlefilestothehost.
Ifnecessary,preloadstheesxupdatedepotcache.
Checksforbundleandsystemdependencies.
Determinesthebundleorder.
DetermineswhichRPMsmustbeinstalledwithoutinstalling.
NOTERPMleveldependenciesandconflictsarenotcheckedduringatestinstall.
ThiscommandalsoloadstheesxupdatecacheforHTTPandFTPdepots.Asaresult,
whenyouruntheupdatecommand,itwilltakelesstimetodownloadthebundlesto
theESX Server3.5host.
Afteresxupdatecompletesthetest,itprintsoutareportshowingifeachbundlewillbe
installed,andifnot,thereason.Youcanusethislisttofixanydependenciesthatarent
handledautomaticallybyesxupdate.
ThereportalsodisplaysalistofRPMsthatareobsoletedbyotherbundles,andwhich
bundlescausedthemtobeobsoleted.
VMware, Inc.
27
Fromtheserviceconsole,logontotheESX Server3.5hostasuserroot.
NOTEIfyoudonothavedirectaccesstotheESX Server3.5host,connectremotely
totheserviceconsoleusingssh.
IfthedepotisnotontheESX Server3.5host,typethefollowingcommandto
enableanoutgoingconnectionfortheserviceconsole:
esxcfg-firewall --AllowOutgoing
Runtheesxupdateupdateoperationwiththe--testoption.
NOTEYoudonotneedtospecifythe-d<depotURL>optioninthecommandif
youarerunningesxupdatefromthedepotdirectory.
Torunatestinstallationofallbundlesinadepot:
esxupdate -d <DepotURL> --test update
Torunatestinstallationofallbundlesinarollup:
esxupdate -d <DepotURL> -b <RollupID> --test update
Torunatestinstallationofmultiplebundlesinadepot:
esxupdate -d <DepotURL> -b <bundleID> -b <bundleID> --test update
or
esxupdate -d <DepotURL> -b *<partial_bundleID> --test update
Torunatestinstallationofonespecificbundle:
esxupdate -r <BundleURL> --test update
Ifyouaredoneaccessingthedepot,resettheserviceconsolefirewalltohigh
security:
esxcfg-firewall --blockOutgoing
28
VMware, Inc.
Verifythehosthasenoughdiskspacetoperformtheinstallation.
SeeVerifyingDiskSpaceonpage 27.
Fromtheserviceconsole,logontotheESX Server3.5hostasuserroot.
NOTEIfyoudonothavedirectaccesstotheESX Server3.5host,connectremotely
totheserviceconsoleusingssh.
IfthedepotisnotontheESX Server3.5host,typethefollowingcommandto
enableanoutgoingconnectionfortheserviceconsole:
esxcfg-firewall --AllowOutgoing
Scanthedesiredbundlestodetermineiftheyareapplicableandifdependencies
arehandled.
SeeScanningforApplicableBundlesonpage 22.
NOTEIfthescandeterminedthatabundlerequiresarebootduringthe
installation,youcanusethe--norebootoptionduringtheupdateoperation
toforceallbundlestobeinstalledbeforerebootingtheserver.See
--norebootonpage 34.
Ifconflictswerereturnedbythescan,performthenecessarytaskstoresolvethem.
SeeAboutScanningforApplicableBundlesonpage 14.
VMware, Inc.
29
Dooneofthefollowingtoruntheesxupdateupdatecommand:
NOTEYoudonotneedtospecifythe-d<depotURL>optioninthecommand
ifyouarerunningesxupdatefromthedepotdirectory.
Installallapplicablebundlesinthedepot:
esxupdate -d <depotURL> update
Installspecificbundlesinthedepot:
esxupdate -d <depotURL> -b <bundle1> update
Youcanalsousethewildcardcharacter(*).Forexample,toinstallallsecurity
bundlesinthedepot:
esxupdate -d <depotURL> -b "*SG" update
SeeUsingaWildcard(*)toInstallMultipleBundlesonpage 30.
Installallapplicablebundlesinarollup:
esxupdate -d <depotURL> -b <rollupID> update
Ifnecessary,waitforthesystemtoreboot.
Runtheesxupdatequerycommandtoverifytheinstallationwasasuccess.
SeeVerifyingBundleInstallationsonpage 31.
Ifyouaredoneaccessingthedepot,resettheserviceconsolefirewalltohigh
security:
esxcfg-firewall --blockOutgoing
Forinformationoninstallingbundles,seeInstallingBundlesonanESX Server3.5
Hostonpage 29.
30
VMware, Inc.
Ifnecessary,logontotheESX Server3.5hostasuserroot.
NOTEIfyoudonothavedirectaccesstotheESX Server3.5host,connectremotely
totheserviceconsoleusingssh.
IfthedepotisnotontheESX Server3.5host,typethefollowingcommandto
enableanoutgoingconnectionfortheserviceconsole:
esxcfg-firewall --AllowOutgoing
Runtheesxupdatequerycommand.
esxupdate query
Makecertainthebundleyouinstalledisinthereturnlist.
4
(Optional)Toretrievedetailedinformationaboutoneormorebundlesinthe
returnlist,useoneofthefollowingcommands:
esxupdate -l query
LogontotheESX Server3.5hostasuserroot.
NOTEIfyoudonothavedirectaccesstotheESX Server3.5host,connectremotely
totheserviceconsoleusingssh.
IfthedepotisnotontheESX Server3.5host,typethefollowingcommandto
enableanoutgoingconnectionfortheserviceconsole:
esxcfg-firewall --AllowOutgoing
Runtheesxupdateupdatecommandwiththe--exclude option(-x)andspecify
theRPMpackagename.
NOTEYoudonotneedtospecifythe-d<depotURL>optioninthecommandif
youarerunningesxupdatefromthedepotdirectory.
esxupdate -d <DepotURL> -x <PackageName> update
VMware, Inc.
31
Forexample,iftheRPMnameisxinetd-2.6.3-0.18.i386.rpm,xinetdisthe
packagename:
esxupdate -d <DepotURL> -x xinetd update
Thisoptionworksacrossallbundlesinthedepot;therefore,youdonotneedtouse
the -bflagtospecifythebundlecontainingtheRPMpackage.
4
Ifyouaredoneaccessingthedepot,resettheserviceconsolefirewalltohigh
security:
esxcfg-firewall --blockOutgoing
Formoreinformationoninstallingbundles,seeInstallingBundlesonanESX Server
3.5Hostonpage 29.
Reinstalling Bundles
CAUTIONVMwaredoesnotrecommendreinstallingbundlesbecauseinstallinga
bundleoverwritestheexistingfilesonthesystem,regardlessofwhetherthesystem
filesarenewer.Ifyouoverwriteafilewithanolderversion,youmaydestabilizeyour
ESX Server3.5host.VMwarecannotprovideguaranteesfortheintegrityofthe
ESX Server3.5hostunlessyouarereinstallingthelatestRPMpackages.VMware
suggestsyoucallVMwaretechnicalsupportbeforeyouperformareinstallation.
1
Fromtheserviceconsole,logontotheESX Server3.5hostasuserroot.
NOTEIfyoudonothavedirectaccesstotheESX Server3.5host,connectremotely
totheserviceconsoleusingssh.
IfthedepotisnotontheESX Server3.5host,typethefollowingcommandto
enableanoutgoingconnectionfortheserviceconsole:
esxcfg-firewall --AllowOutgoing
Runtheesxupdateupdatecommandwiththeesxupdate -f flagandspecifythe
bundleID.
NOTEYoudonotneedtospecifythe-d<depotURL>optioninthecommandif
youarerunningesxupdatefromthedepotdirectory.
esxupdate -d <DepotURL> -b <BundleID> -f update
Ifyouaredoneaccessingthedepot,resettheserviceconsolefirewalltohigh
security:
esxcfg-firewall --blockOutgoing
32
VMware, Inc.
Reinstallingabundlechangesthetimestampandthepatchorderreturnedbythe
esxupdatequerycommand.Thisdoesnoteffecttheupdateoperationesxupdatewill
continuetoinstallbundlesinthecorrectorder.
Reference Information
Thissectioncontainsthefollowingreferenceinformation:
esxupdateOptionsandCommandsonpage 33.
esxupdateExitCodesandErrorMessagesonpage 37.
VMwareReleaseTerminologyonpage 41.
FrequentlyAskedQuestionsonpage 43.
InstallationChecklistonpage 44
esxupdate Options
Table 3. esxupdate Options
Option
Flag
Description
-d <depotURL>
-d
Specifiesthelocationofadepot.Ifnotspecified,esxupdate
assumesthecurrentdirectoryisadepot.Whenyouusethe
-d flagwithoutthe-bflag,esxupdatehandlesallbundles
inthedepot.Forexample:
(HTTP): esxupdate -d
http://<HTTP_Server_Hostname>/esx350
(FTP): esxupdate -d
ftp://<FTP_Server_Hostname>/esx350
(NFS):esxupdate -d file:///var/updates/esx350
VMware, Inc.
33
Flag
Description
-b <BundleID> | <*>
-b
Specifiesoneormorebundles.Ifnotspecified,allbundles
arehandled.Useone-bflagforeachbundletoinstall.For
example:
esxupdate -b ESX350-200802055-BG -b
ESX350-200803066-SG
Usetheasterisk(*)wildcardasasubstituteforany
charactersinthebundlename.Forexample,toretrievea
listofalluninstalledbundlesforESX Server3.5,usethe
followingcommand:
esxupdate -b ESX350* info
Ifyoudonotrunthecommandfromthedepotdirectory,
youmustspecifythedepotlocationwiththe-dflag.
Explains,indetail,whyabundleisnotapplicable,has
conflictsorhasdependencyissues.Usethisoptionwith
theesxupdate scanoperation.Forexample:
--explain
--flushcache
-l
ListsdetailsaboutRPMsinabundle.Usethisoptionwith
the-d,-b,or-rflagsandtheesxupdate infoand
esxupdate querycommands.
Whenusedwiththeesxupdateinfocommand,lists
detailsaboutabundlesinstalledandnotinstalled(or
skipped)RPMpackages,includingtheirversion
numbers.AlsolistsRPMsremovedbythebundle.
Whenusedwiththeesxupdatequerycommand,
providesdetailsaboutthepackagesthathavebeen
installed,removed,orupgradedonanESX Server
host.Thisincludespackagesnothandledby
esxupdate.
SeeToretrieveinformationaboutinstalledbundleson
page 24andToretrieveinformationaboutbundlesina
depotonpage 25.
--noreboot
34
-n
ForcesesxupdatenottoreboottheESX Serverhostafter
installingthebundle.Youcanusethiscommandwhenyou
installmultiplebundlesatonetime.
VMware, Inc.
Flag
Description
--nosigcheck
Forcesesxupdatenottocheckthedepotfilesignatures.Use
thiscommandifyourVMwarelicensehasexpiredandyou
havenotyetreceivedanewone.
--test
Downloadstheappropriatebundlefiles,preloadsthe
esxupdatedepotcacheforHTTPandFTPservers,checks
forbundleandsystemdependencies,anddeterminesthe
bundleorderandRPMstobeinstalledwithoutinstalling
anypackages.Usethisoptionwiththeesxupdate update
command.Forexample:
esxupdate -d <depotURL> --test update
Thisoptiondisplaysstatusinformationsoyoucan
previewhowtheupdatewilloccur.
NoteThisoptiondoesnotcheckforRPMlevel
dependencies.
SeeRunningaTestInstallonpage 27.
--verbose
Changesthelevelofdetailwrittentotheesxupdate.log
file.Possiblevaluesare:
10Debug
20DetailedInformation
30Warning
40Error
Thefollowingoptionsarenotrecommendedandareprovidedonlyforbackwardcompatibility.
--repo <bundleURL>
-r
Providedforbackwardcompatibilityonly,andshouldnot
beused.Itdoesnotresolvedependencyissues.
Specifiesthelocationofabundledirectory.Usethis
commandtorunanoperationonaspecificbundle.For
example:
(HTTP): esxupdate -r
http://<HTTP_Server_Hostname>/<esx>/<bundleID1
>
(FTP): esxupdate -r
ftp://<FTP_Server_Hostname>/esx35/<bundleID1>
(NFS):esxupdate -r
file:///var/updates/esx35/<bundleID1>
VMware, Inc.
35
Flag
Description
--exclude
<package>
-x
ExcludesthespecifiedRPMpackageduringinstall.Use
thisoptionwiththeesxupdate updatecommand.It
worksacrossallbundles;thereforeyoudonotneedto
specifythebundlecontainingit.Useone-xflagforeach
RPMtoexclude.ThepackagenamemustbeanRPM
name.Forexample:
esxupdate -x RPM1 -x RPM2 update
Ifyoudonotrunthecommandfromadepotorbundle
directory,youmustspecifytheappropriatepathwiththe
-dor-rflag.
SeeOmittingRPMsfromtheInstallationonpage 31.
--force <BundleID>
-f
Reinstallsthespecifiedbundle.Thisoptionisnot
recommendedbecauseitoftendowngradestheRPM
installed.Useitwiththeesxupdate updatecommand
onlytoreinstallacurrentbundle.
esxupdate Commands
Table 4. esxupdate Commands
Command
Description
esxupdate info
Displaysinformationaboutbundles,includingabriefsummary,
buildandinstalltimes,bundledependencies,andRPMdetails.This
commandretrievesthebundledefinitionsfromthedepotorthepatch
databaseontheESX Serverhost(/etc/vmware/patchdb).See
RetrievingBundleInformationonpage 24.
Syntax for bundles in a depot:
esxupdate [-d <depotURL> ] [-b <BundleID> | <*>]
[--listrpms] info
Syntax for bundles in the patch database:
esxupdate [--listrpms] info <bundleID1> <bundleID2>
esxupdate query
Returnsalist,ininstallorder,ofallbundlesinstalledonthe
ESX Serverhost.Ifabundlewasmadeobsoletebyanewerbundle,
onlythenewerbundleisreturned.SeeToretrieveinformationabout
installedbundlesonpage 24.
Syntax
esxupdate [--listrpms] query
36
VMware, Inc.
Description
esxupdate scan
Checksuninstalledbundlesforreleasespecificdependencies,
obsoletebundledependencies,andsystemstatedependenciesto
determinewhatpatchesarevalidtoinstallandinwhatorder.Youcan
scantheentiredepotorspecifybundlesinthecommand.Theoutput
isthedependencyinformation.SeeAboutScanningforApplicable
Bundlesonpage 14.
Syntax
esxupdate [-d <depotURL> ] [-b <BundleID> | <*> ]
[--explain] [--nosigcheck] [--test] [--verbose] scan
esxupdate update
Checksthespecifiedbundlesfordependencies,checkstheESX Server
hostfordependencies,determineswhichbundlestoinstall,and
installsthemontheESX Serverhost.SeeInstallingBundlesonan
ESX Server3.5Hostonpage 29.
Syntax
esxupdate [-d <depotURL> ] [-b <BundleID> | <*>]
[--nosigcheck] [--noreboot] [--exclude <package>]
[--test] [--flushcache] [--verbose] update
Error Message
Theinstallationcompletedsuccessfully;the
esxupdateutilityhasnotaskstocomplete.
Theesxupdateoperationisfinishedor
whenthespecifiedbundleisalready
installed.
Workaround:None.
80
Theinstallationcompletedsuccessfullyand
theESX Serverhostmustberebooted.
Theesxupdateoperationisfinished
andaninstalledbundlerequiresa
systemreboot.
Workaround:ReboottheESXServer
host.
Youaretryingtorunesxupdateasauser
otherthanroot.
YouloggedintotheESXServerhostas
auserotherthanrootandtrytorun
esxupdate.
Workaround:Loginasrootandtry
again.
Invalidcommandlinesyntaxorarguments.
Thecommandyouenteredtorun
esxupdateisincorrectorismissingan
option.
Workaround:Checkthecommandline
syntaxandfixanyerrors.
VMware, Inc.
37
Error Message
GeneralIOError.
Therearenetworkissuesorfilesystem
errors,suchasproblemswithfileaccess
permissions.
Workaround:
YumisnotinstalledortheYum
configurationfile(yum.conf)ismissing.
TheYuminstallationcontainserrors
andtheyum.conffileisnotinthe /etc
directoryontheESXServerhost.
Workaround:ReinstallYumorrestore
themissingyum.conffile.
Alockcannotbeacquiredbecauseanother
instanceofesxupdateisrunning.
Youcanrunonly1esxupdateinstance
onthesamehostatonetime.
Workaround:Waituntiltheother
instanceisfinishedandthenrerunthe
esxupdatecommand.Youcanmonitor
esxupdatestatusintheesxupdate.log
filelocatedinthe/var/log/vmware/
directory.
10
ThespecifiedURLisnotcorrect.
TheURLcontainserrors.
Workaround:Makesureyouusefile:
orhttp:atthebeginningoftheURL
andcheckthattherearenospelling
errors.
11
Afilewasnotdownloadedorismissing
fromthedepotcache.
Theesxupdatecommandcantfindthe
specifiedfileinthelocalcache.
Workaround:Makesurethenetwork
connectionisworkingandrerunthe
command.
12
38
Thecontents.xmlfileordescriptor.xml
filecouldnotbeparsed,wascorrupt,orhad
anillegalvalue.
esxupdatecouldnotvalidatethefile.
Workaround:Makesurethe.zipfile
downloadedcorrectlyandrunanmd5
check.Ifthefileiscorrupt,deleteitand
downloaditagain.
VMware, Inc.
Error Message
13
ThepatchdatabaseontheESX Serverhost
iscorrupt.
esxupdatecouldnotvalidatethepatch
databaselocatedinthe
/etc/vmware/patchdbdirectoryand
theintegritycheckfailed.
Workaround:
20
Thereleasedoesnotexistinthepatch
database.
Deletethepatchdatabasefilefrom
theESXServerhost.andrecreateit.
Downloadandreinstallthe3.5
releasedescriptorfile.
Downloadthelatestrollup.
Runesxupdate updateonthe
entiredepot.
Thebundleyouarespecifyingisnot
installedonthehost.
Workaround:Runtheesxupdate
querycommandtogetalistofinstalled
bundles.Thenruntheesxupdate
info<bundleID>commandona
bundleIDreturnedbythequery.
33
34
Thereisnotenoughdiskspacetoinstallthe
specifiedbundle.
AnRPMdependencyerroroccurred.
Thisisastandarddiskspaceerror.
Workaround:Clearthedepotcacheor
/tmpdirectoryandrerunthe
esxupdate updatecommand.
Generallyoccurswhena3rdparty
agenthasadependencyVMware
doesntaddress.
Workaround:Determineifthe
dependentRPMisneededinyour
environmentanddooneofthe
following:
VMware, Inc.
Usethe --forceoptiontoinstall
theRPM.
Usethe--excludeoptiontoskip
theRPM..
39
Error Message
37
Themetadatasignaturesforthespecified
bundlecouldnotbeauthenticated.
Thereisageneralintegrityerrorwitha
bundlemetadatafileorrpmpackage.
Thiscanoccurifthefilewasdamaged
duringthedownloadoperationorifit
wasdownloadedfromanonVMware
siteandwasaltered.
Workaround:Downloadthebundle
fromtheVMwareDownloadCenter
andreruntheesxupdatecommand.
40
Generalbundledependencyerror.
Morethanonebundlehasa
dependencyerrorsoaspecificerror
codecouldnotbereturned.
Workaround:Checkthe
/var/log/vmware/esxupdate.log
fileforadescriptionoftheproblemand
awaytoworkaroundit.
41
42
Thebundlerequiresthespecifiedbundleto
beinstalledfirst.
Thisbundleisobsoleteanddoesnotneedto
beinstalled.Asupersedingbundlehasbeen
installedonthishost.
Therequiredbundleisntinthedepot.
Workaround:Downloadlatestrollup
andthenrunesxupdate updateon
thedepot.
Youspecifiedanobsoletebundleto
installandtheESXServerhosthas
alreadybeenupdatedwithanewer
bundlethatsupersedestheobsolete
bundle.
Workaround:None.VMwaresuggests
youdontinstalltheobsoletebundle.
43
Thebundleyouareinstallingconflictswith
<bundleID>installedonthishost.
YouspecifiedabundleIDtoinstalland
itconflictswithabundlealready
installedonthehost.
Workaround:None.Bothbundles
shouldnotbeinstalledonthesame
host.
40
VMware, Inc.
Error Message
52
Afailureoccurredwhileinstallingor
removingpatchpackages.Examinethe
esxupdatelogfile
(/var/log/vmware/esxupdate.log)for
detailsaboutthefailure.
ThisisageneralRPMerror.Problems
mightexistwhenwritingtotheRPM
postscriptfile.
54
Thepatchinstallationcompleted
successfully;howeveranerroroccurred
duringsystemreconfigurationanditmay
notbeabletoboot.
Workaround:checktheesxupdate.log
filefordetails.Mostoften,rerunning
thesameesxupdatecommandwillfix
theproblem.
Thisoccursduringageneralupdateto
driversortheVMkernel.Ifanyofthe
updatestepsfail,thiserrorcanoccur.
Workaround:Checkthe
(/var/log/vmware/esxupdate.log
filefordetailsontheerror.Thenrerun
thesameesxupdatecommand.RPMs
alreadyinstalledareskipped.
Majorreleases.SeeAboutMajorReleasesonpage 41.
Minorreleases.SeeAboutMinorReleasesonpage 42.
Maintenancereleases.SeeAboutMaintenanceReleasesonpage 42.
Updatereleases.SeeAboutUpdateReleasesonpage 42.
ForinformationaboutVMwaresupportpolicies,see
http://www.vmware.com/pdf/support_terms_conditions.pdf.
NOTEThissectionusesanx.y.zconventiontodenoteproductversionnumbers.
41
AboutVMwareUpdateManager
AboutVMwareInfrastructureUpdate
AboutvihostupdateRemoteCLI
Youcanaccessthemostcurrentversionsofthedocumentationforeachtoolbygoing
tohttp://www.vmware.com/support/pubs.
42
VMware, Inc.
VMware, Inc.
43
Installation Checklist
Printthischecklistanduseitasaguidewheninstallingpatches.
Setupdepots
SeeSettingupPatchDepotsonpage 19.
Downloadthepatch.zipfile
SeeDownloadingandExtractingPatchFilesonpage 22.
Downloadthelatestcontentsfile
SeeDownloadingandExtractingPatchFilesonpage 22.
Scanforapplicablebundles
SeeScanningforApplicableBundlesonpage 22.
Runatestinstall
SeeRunningaTestInstallonpage 27.
Installapplicablebundles
SeeInstallingBundlesonanESX Server3.5Hostonpage 29.
Verifythatbundleswereinstalledcorrectly
SeeVerifyingBundleInstallationsonpage 31.
44
VMware, Inc.
Index
B
bundles
about 7
about extracting 10
about installing 16
applicability flags 14
deleting 21
dependencies 13
installing 29
querying bundles in a depot 25
querying installed bundles 24
reinstalling 32
retrieving RPM details 25
scanning 14, 22
test install 27
verifying installation 31
C
contents file
about 10
downloading 22
customizing patching, about 18
D
dependencies, about 13
depots
about 10
clearing the cache 21
deleting bundles 21
downloading files 22
example directory structure 11
FTP 20
VMware, Inc.
HTTP 19
maintaining 21
NFS 20
querying bundles 25
descriptor file
about 10
disk space
requirements 27
E
error messages 37
esxupdate
-b option 34
-d option 33
--exclude option 36
exit codes and error messages 37
--explain option 34
--flushcache option 34
--force option 36
info operation 36
-l (--listrpms) option 34
--noreboot option 34
--nosigcheck option 35
query operation 36
-r option 35
scan operation 37
--test option 35
update operation 37
--verbose option 35
esxupdate utility
about 12
commands 33, 36
45
options 33
Exit codes 37
explain scan option
sample output 16
FAQ 43
frequently asked questions 43
FTP depots 20
patch tools 42
support level definitions 9
patching
customizing 18
strategy 18
patching tools
vihostupdate Remote CLI 43
VMware Infrastructure Update 43
VMware Update Manager 43
HTTP depots 19
query command
about 36
sample output 25
I
info command
about 36
sample output 26
installation
disk space 27
verifying 31
installed bundles
listing 24
M
maintenance releases, about 42
major releases, about 41
minor releases, about 42
N
NFS depots 20
P
patch download center 7
patch releases, about 8
patches
about 7
classification descriptions 8
downloading 22
naming 8
naming convention 8
46
R
reinstalling bundles 32
releases, about 41
repositories
about 10
FTP 20
HTTP 19
NFS 20
roll-ups
about 7
about extracting 11
about installing 16
installing 29
RPM packages
omitting 31
retrieving details 25
S
scan command
about 37
sample output 15
scan option
sample output 16
VMware, Inc.
Index
scanning bundles 22
about 14
applicability flags 14
explaining scan results 23
using a wildcard 23, 30
system dependency flags 15
T
test install, running 27
U
update command
about 37
update releases, about 42
V
vihostupdate Remote CLI 43
VMware Infrastructure Download
Center 7
VMware Infrastructure Update 43
VMware releases
maintenance releases 42
major releases 41
minor releases 42
patch releases 8
update releases 42
VMware Update Manager 43
W
wildcard character
installing bundles 30
scanning bundles 23, 30
VMware, Inc.
47
48
VMware, Inc.