Professional Documents
Culture Documents
2006 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,961,941, 6,961,806 and 6,944,699; 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.
3145 Porter Drive
Palo Alto, CA 94304
www.vmware.com
ii
VMware, Inc.
Contents
Chapter1Introduction ...............................................1
Concepts ..............................................................2
WhattoBackUp .......................................................2
VirtualMachineContents .............................................3
VirtualMachineDisks .............................................3
RawDeviceMappings.............................................4
AccessingandManagingVirtualDiskFiles .............................4
BackupComponentsandApproaches ....................................5
BackupApproaches ..................................................6
UsingTraditionalBackupMethods .......................................6
TraditionalBackupConsiderations.....................................7
BackingUptheServiceConsole .......................................7
BackingUpVirtualMachines .........................................8
BackupClientinaVirtualMachine..................................8
BackupClientintheServiceConsole................................10
SANBackups ....................................................11
NFSBackups ....................................................11
UsingVMwareConsolidatedBackup ....................................12
VMwareConsolidatedBackupAdvantages............................12
VMware, Inc.
iii
Chapter2VMwareConsolidatedBackup ........................13
Overview............................................................14
HowConsolidatedBackupWorks .......................................14
IntegrationwithThirdPartyBackupSoftware ..........................14
Requirements ......................................................15
VMwareVirtualMachineSnapshotTechnology ........................16
ConsiderationsWhenCreatingSnapshots ...........................17
FileLevelBackups ...............................................17
FullVirtualMachineBackups ......................................18
SettingUpConsolidatedBackup........................................18
VMwareESXServerandVirtualCenterConfiguration ...................18
SANConfiguration .................................................19
ConfiguringtheThirdPartySoftware.................................20
ChangingBackupPoliciesafterESXServerUpgrades.................20
VCBProxyConfiguration ............................................21
HardwareRequirements ..........................................21
Prerequisites.....................................................21
ConfiguringWindowsontheVCBProxy ..............................22
DisablingAutomaticDriveLetterAssignment.......................22
ConfiguringtheConsolidatedBackupFramework ....................23
InstallingaBackupSoftwareInteroperabilityModule .................25
ConfiguringVirtualMachinesforConsolidatedBackup ....................25
ConsolidatedBackupRestrictions.......................................25
UsingConsolidatedBackup ............................................26
Aliases............................................................26
ConfiguringBackupJobs ............................................27
FirstTimeBackup ..................................................27
AdvancedConfigurations ..............................................27
RunningCustomQuiescingScripts ...................................28
CancelingaBackupJob ..............................................29
Chapter3RestorationandDisasterRecovery ....................31
RestoringYourFilesUsingConsolidatedBackup ..........................32
Restore ............................................................32
CentralizedRestore...............................................32
PerGroupRestore................................................32
SelfServiceBackup ...............................................33
RestoringFilesUsingthevcbRestoreUtility ..............................33
iv
VMware, Inc.
Contents
DataRecovery ........................................................33
Troubleshooting ......................................................33
Chapter4BackupScenarios........................................35
BackupUsageScenarios ...............................................36
ATypicalConsolidatedBackupUsageScenario ...........................36
AppendixAUsingServiceConsoletoBackUpandRestore
VirtualMachines .................................................37
GeneralConfigurationSettingsforConsolidatedBackupUtilities ...........38
ConfigurationFileSettings ...........................................38
BackingUpVirtualMachines ...........................................40
PerformingBackups ................................................40
IdentifyingVirtualMachines .........................................41
IdentifyingVirtualMachinesbyDNSNameorIPAddress ............41
IdentifyingVirtualMachinesbyBIOSUUID .........................41
IdentifyingVirtualMachinesbyMoRef .............................42
IdentifyingGroupsofVirtualMachines.............................42
SpecifyingBackupDestinations.......................................43
BackingUptoaLocalDirectory ....................................43
BackingUptoaRemoteServer.....................................43
RestoringVirtualMachines.............................................44
RestoringVirtualMachinestoOriginalLocations.......................44
RestoringVirtualMachinestoAlternativeLocations ....................44
CopyingaCatalogFile ............................................45
EditingaCatalogFile.............................................45
RestoringVirtualMachinesUsinganAlternateCatalog ...............47
NoninteractiveUseofthevcbRestoreUtility ...........................48
AppendixBRestoringVirtualMachinesfrom
ESXServer2.5.xtoESXServer3.0 ..............................49
SettingConfigurationParameters .......................................50
RestoringESX2.5.xServerVirtualMachines ..............................51
Index ..................................................................53
VMware, Inc.
vi
VMware, Inc.
Preface
ThisprefacedescribesthecontentsoftheVirtualMachineBackupGuideandprovides
pointerstotechnicalandeducationalresources.
Thisprefacecontainsthefollowingtopics:
!
AboutThisBookonpage viii
IntendedAudienceonpage viii
DocumentFeedbackonpage viii
VMwareInfrastructureDocumentationonpage viii
ConventionsandAbbreviationsonpage ix
TechnicalSupportandEducationResourcesonpage ix
VMware, Inc.
vii
Intended Audience
Theinformationpresentedinthismanualiswrittenforsystemadministratorswhoare
experiencedWindowsorLinuxsystemadministratorsandwhoarefamiliarwith
virtualmachinetechnologyanddatacenteroperations.
Document Feedback
Ifyouhavecommentsaboutthisdocumentation,submityourfeedbackto:
docfeedback@vmware.com
viii
VMware, Inc.
Preface
Purpose
Monospace
Usedforcommands,filenames,directories,paths.
Monospace bold
Applytoindicateuserinput.
Bold
Usefortheseterms:
Interfaceobjects,keys,buttons
Itemsofhighlightedinterest
Glossaryterms
Italic
Usedforbooktitles.
<name>
Anglebracketsindicatevariableandparameternames.
SelfServiceSupport
OnlineandTelephoneSupport
SupportOfferings
VMwareEducationServices
Self-Service Support
UsetheVMwareTechnologyNetworkforselfhelptoolsandtechnicalinformation:
!
ProductInformationhttp://www.vmware.com/products/
TechnologyInformationhttp://www.vmware.com/vcommunity/technology
Documentationhttp://www.vmware.com/support/pubs
KnowledgeBasehttp://www.vmware.com/support/kb
DiscussionForumshttp://www.vmware.com/community
UserGroupshttp://www.vmware.com/vcommunity/usergroups.html
FormoreinformationabouttheVMwareTechnologyNetwork,gotohttp://
www.vmtn.net.
VMware, Inc.
ix
Support Offerings
FindouthowVMwaressupportofferingscanhelpyoumeetyourbusinessneeds.Go
tohttp://www.vmware.com/support/services.
VMware, Inc.
C HAPTER 1
Introduction
Backup,restoration,anddisasterrecoveryareamongthemostcriticalprocessesof
datacentermanagement.VMwareESXServerandVMwareInfrastructureprovide
manydifferentsolutions,eachsuitableforaspecificenvironment,toperformbackup
andrestoretasks.
ThisintroductiondescribeswhichresourcesshouldbebackeduponanESXServer
systemandexplainsoptionsavailableforthatbackup.
Thischapterincludesthefollowingsections:
!
Conceptsonpage 2
WhattoBackUponpage 2
BackupComponentsandApproachesonpage 5
UsingTraditionalBackupMethodsonpage 6
UsingVMwareConsolidatedBackuponpage 12
VMware, Inc.
Concepts
Thefollowingconceptsareessentialforyourunderstandingofbackupprocedures:
!
QuiescingAprocessofbringingtheondiskdataofaphysicalorvirtual
computerintoastatesuitableforbackups.Thisprocessmightincludesuch
operationssuchasflushingdirtybuffersfromtheoperatingsystemsinmemory
cachetodisk,orotherhigherlevelapplicationspecifictasks.
Volumelevel(imagelevel)backupAtypeofbackupthatbacksupanentire
storagevolume.
FilelevelbackupAtypeofbackupthatisdefinedattheleveloffilesandfolders.
FullbackupBacksupallselectedfiles.
FullvirtualmachinebackupBacksupallfilesthatcompriseentirevirtual
machine.Thesefilesincludediskimages,.vmxfiles,andsoon.
DifferentialbackupBacksuponlythosefilesthathavechangedsincethelast
fullbackup.
IncrementalbackupBacksuponlythosefilesthathavechangedsincethelast
backup,whetheritisafullorincrementalbackup.
VCBproxyAphysicalmachinerunningMicrosoftWindows2003,Consolidated
Backup,andthirdpartybackupsoftware.Usedtoperformoffloadedfilelevel
andfullvirtualmachinebackups.
What to Back Up
WithintheESXServerenvironment,youneedtobackupthefollowingmajoritems
regularly:
!
VirtualmachinecontentsBecausevirtualmachinesareusedfrequently,critical
informationstoredintheirdiskfilesconstantlychanges.Aswithphysical
machines,virtualmachinedataneedstobebackedupperiodicallytopreventits
corruptionandlossduetohumanortechnicalerrors.
Thevirtualmachinedatayoubackupincludesvirtualdisks,RawDevice
Mappings(RDM),configurationfiles,andsoon.Formoreinformation,see
VirtualMachineContentsonpage 3.
VMware, Inc.
Chapter 1 Introduction
ESXServerserviceconsoleTheserviceconsole,acustomizedversionofLinux,
istheESXServercommandlinemanagementinterface.ItprovidestheESXServer
managementtoolsandacommandpromptformoredirectmanagementofESX
Server.Italsokeepstrackofallthevirtualmachinesontheserverandtheirconfig
urations.
NOTE
Inearlierreleases,theserviceconsolewasthemaininterfacetotheESX
Serverhost.WithESXServer3andlater,theVIClienthaspriority,
althoughyoustillmightusetheserviceconsoletoperformsome
advancedadministrationoperations.
Duringitslifetime,theserviceconsoledoesntexperienceanymajorchangesother
thanperiodicupgrades.Inaddition,incaseofafailure,youcaneasilyrecoverthe
stateofyourserviceconsolebyreinstallingESXServer.Therefore,althoughyou
mightconsiderbackinguptheserviceconsole,itdoesntneedtobebackedupas
frequentlyasthevirtualmachinesandtheirdata.
VMware, Inc.
Alltheinformationnormallybackedupintheenterpriseinfrastructure,
includingtheoperatingsystem,applications,anddata,isincludedinthe
virtualdisks.
VMware, Inc.
Chapter 1 Introduction
asext3,VMFSisprimarilyintendedtostorelargefiles,suchasdiskimageswiththe
sizeofupto2TB.Youcanuseftp,scp,andcpcommandsforcopyingfilestoandfrom
aVMFSvolumeaslongasthehostfilesystemsupportstheselargefiles.
NOTE
InLinux,importingalargediskfromaCommonInternetFileSystem(CIFS)
mounthangstheESXServer,whichmustthenberebooted.IfConsolidated
Backupisnotused,largefilesneedtobemovedfromtheserviceconsoleto
tapebackup.Todothiseffectively,usesupportedprogramswithnoreported
knownissues.Asaworkaround,usesmbclienttocopythelargefileontoa
localdirectoryontheserviceconsoleandthenimportfromthere.
Additionalfileoperationsareenabledthroughthevmkfstoolscommand.This
commandsupportsthecreationofaVMFSonaSCSIdiskandisusedforthefollowing:
!
Creating,extending,anddeletingdiskimages
Importing,exporting,andrenamingdiskimages
Settingandqueryingpropertiesofdiskimages
CreatingandextendingaVMFSfilesystem
Formoreinformationonthevmkfstoolscommand,seetheServerConfigurationGuide.
BackupClient(BackupAgent)Aprogramthatscansvirtualmachinefile
systemsandtransfersdatatobebackeduptoabackupserver.Duringrestore
operations,thebackupclientwritesthedataintothefilesystems.
BackupServerAprogramthatwritesthedata,pushedbythebackupclient,to
abackupmedium,suchasarobotictapelibrary.Duringrestoreoperation,the
backupserverreadsthedatafromthebackupmediumandpushesittothebackup
client.
SchedulerAprogramthatallowsyoutoscheduleregularautomaticbackupjobs
andcoordinatetheirexecution.Backupscanbescheduledatperiodicintervals,or
individualfilescanbeautomaticallybackedupimmediatelyaftertheyhavebeen
updated.
VMware, Inc.
Backup Approaches
Eachofthebackupsoftwarecomponentscanberuninavirtualmachine,ontheservice
console,oronaphysicalmachine,oraVCBproxy,runningMicrosoftWindows2003.
Whilethelocationoftheschedulerisntimportant,thelocationsofthebackupserver
andbackupclientareimportant.
Dependingonwhereyouwanttoruneachcomponent,youchooseoneofthefollowing
approaches:
!
Usetraditionalbackupapproach.Withthisapproach,youdeployabackupclient
toeverysystemthatrequiresbackupservices.Youcanthenregularlyperform
backupsinanautomatedway.
Withthisapproach,severalmethodologiesexist.Youcanchooseaspecificmethod
thatbettersuitesyourneedsandrequirements.
Formoreinformation,seeUsingTraditionalBackupMethodsonpage 6.
UseVMwareConsolidatedBackup,whichenablesoffloadedandimpactfree
backupforvirtualmachinesrunningonESXServer.Thisapproachletsyouusethe
virtualmachinesnapshottechnologyandSANbaseddatatransferinconjunction
withtraditionalfilebasedbackupsoftware.
WhenrunningConsolidatedBackup,youcanbackupvirtualmachinecontents
fromacentralizedMicrosoftWindows2003proxyserverratherthandirectlyfrom
theESXServersystem.UtilizingaproxyserverreducestheloadonESXServer
allowingittorunmorevirtualmachines.
FormoreinformationonConsolidatedBackup,seeVMwareConsolidated
Backuponpage 13.
FormoreinformationonthesnapshottechnologythatConsolidatedBackup
employs,seeVMwareVirtualMachineSnapshotTechnologyonpage 16.
VMware, Inc.
Chapter 1 Introduction
Usingtraditionalmethods,youcanbackupyourserviceconsoleandvirtualmachines.
Formoreinformation,see:
!
BackingUptheServiceConsoleonpage 7
BackingUpVirtualMachinesonpage 8
Tobeabletocapturethedatainitsconsistentstate,performbackupsatthetimes
ofthelowestactivityonthenetworkandwhenyourcomputerresourcesare
mostlyidle.Whileperformingbackups,youmightneedtotakecriticalapplica
tionsoffline.
Makesurethatnetworkbandwidthbetweentheserveryouarebackingupandthe
backupserverissufficient.
Withalargenumberofservers,bothphysicalandvirtual,allocateenough
resourcestomanagebackupsoftwareoneachhost.Rememberthatmanaging
agentsineveryvirtualmachineisverytimeconsuming.
FileBasedTheserviceconsolecanbetreatedasaphysicalmachinewitha
deployedbackupagent.Torestoretheserviceconsole,firstreinstallit,then
reinstalltheagent,andthenrestorethefilesthatyoubackedup.Thisapproach
makessenseifmanagementagentsthatarehardtosetuphavebeendeployedin
theserviceconsole.Otherwise,thisapproachprovidesnoadvantageovernot
backinguptheserviceconsole.
ImageBasedUsethirdpartysoftwaretocreateabackupimagethatyoucan
restorequickly.UseyourbootCDorwhateverthebackupsoftwarecreatedto
restoretheserviceconsole.
VMware, Inc.
BackupClient
NOTE
Virtual
Machine
PhysicalMachine
VirtualMachine
Method1
Method2
ServiceConsole
Method3
Method4
Runningthebackupserverintheserviceconsoleisnotsupported.
Traditionalbackupmethodsofferthefollowingoptions:
!
Youcanrunbackupclientsfromwithinavirtualmachineperformingfilelevelor
systemlevelbackups.Aslongasyouarebackingupoverthenetwork,no
compatibilityguideisneeded.
YoucanrunbackupclientsfromtheESXServerServiceConsole,backingup
virtualmachinesintheirentiretyas.dskand/or.vmdkfilesresidingintheESX
ServerhostVMFSfilesystem.
Youcanbackupvirtualmachinedatabyrunningabackupserverwithinavirtual
machinethatisconnectedtoatapedriveorotherSCSIbasedbackupmedia
attachedtothephysicalsystem.
Method1isnotrecommendedinESXServerexceptinabranchofficescenario
wherenoseparatehardwareforaVCBproxyorbackupserverisavailable.
VMware, Inc.
Chapter 1 Introduction
Whenyouusemethod1,thebackupagentperformsquiescingofavirtualmachine
beingbackedup.
Method1isgenerallyusedforfilelevelbackupsofthedatastoredwithinthevirtual
machinesdiskimage.
BackupServerinaVirtualMachine
Recommended:
No
Filelevelrestore:
Veryeasy
Fullvirtualmachinerestore:
No
Quiescing:
Excellent
LoadonESXServer:
Extremelyhigh
LANfreebackup:
No
BackupImpact:
No
Manageability:
Verypoor
Insteadofmethod2,considerusingConsolidatedBackup.
Method2isusedforfilelevelbackupsofthedatastoredwithinthevirtualmachines
diskimage.
BackupServerinaPhysicalMachine
VMware, Inc.
Recommended:
Yes
Filelevelrestore:
VeryEasy
Fullvirtualmachinerestore:
No
Quiescing:
Excellent
LoadonESXServer:
High
LANfreebackup:
No
BackupImpact:
No
Manageability:
Verypoor
Method3isnotrecommendedinESXServerexceptinabranchofficescenario
wherenoseparatehardwareforaVCBproxyorbackupserverisavailable.
Method3isusedtoperformimagelevelbackups,orbackupsofentirevirtual
machines.
BackupServerinaVirtualMachine
Recommended:
No
Filelevelrestore:
No
Fullvirtualmachinerestore:
Veryeasy
Quiescing:
Excellent
LoadonESXServer:
Extremelyhigh
LANfreebackup:
No
BackupImpact:
No
Manageability:
Verypoor
10
Insteadofmethod4considerusingConsolidatedBackup.
VMware, Inc.
Chapter 1 Introduction
Method4isusedtoperformimagelevelbackups.
BackupServerinaPhysicalMachine
Recommended:
Yes
Filelevelrestore:
No
Fullvirtualmachinerestore:
VeryEasy
Quiescing:
Excellent
LoadonESXServer:
High
LANfreebackup:
No
BackupImpact:
No
Manageability/Scalability:
Verypoor
SAN Backups
IfyourvirtualdiskfilesarestoredonaSAN,youcanusefeaturessuppliedbyyour
SANvendortocreateacopyofyourproductionLUN,containingallvirtualdisks.
Thesecopiescanthenbesenttoyourbackupmedia.Withthismethod,youdonothave
tousevirtualmachinesnapshottingfunctionalityduringthebackupprocessbecause
theSANsnapshotguaranteesconsistency.
IfyoudecidetouseSANsnapshotstobackupyourdata,youmustconsiderthe
followingpoints:
!
SomevendorssupportsnapshotsforbothVMFSandRDMs.Ifbotharesupported,
youcanmakeeitherasnapshotofthewholevirtualmachinefilesystemforahost,
orsnapshotsfortheindividualvirtualmachines(oneperdisk).
SomevendorssupportsnapshotsonlyforasetupusingRDM.IfonlyRDMis
supported,youcanmakesnapshotsofindividualvirtualmachines.
Seeyourstoragevendorsdocumentationforadditionalinformation.Formore
informationonSAN,seetheSANConfigurationGuide.
NFS Backups
Ifyourvirtualmachinesarestoredonexternalnetworkattachedstorage(NAS)
systemsusingthenetworkfilesystem(NFS)protocol,youcanperformimagelevel
backupsofthevirtualmachines.
Seeyourstoragevendorsdocumentationforadditionalinformation.
VMware, Inc.
11
12
ReducetheloadonyourESXServersystemsbymovingthebackuptaskstooneor
morededicatedbackupproxies.
Avoidcongestingandoverloadingthedatacenternetworkinfrastructureby
enablingLANfreebackup.
Eliminatetheneedforabackupwindowbymovingtoasnapshotbasedbackup
approach.
Simplifybackupadministrationbymakingoptionalthedeploymentofbackup
agentsineachvirtualmachineyoubackup.
Backupvirtualmachinesthatarepoweredoff.
VMware, Inc.
C HAPTER 2
VMwareConsolidatedBackupisanewbackupsolutionofferedbyESXServer3andis
therecommendedwaytoperformdailybackupsforvirtualmachinesresidingona
SAN.Thismethodperformsbackupsusingadedicatedphysicalhost(proxyclient)
ratherthanbackingupfromanESXServersystemitself.
YoucanuseConsolidatedBackupwithasingleESXServerhostorwithaVirtualCenter
ManagementServer.
Thischapterincludesthefollowinginformation:
!
Overviewonpage 14
HowConsolidatedBackupWorksonpage 14
SettingUpConsolidatedBackuponpage 18
ConfiguringVirtualMachinesforConsolidatedBackuponpage 25
ConsolidatedBackupRestrictionsonpage 25
UsingConsolidatedBackuponpage 26
AdvancedConfigurationsonpage 27
VMware, Inc.
13
Overview
VMwareConsolidatedBackupisafastandefficientwayofbackingupdatainvirtual
machines.
ConsolidatedBackuphasthefollowingcharacteristics:
!
Offloadsbackupprocessestoadedicatedphysicalhost
Doesntrequirebackupagentsinvirtualmachines
Workswithotherindustryleadingbackupapplications
DoesntrestricttheuseofFibreChanneltapes
SupportsfilelevelbackupsforWindowsvirtualmachinesandfull(imagelevel)
backupforallguestoperatingsystems
14
Thethirdpartybackupsoftwareschedulesthebackupjobforasinglevirtual
machineoragroupofvirtualmachines.ThejobrunsontheVCBproxy.
ConsolidatedBackupsprebackupscriptrunsontheVCBproxy,creatingvirtual
machinesnapshots(forWindowsonly)andmountingthemontheproxy.
Thethirdpartybackupsoftwareperformsthebackup.
ConsolidatedBackupspostbackupscriptruns,removingthemountfromthe
VCBproxyandremovingthebackupsnapshots.
VMware, Inc.
Eventhoughthemounteddisksappeartobewritable,changesarecachedontheproxy
astransientwritesandarediscardedoncethediskisunmounted.Thisfeaturelets
youbackupNT4volumesthatuseanolderversionofNTFS.Windows2003running
ontheVCBproxywillfailanymountattemptsforNT4volumesiftheyarereadonly.
Formoreinformation,seeAdvancedConfigurationsonpage 27.
Requirements
TobeabletorunConsolidatedBackup,makesurethatthefollowingrequirementsare
met:
!
MicrosoftWindow2003serverisconfiguredforConsolidatedBackup.See
ConfiguringtheConsolidatedBackupFrameworkonpage 23.
Windowsvirtualmachinesareinplace.Requiredonlyforfilelevelbackup.Full
virtualmachinebackup(imagelevel)issupportedforallguestoperatingsystems.
CAUTION
FilesystemconsistencyisguaranteedforWindowsguestoperating
systemsonly.
SANisconnectedandLUNismasked.
BackupadministratoraccountexistsontheVCBproxywithreadaccesstothe
data.BecauseLUNscontainingVMFSvolumesareaccessiblebytheproxy,to
protecttheVMFSvolumesfromaccidentaldeletion,restrictaccesstotheproxyto
trainedpersonnelonly.
VMware, Inc.
15
ThefollowingillustrateshowdifferentcomponentsofConsolidatedBackupwork
together.
LAN
ESX Server
Backup proxy
virtual machine
backup software
VMware Tools
integration module
(pre-backup script)
file system
Consolidated
Backup
framework
SAN
vmware-hostd
c.vmdk
VMFS
datastore
mydata
16
VMware, Inc.
Takingasnapshotofavirtualmachinefreezesitforaveryshortperiodoftime,
usuallyconsiderablylessthanasecond.
CreatingamemorysnapshotthroughtheUIcanleaveavirtualmachinefrozenfor
acoupleofseconds.Thismightaffectsomeverytimesensitiveapplications,such
asDBHammer.
CreatingquiescedsnapshotsusingtheSYNCdriverrequireswaitingforI/Oto
drainintheguestoperatingsystem.Thismightaffectsomeverytimesensitive
applications,suchasDBHammer.
IfyouchoosenottoinstalltheSYNCdriverwheninstallingVMwareTools,you
canavoidthedelaycausedbytheI/Odraining.However,itresultsinsnapshots
beingonlycrashconsistent,unlessyouprovidecustomquiescingthroughpre/and
postscriptsintheguest.
File-Level Backups
ForvirtualmachinesrunningWindows,ConsolidatedBackupsupportsfilelevel
backups.Afilelevelbackupisidealforpreventingdatalossduetoerrors,suchasfile
corruption,causedbybugsinapplicationprograms,orusererrors,suchasaccidental
filedeletion.
Whenrunningfilelevelbackups,ConsolidatedBackupperformsthefollowing:
1
Analyzesvolumesonvirtualmachinesnapshots.
MountsdiscoveredvolumesontheVCBproxyatpredefinedjunctionpoints.
Eachjunctionpointcorrespondstoadriveletterassignedtoeachpartitioninthe
virtualmachine.Forexample:
C:\mnt\mytestvm.foo.com\letters\D
CAUTION
VMware, Inc.
Becausetheproxycanrecognizeonlythosepartitionsthathavedrive
lettersassignedtothem,makesurethateachvirtualdiskpartition
hasadriveletter.
17
ConsolidatedBackupexportsvirtualmachinediskimagesandconfigurationfiles
toalocaldirectoryontheVCBproxy.Forexample:
C:\mnt\mytestvm.foo.com-fullVM
Thirdpartybackupsoftwarepicksupthevirtualmachinefilesandmovesthemto
thebackupmedium.
VMwareESXServerandVirtualCenter.SeeVMwareESXServerand
VirtualCenterConfigurationonpage 18.
TheSANfabric.SeeSANConfigurationonpage 19.
Thethirdpartysoftware.SeeConfiguringtheThirdPartySoftwareonpage 20.
Thebackupproxy(VCBproxy).SeeVCBProxyConfigurationonpage 21.
WindowsontheVCBproxy.SeeConfiguringWindowsontheVCBProxyon
page 22.
18
VMware, Inc.
SAN Configuration
BeforeinstallingConsolidatedBackup,setupyourESXServerstouseVMwareFile
System(VMFS)orvirtualcompatibilityrawdevicemappings(RDM).Youthenneedto
configuretheSANfabrictowhichboththeESXServersandtheVCBproxyare
connected.
Formoreinformation,seedocumentationprovidedbyyourSANstoragearrayand
switchvendors,aswellastheSANConfigurationGuide.
ForConsolidatedBackup,yourSANconfigurationmustmeetthefollowing
requirements:
!
TheVCBproxymusthaveaccessto:
!
AlltheSANarrayscontainingVMFSvolumes(datastores)withvirtualdisks
onthem
AlltheSANarrayscontainingvirtualcompatibilityRDMsthataresupposed
tobebackedupusingConsolidatedBackup
ForeveryLUNcontainingVMFSorRDMdata,theLUNIDontheproxyserver
mustmatchtheLUNIDasseenbytheESXServer.
NOTE
ThereisnosupportforEMCAX100managedwithNaviExpress.Usefull
NaviSphere.
IBMESSshouldbeexplicitlyconfiguredtohavetheconsistencyofLUNID
presentation.
Usually,theSANconfigurationonthestoragearrayinvolvesaddingtheVCBproxyto
allthehostgroupswheretheESXServersarelocated.
VMware, Inc.
19
Windowsarchivebitforincrementalbackups.Thearchivebitisanattributeofa
filethatsomebackupproductsusetodeterminewhetherthefileshouldbebacked
upornot.Configurethebackupclienttousetimestampsinstead.
Windowschangejournal.
Foreachsupportedthirdpartybackupsoftware,eitherthebackupsoftwarevendoror
VMwareprovidesanIntegrationModule.ThisisaZIPfilecontainingalltherequired
prebackupandpostbackupscripts.
TheZIPfilecontainsaREADME.htmlfilethatdescribeshowtousetheIntegration
Moduleontherespectivethirdpartybackupsoftware.Also,theREADME.htmlfile
outlineshowtoturnofftheWindowsarchivebitandchangejournalfunctionsinyour
thirdpartybackupsoftware,ifrequired.
VMFSvolume
/vmfs/volumes/<file_system_UUID> or /vmfs/volumes/<file_system_label>
VMFSfile
/vmfs/volumes/<file system label|file system UUID>/[dir]/myDisk.vmdk
20
VMware, Inc.
Hardware Requirements
TheVCBproxymustbeabletorunMicrosoftWindows2003.Inaddition,theproxy
requiresthefollowinghardwarecomponents:
!
Networkadapter(NIC)
FibreChannelhostbusadapter(HBA)
Prerequisites
TobeabletoinstallConsolidatedBackupontheVCBproxy,makesurethatthe
followingrequirementsaremet:
!
TheproxyisrunningMicrosoftWindows2003.ConsolidatedBackupdoesnt
supportanyotherversionsofWindowsontheproxy.
Networkingonthebackupproxyisconfiguredsothattheproxycanestablisha
connectiontoVirtualCenteroritsESXServerpeer.
IfthereisafirewallbetweenthebackupproxyandtheVirtualCenterorESXServer
peer,thefirewallmustpermitTCP/IPconnectionstoVirtualCenterortheESX
Serverpeer.Bydefault,VirtualCenterexpectsincomingconnectionsat
TCP/IPport902.
ThethirdpartybackupsoftwaretobeusedwithConsolidatedBackupisinstalled
andcorrectlyconfigured.
Verifytheconfigurationofthethirdpartybackupsoftwareatthistimebyrunning
abackupandrestorationjobonalocaldirectoryontheVCBproxy.
VMware, Inc.
21
DisablingAutomaticDriveLetterAssignmentonpage 22
ConfiguringtheConsolidatedBackupFrameworkonpage 23
InstallingaBackupSoftwareInteroperabilityModuleonpage 25
Ifyoudonotperformthisconfigurationstep,datacorruptionforvirtual
machinesusingRDMcanoccur.
ShutdowntheWindowsproxy.
DisconnecttheWindowsproxyfromtheSANormaskalltheLUNscontaining
VMFSvolumesorRDMforvirtualmachines.
Boottheproxyandlogintoanaccountwithadministratorprivileges.
Openacommandlineinterface.
Runthediskpartutilitybytyping:
diskpart
Thediskpartutilitystartsupandprintsitsowncommandprompt.
Disableautomaticdriveletterassignmenttonewlyseenvolumesbytypingatthe
diskpartcommandprompt:
automount disable
Cleanoutentriesofpreviouslymountedvolumesintheregistrybytypingatthe
diskpartcommandprompt:
automount scrub
22
VMware, Inc.
Exitthediskpartutilitybytyping:
exit
ShutdownWindows.
10
ReconnecttheWindowsproxytotheSAN,orunmaskallpreviouslymasked
LUNscontainingeitherVMFSvolumesorRDM.
11
Boottheproxy.
Logintothebackupproxyusinganaccountwithadministratorprivileges.
InstalltheConsolidatedBackupframeworkbyrunningsetup.exefromyourCD
ROMorelectronicdistribution.
Duringtheinstallation,pickaninstallationdirectoryforConsolidatedBackupor
acceptthedefaultone.
VMware, Inc.
23
Thefollowingtableprovidesanoverviewofalltheconfigurationsettingsinthisfile.
Table 2-1. Configuration Settings
Option
Default
Description
BACKUPROOT
C:\mnt
Directoryinwhichallthevirtualmachinebackupjobs
aresupposedtoreside.
Foreachbackupjob,adirectorywithauniquename
derivedfromthebackuptypeandthevirtualmachine
nameiscreatedhere.
Makesurethisdirectoryexistsbeforeattemptingany
virtualmachinebackups.
Forfullvirtualmachinebackups,thevolumecontain
ingthismountpointmustbelargeenoughtoholdthe
exporteddiskimagesofthelargestvirtualmachineto
behandled.
HOST
(no
default)
Hostname/portoftheVirtualCenterserverortheESX
ServerpeerusedbytheVCBproxy.
PORT
902
PortnumbertoconnecttoontheVirtualCenterorESX
Serverpeer.
USERNAME
(no
default)
UserIDtobeusedforloggingintotheVirtualCenter
hostorESXServerpeer.
PASSWORD
(no
default)
PasswordtobeusedforloggingintotheVirtualCenter
hostorESXServerpeer.
SNAPSHOT_POLICY
automatic
Validoptions:
automatic:TheConsolidatedBackupframeworkcre
atesanddeletesbackupsnapshotsforvirtualmachines
ondemand.Thisisthedefaultusedmostofthetime.
manual:TheConsolidatedBackupframeworkdoesnot
createordeleteanysnapshotsbutassumesthata
backupsnapshotnamed_VCB_BACKUP_alreadyexists
andusesthissnapshotforbackuppurposes.This
optionisusefulforcreativescripting.
createonly:TheConsolidatedBackupframework
createsabackupsnapshotwhentheprebackupscript
isbeingrun,butitdoesnotremovethesnapshotafter
backup.Thisoptionisusedifyouneedtorunaverifi
cationjob.Yourverificationscriptwouldthenbe
responsiblefortearingdownthemount.
deleteonly:TheConsolidatedBackupframework
assumesthatabackupsnapshotnamed
_VCB_BACKUP_alreadyexistsanddoesnotattemptto
createone.However,thesnapshotisdeletedbythe
postbackupscript.Thisoptionisusefulforcreative
scripting.
24
VMware, Inc.
Backupvirtualmachineswithdiskimagesstoredonastoragedevicethatthe
proxycannotaccess
BackupvirtualmachineswithvirtualdisksthatarephysicalcompatibilityRDMs
BackupvirtualmachinesthatdonothaveanInternetprotocol(IP)addressora
domainnameserver(DNS)nameassociatedwiththem
Performafilelevelbackupofvirtualmachinesrunningoperatingsystemsother
thanWindowsNT4.0,Windows2000,WindowsXP,WindowsXPProfessional,or
Windows2003
BackupvirtualmachinesthatresideonNAS/NFSoriSCSIstoragedevices
VMware, Inc.
25
Performafilelevelbackupsimultaneouslywithafullbackupforthesamevirtual
machine
CAUTION
RunningtwobackupjobsonthesameVCBproxy,onethatperforms
afullbackupforonevirtualmachinewhileanotherperformsafile
levelbackupforanothervirtualmachine,cantriggerafailureofone
oftheseoperations.Ifthishappens,restartthefailedoperation.
ConsolidatedBackupsupportsamaximumof60concurrentlymounted
virtualmachines.Forexample,youcanconcurrentlymount60virtual
machinesthathaveaC:drive,or30virtualmachinesthathaveaC:andaD:
each.
Afteryouhaveassociatedagroupofvirtualmachineswithonehostname,youcanset
upabackupjobforeachaliasusingthealiasastheclientnameforthejob.
Aliases
Youcansetupdifferentaliasesforagroupofvirtualmachines,allpointingtothesame
IPaddressoftheVCBproxy.Thisletsyouassociatedifferentpermissionswiththe
group.Forexample,restorepermissionsaretiedtothesealiases,determiningwhocan
restoreandwhichvirtualmachinescanberestoredfrom.
Ifyourdepartmentgrowsandyouaddanotherphysicalmachine,aliasesmakeiteasy
tomoveagrouptoadifferentproxy.Youcanaddnewproxiesasthedatacentergrows
andthenmovejobsforthegroupbypointingthealiastoanewproxy.
26
VMware, Inc.
Alljobsareassignedtotheproxy.
Alljobsarespecifiedbyoneofthefollowingdirectories:
filelevel:C:\mnt\mytestvm.foo.com\letters\D
imagelevel:C:\mnt\mytestvm.foo.com-fullVM
Eachjobisscheduledtorunatspecifictime.
NOTE
Ifyouplantorunmultiplebackupjobsonthesameproxyatthesame
time,rememberthatbackupproductsmighthavelimitationsona
numberofjobsyoucanruninparallel.
Formoredetailsonhowtoconfigurebackupjobsforvirtualmachines,refertothe
documentationprovidedwithyourthirdpartybackupsoftware.
First-Time Backup
Whenyouperformafirstbackupforaparticularvirtualmachine,thevirtualmachine
hastobepoweredon,orthebackupfailsonESXServer.
Afteryouhavecompletedthefirstbackupofthevirtualmachine,ConsolidatedBackup
canperformbackupsofthevirtualmachineregardlessofitspowerstateatbackup
time.
Advanced Configurations
Oncertainoccasions,youmightneedtoperformsomeadvancedconfigurationswhen
usingConsolidatedBackup.Forexample,youcanruncustomscripstocreatea
quiescentsnapshotofyourvirtualmachine.Also,youmightneedtorunapostbackup
commandforyourvirtualmachinestocancelbackupjobs.
VMware, Inc.
27
64bitguestoperatingsystems
AnyoperatingsystemotherthanWindows
Runningthescriptsinvolvesthefollowingsteps.
ForWindows:
C:\Windows\pre-freeze-script.bat
Forallotheroperatingsystems:
/usr/sbin/pre-freeze-script
Iftheprefreezescriptreturnsanonzeroexitcode,thesnapshotcreateoperationfails.
28
VMware, Inc.
ForWindows:
C:\Windows\post-thaw-script.bat
Forallotheroperatingsystems:
/usr/sbin/post-thaw-script
EventhoughVMwareToolsdoesnotcurrentlychecktheexitstatusofthisscript,it
shouldreturn0ifsuccessful.
Checkthefoldersinthe C:\mntdirectorytodeterminethevirtualmachinehost
names.
Foreachvirtualmachinehostname,runthefollowingcommand.Runthis
commandfromthegenericsubdirectoryintheConsolidatedBackupinstallation
directory.
VMware, Inc.
29
30
VMware, Inc.
Thischapterdescribeshowtorestoreyourdataorrecoverfromadisaster.Youneedto
findabalancebetweenthenumberofagentsthatyouwanttouseandtheeasewith
whichyoucanrestoreyourdata.
Thischapterincludesthefollowinginformation:
!
RestoringYourFilesUsingConsolidatedBackuponpage 32
RestoringFilesUsingthevcbRestoreUtilityonpage 33
DataRecoveryonpage 33
VMware, Inc.
31
Restore
Forinformationonrestoringworkflows,consultthedocumentationthatcomeswith
theintegrationmoduleforyourthirdpartybackupsoftware.
Ingeneral,threedifferentrestorationworkflowsaresupported:
!
Nobackupsoftwareinvirtualmachine.Restorationisdonebytheadministrator
onabackupproxynetworksharethatisaccessiblebytheprotectedvirtual
machine.
Backupsoftwareindedicatedvirtualmachinesanddatamovedtotargetvirtual
machines.
Backupsoftwaredeployedineveryprotectedvirtualmachine.Restorationisdone
directlybythesystemadministratorortheuser.
Centralized Restore
Whenperformingacentralizedrestore,youhaveagroupofvirtualmachinesonESX
Server,aproxy,andabackupagentontheproxyinadedicatedvirtualmachinethat
youareplanningtousetorestoreyourdata.Inthiscase,youusethebackupsoftware
togetthedatatotheproxythatisrunningtheagent.Aftertheadministratorrestores
thedatatothecentralserver,youcancopyitbacktothevirtualmachineusingthe
CommonInternetFileSystem(CIFS)remoteaccess,filesharingprotocol.
Pros:Thereareaminimumnumberofagentstomaintain.
Cons:Datarestorationisnowcentralized,andtheadministratorisinvolvedinfilelevel
restoration.
Per-Group Restore
Whenperformingapergrouprestoration,onevirtualmachinehasabackupagentfor
eachgroup,suchasaccounting,engineering,andmarketing.Thegroupadministrator
restoresworkflowstoapergrouprestorehost.Filesarecopiedtoatargetvirtual
machineusingCIFSfileshare.
Pros:
!
Restorationscanbedelegated.
Thisisagoodcompromisebetweenthenumberofagentsandeaseofrestoration.
Cons:Thisisnotacompleteselfservicerestoration.
32
VMware, Inc.
Self-Service Backup
Backupagentsaredeployedineveryvirtualmachine.Theusercanusetheagentto
backupdatatotapeandrestorethesameway.Thebackupagentinthevirtualmachine
isusedtorestorethedata.
Pros:Thisisselfservicerestoration.
Cons:Agentsarerequiredineachvirtualmachine.
Data Recovery
Thefollowingguidelinescanaidyouinrecoveringyourdata:
!
Makesureyouhavefullvirtualmachineimagebasedbackups.
BackupyourVirtualCenterDatabase.
Makesureyouhaveyourlicensekeys.
Makesureyouhaveenoughserverstorunallthevirtualmachinesyouplanto
restore.
EnablingmigrationwithVMotionorusingDRSgreatlyenhancesyourdisaster
recoverycapabilities.
Troubleshooting
InESX3.0,VMFSvolumesareidentifiedbyuniqueidentifiers.Thenameofthe
directoryunderwhicheachVMFSvolumeismountedin/vmfs/volumescorresponds
tothisuniqueidentifier.Theuniqueidentifierisassignedtothevolumeautomatically
duringformatting,andyoucannotchangeit.
VMware, Inc.
33
VMFSvolumescanhaveuserfriendlylabels.Theselabelsshowupassymboliclinks
in/vmfs/volumesthatpointtothecorrespondingdirectory.Forexample,foraVMFS
volumewiththeuniqueidentifier43a0552e-ae6093b2-47a1-00145e0a7ec0andthe
labelstorage1,thefollowingentriesarecreatedunder/vmfs/volumes:
!
Adirectorynamed43a0552e-ae6093b2-47a1-00145e0a7ec0,underwhichthefile
systemismounted
Asymboliclinknamedstorage1,pointingtothedirectory43a0552e-ae6093b247a1-00145e0a7ec0
Graphicaluserinterfaces(GUIs)forbackupsoftwarethatallowyoutoselectfilesfor
backupshowonlythedirectory(theuniqueID)intheirBrowseDirectorypane.
To identify a VMFS volume by its label
1
Browsethe/vmfs/volumesdirectoryinyourbackupsoftwareGUI.
ThesymboliclinkspointingtotheVMFSvolumemountpointsshowupinthefile
selectionpane.
UsetheseentriestofindtheuniqueIDforthefilesystemlabelyouneed.
SelectthedirectorycorrespondingtothisuniqueIDinthedirectorypanefor
browsing.
Whenperformingfilebasedbackups,thebackupapplicationusespathsreferencing
theuniqueidentifier,sothebackedupfilesshowupasthefollowing:
/vmfs/volumes/43a0552e-ae6093b2-47a1-00145e0a7ec0/vm01/vm01.vmdk
Whenrestoringfilesfromthebackupapplication,youmightneedtoperformareverse
mappingtoidentifythecorrectVMFSvolumelabel(inthisexample,storage1)
correspondingtothisuniqueidentifier.Tobeabletodothis,considerbackingupthe
symboliclinkitselfwhileperformingbackups.
34
VMware, Inc.
C HAPTER 4
Backup Scenarios
Thischapterdescribesrealworldscenariosthatcanhelpyouplanyourbackup
strategies.
Thischapterincludesthefollowinginformation:
!
BackupUsageScenariosonpage 36
ATypicalConsolidatedBackupUsageScenarioonpage 36
VMware, Inc.
35
DatacenterConsolidatedBackupatthefilelevelperformedeverynight.
DatacenterConsolidatedBackupattheimagelevelperformedperiodicallyfor
WindowsornightlyforLinux.Thisisadisasterrecoveryscenario.
AgentsinvirtualmachinesIncrementalbackupforLinux.
BackupserverinavirtualmachineForbranchoffices,agentsinthevirtual
machineaswell.
Thesystemadministratorconfiguresbackupschedulesandpoliciesinthethird
partybackupsoftware.
Forexample,thesystemadministratormightinstructthebackupsoftwaretoback
upD:\Data on vm37.company.comdailyat3:05a.m.
36
Thebackupsoftwareschedulesthisbackupjobautomatically.
Whenthebackupsoftwarelaunchesthisjob,itcallsintotheConsolidatedBackup
frameworkbyusingaprebackupscript.ConsolidatedBackupperformsthe
following:
a
ContactsaVirtualCenterinstanceoranESXServerpeer,andrequestsitto
createasnapshotofthevirtualmachinetobebackedup.
Makesthissnapshotavailable(mounted)onthebackupproxy.Thismakesthe
datathatneedstobebackedupvisibletothethirdpartybackupsoftware.
Thethirdpartybackupsoftwareperformsthebackupprocedureofcopying
changeddatatothebackupmedia.
Attheendofthebackupjob,thethirdpartybackupsoftwarecallsintothe
ConsolidatedBackupframework,usingapostbackupscriptinwhich
ConsolidatedBackupdoesthefollowing:
a
Detaches(unmounts)thesnapshotfromthebackupproxy.
AsksVirtualCenteroritsESXServerpeertoremovethevirtualmachine
snapshot.
VMware, Inc.
Thisappendixdescribeshowtobackupandrestorevirtualmachinesusingtheservice
console.TheappendixwalksyouthroughtheprocessofconfiguringtheConsolidated
Backupcommandlineutilitiesandprovidesexamplesonhowtousetheseutilities.
Thisappendixincludesthefollowingsections:
!
GeneralConfigurationSettingsforConsolidatedBackupUtilitiesonpage 38
BackingUpVirtualMachinesonpage 40
RestoringVirtualMachinesonpage 44
VMware, Inc.
37
Usethe#charactertoindicateacomment.
Donotusespaceswhenenteringvariables.Forexample,FOO="bar"shouldhave
nospacesaroundtheequalssign.
Useabackslashbeforeenteringanyspecialcharacters,suchas$.Forexample,
\$erver.
AdministratorsfamiliarwithBourneshellscriptprogrammingcanuseallthestandard
Bourneshellmechanisms,suchascommandexecution,forexample`foo`,oruse
environmentvariables.
Youcanusethe-hcommandlineoptionforanyConsolidatedBackup
commandlineutilitytooverridethissetting.
USERNAME
SpecifiestheusernametologintotheVirtualCenterinstancedefinedbyVCHOST.
Theusermusthaveprivilegestobeabletoregisterorcreatevirtualmachines.
NOTE
38
Youcanusethe-ucommandlineoptionforanyConsolidatedBackup
commandlineutilitytooverridethissetting.
VMware, Inc.
PASSWORD
SpecifiesthepasswordcorrespondingtoUSERNAME.Thisoptionallowsyouto
performvirtualmachinebackupsinanoninteractiveway.
NOTE
Becausespecifyingapasswordinaconfigurationfilecanpresenta
securityrisk,makesurethattheServiceConsoleisnotusedbyanyone
exceptanESXServeradministrator.
NOTE
Youcanusethe-pcommandlineoptionforanyConsolidatedBackup
commandlineutilitytooverridethissetting.
VMNAMECACHE
Themostcommonwayofidentifyingavirtualmachineforbackuppurposesisby
itsDNSnameorbyitsIPaddress.However,whenyoubackupavirtualmachine
fromastandaloneESXServerhost,theESXServerhostcanrecognizetheIP
addressonlywhenthevirtualmachineispoweredonandrunningVMwareTools.
TobeabletoperformbackupsofthevirtualmachineonthestandaloneESXServer
hostevenwhenthevirtualmachineispoweredoff,youshouldmaintainacache
file.ThecachefilerecordstheIPaddressofthevirtualmachineeachtimethe
virtualmachineisbeingbackedup.Thisallowsyoutoperformthefuturebackups
ofthisvirtualmachineregardlessofitspowerstate.
VMwarerecommendsthatyoudonotchangethedefaultsetting.
NOTE
Youcanusethe-ccommandlineoptionforvcbMountertooverridethis
setting.ThevcbRestorecommanddoesnotusethissetting.
TEMPDIR
IfyouareusingthesecurecopycapabilitiesoftheConsolidatedBackup
commandlineutilities,youcanusethisoptiontospecifyatemporaryholding
spaceforyourvirtualmachinedata.
Thisholdingspacemusthaveenoughfreestoragetoholdthelargestofyour
virtualmachines.
NOTE
VMware, Inc.
Thissettingcannotbeoverriddenfromthecommandline.
39
Whichvirtualmachinetobackup.
Forinformationonidentifyingvirtualmachines,seeIdentifyingVirtual
Machinesonpage 41.
Wheretostorethebackupdata.
ConsolidatedBackupserviceconsolesupportsdifferenttransportpluginsto
eitherbackupthevirtualmachinetoalocaldirectoryorbackituptoaremote
directoryusingscp.Formoreinformation,seeSpecifyingBackupDestinations
onpage 43.
Performing Backups
AftersettingupconfigurationoptionsasdescribedinConfigurationFileSettingson
page 38,enterthefollowingcommandinthecommandline:
vcbMounter -a <virtual_machine_identifier> -r <backup_destination>,
where
!
<virtual_machine_identifier>isauniqueidentifierofthevirtualmachineyoure
backingup.Forinformationonidentifyingvirtualmachines,seeIdentifying
VirtualMachinesonpage 41.
<backup_destination>specifiesthelocationforbackupdata.Forinformationon
howtospecifyabackupdestination,seeSpecifyingBackupDestinationson
page 43.
NOTE
Whenbackingupagroupofvirtualmachines,usethevcbSnapAllcommand
insteadofvcbMounter.Forinformationonhowtoidentifythegroupyou
wanttobackup,seeIdentifyingGroupsofVirtualMachinesonpage 42.
Followtheseexampleswhenbackingupvirtualmachines:
!
Backingupthevirtualmachinevm37.company.comtothelocaldirectory/home/
VMs/vm37:
vcbMounter -a ipaddr:vm37.company.com -r /home/VMs/vm37
40
VMware, Inc.
Backingupthevirtualmachinevm37.company.comtothedirectory/backups/VMs/
vm37.Thedirectoryislocatedontheremoteserverbackups.company.comwiththe
userIDvmware. Thebackups.company.comhostisrunningasecureshell(ssh)
server.YoucanuseConsolidatedBackupssecurecopy(scp)plugintotransferthe
virtualmachinetobackups.company.com.
BackingupavirtualmachineonastandaloneESXServerhost.Toidentifythe
virtualmachine,usethevirtualmachinesnamedisplayedintheVIClient.The
virtualmachineisbackeduptothelocaldirectory/home/VMs/vm37.
vcbMounter -a name:"Virtual Machine 37" -r /home/VMs/vm37
NOTE
Thevirtualmachinenameargumentiscasesensitive.
ipaddr:vm37.company.com
ipaddr:10.17.5.12
VMware, Inc.
41
moref:vm-00027UsethisformatwhenaccessingVirtualCenterServer.
moref:248UsethisformatwhenaccessingtheESXServerhost.
BecauseMoRefschangeeverytimetheVirtualCenterserverorthehostinstancethat
ConsolidatedBackupconnectstogetsrestarted,youshouldnotuseMoRefstoidentify
virtualmachines.However,whenrunningashellscripttobackvirtualmachines,you
canuseMoRefstoidentifythevirtualmachines.
Forexample,youcanwriteascriptthatusesvcbVmNamewiththeany:searchspecifier
togetalistofallvirtualmachinesfirst,andthenperformscustomfilteringtoproduce
alistofonlythosevirtualmachinesyouwanttobackup.Virtualmachinesonthislist
canuseMoRefsastheiridentifiers.AnotherpartofyourscriptcanthencallvcbMounter
oneachoftheseMoRefstoperformthebackupoperations.
Inacaselikethis,usingMoRefsratherthanotheridentifiers,suchasUUID,causesless
searchoverheadbecausetheentirelistofallvirtualmachinesdoesntneedtobeparsed
eachtimetheidentifierisused.
powerstate:on|off|suspendedFindsallvirtualmachineswiththespecified
powerstate.
any:Findsallvirtualmachines.
none:Doesntfindanyvirtualmachines.Youcanusethisoptionfortesting
purposes.
42
vcbVmName -s powerstate:onListsallpoweredonvirtualmachines.
vcbVmName -s any:Listsallknownvirtualmachines.
vcbVmName -s ipaddr:vm37.company.comDisplaysinformationaboutthevirtual
machinewiththespecifiedaddress.
VMware, Inc.
ThefollowingisthesampleoutputyougetafterusingvcbVmName:
bash #vcbVmName -s name:vm37.company.com Found VM:
moref:192
name:Virtual Machine 37
uuid:564d78a1-8c1c-59b4-fa02-be14138797be
ipaddr:10.17.5.31
/home/VMs/vm37
file://home/VMs/vm37
NOTE
Youdontneedtocreatethedestinationsubdirectory,suchas/home/VMs/
vm37, inadvancebecausethebackupoperationwillcreateit.However,the
directorythatlistsyourdestinationsubdirectory,forexample/home/VMs,
mustexistbeforeyoustartabackupprocess.
VMware, Inc.
43
Forexample,youneedtobackupavirtualmachinetothedirectory/backup/VMs/vm37
locatedontheremoteserverbackups.company.comthatusesthevmwareuserID.Enter
thefollowing:
scp://vmware@backups.company.com:/backups/VMs/vm37
NOTE
Priortobackup,makesurethatthe/backups/VMsdirectoryalreadyexistson
theremoteserver.However,youdonotneedtocreatethe/backups/VMs/vm37
directorybecauseitwillbecreatedduringthebackupoperation.
Restoringavirtualmachinefromalocalbackupdirectorynamed/home/VMs/vm37:
vcbRestore -s /home/VMs/vm37
Restoringavirtualmachinefromtheremoteserverbackup.company.com,directory
/backups/VMs/vm37,anduserIDvmware:
vcbRestore -s scp://vmware@backup.company.com:/backups/VMs/vm37
44
VMware, Inc.
Makeacopyofthevirtualmachinescatalogfile.
SeeCopyingaCatalogFileonpage 45.
Inthecopyofthecatalogfile,specifythenewsettingsfordatastores,folderpath,
andresourcepool.
SeeEditingaCatalogFileonpage 45.
RestorethevirtualmachineusingvcbRestore.
SeeRestoringVirtualMachinesUsinganAlternateCatalogonpage 47
DatastoreThedatastoreidentifieswheretostoreallthefilesthatcomprisea
virtualmachine.
FolderpathThevirtualmachinesfolderpathdefineswherethevirtualmachine
willbeplacedintheVirtualCenterfolderhierarchy.
ResourcepoolThishostspecificconfigurationitemdeterminesthevirtual
machinesbehaviorwithrespecttoDRS(DistributedResourceScheduling).When
youusemultipleESXServersmanagedbyVirtualCenter,thisitemalsospecifies
thehostthatwillrunthevirtualmachine.
NOTE
Ifyouchangethenameofthevirtualmachineinthecatalogfile,vcbRestore
doesntpickupthenewnamefromthefile,butinsteadusestheoriginal
virtualmachinenamespecifiedinthe.vmxfile.
YoucanchangethenameofthevirtualmachinelaterusingtheVIClient.
VMware, Inc.
45
disk.scsi*.disknameNamesandlocationsofalldisksassociatedwiththis
virtualmachine.
config.vmxLocationforthevirtualmachinesmainconfigurationfile.
config.suspenddirLocationforthememorysnapshotstakenwhenthevirtual
machinegetssuspended.
config.logdirLocationforthevirtualmachineslogfiles.
Bydefault,alltheseentriesusethesamepath,whichpointstothesamedirectoryon
thesamedatastore.Itishighlyrecommendedthatyoufollowthisstandardwhen
changingthepath.
Thedatastorepathshavethefollowingsyntax:
[<datastore_name>] <path_on_datastore>
Youcanobtainalistofvaliddatastorenamesfromthedatastorebrowserinyour
VirtualCenterclient,orbylookingatthefilesystemlabelsofyourVMFSvolumesin
theserviceconsoleunder/vmfs/volumes.
Changing Folder Paths
Thevirtualmachinesfolderpathinthecatalogfilespecifiesthefolderwithinthe
VirtualCenterfolderhierarchywheretherestoredvirtualmachinewillbeplaced.
To change the folder path for the virtual machine
1
Identifythefolder,whichwillstorethevirtualmachine,byrunningthefollowing
commandintheserviceconsole:
vcbUtil -c vmfolders
Runningthiscommandassumesthatyouhavesetupappropriateconfiguration
optionsasdescribedinConfigurationFileSettingsonpage 38.
46
Inthecatalogfile,setthefolderpathtooneofthefolderpathsprintedoutbythe
commandabove.
VMware, Inc.
Identifytheresourcepool,whichthevirtualmachinewilluse,byrunningthe
followingcommand:
vcbUtil -c resourcepools
Runningthiscommandassumesthatyouhavesetupappropriateconfiguration
optionsasdescribedinConfigurationFileSettingsonpage 38.
Inthecatalogfile,settheresourcepooltooneoftheoptionsprovidedbythe
commandabove.
VMware, Inc.
47
48
VMware, Inc.
Thisappendixdescribeshowtorestorevirtualmachines,whichwerecreatedand
backeduponESXServer2.5.x,inESXServer3.0usingtheserviceconsole.
Thisappendixincludesthefollowingsections:
!
SettingConfigurationParametersonpage 50
RestoringESX2.5.xServerVirtualMachinesonpage 51
VMware, Inc.
49
Makesuretoselectavalidresourcepoolonthehostyouspecifiedin
VMHOST.Typically,theresourcepoolnamecontainsthenameofthe
correspondingESXServerhost.Youcanalsousethe%VMHOST%entry,
whichwillbereplacedbythevalueyouassignedtoVMHOST.
FOLDERPATH
SpecifiesthefolderwithintheVirtualCenterhierarchy,inwhichtherestored
virtualmachinewillbeplaced.Formoreinformationonthisparameter,see
ChangingFolderPathsonpage 46.
50
VMware, Inc.
Appendix B Restoring Virtual Machines from ESX Server 2.5.x to ESX Server 3.0
VMware, Inc.
51
52
VMware, Inc.
Index
archive bit 20
physical compatibility 4
physical SCSI disks 3
B
backup destinations 43
BIOS UUID 41
catalog files 45
change journal 20
configuration file 38
configuration files, exporting 18
User groups ix
utilities 38
D
directory, /vmfs/volumes 4
disk images, exporting 18
DNS name 41
V
VCB utilities 38
virtual compatibility 4
virtual-to-physical clustering 4
VMFS 3
vmkfstools command 5
VMware community forums ix
F
file allocation table 22
I
IP address 41
K
Knowledge base ix
M
metadata 4
MoRef 42
N
new technology file system 22
VMware, Inc.
53
54
VMware, Inc.