identifieswinmgmt

IBMSpectrumProtectforVirtualEnvironmentsVersion8.
1.
2DataProtectionforMicrosoftHyper-VInstallationandUser'sGuideIBMIBMSpectrumProtectforVirtualEnvironmentsVersion8.
1.
2DataProtectionforMicrosoftHyper-VInstallationandUser'sGuideIBMNote:Beforeyouusethisinformationandtheproductitsupports,readtheinformationin"Notices"onpage105.
Thiseditionappliestoversion8,release1,modification2ofIBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-V(productnumber5725-X00)andtoallsubsequentreleasesandmodificationsuntilotherwiseindicatedinneweditions.
CopyrightIBMCorporation2011,2017.
USGovernmentUsersRestrictedRights–Use,duplicationordisclosurerestrictedbyGSAADPScheduleContractwithIBMCorp.
ContentsAboutthispublicationvWhoshouldreadthispublicationvPublicationsvWhat'snewinVersion8.
1.
2.
viiChapter1.
ProtectionforMicrosoftHyper-Vvirtualmachines1BackupHyper-Vvirtualmachines1VirtualmachinebackupswithVolumeShadowCopyService(VSS)2Virtualmachinebackupswithresilientchangetracking(RCT)2MigratingfromVSSbackupstoRCTbackups.
.
4RestoreHyper-Vvirtualmachines5Policymanagementatthevirtualmachinelevel.
.
6UserinterfacesforHyper-Voperations6Incrementalforeverbackupstrategy8SnapshotmanagementwithWindowsPowerShell9LimitationsonHyper-Vbackupoperations.
.
.
.
9Documentationresources10Chapter2.
InstallingDataProtectionforMicrosoftHyper-V13Determinesystemrequirements13DataProtectionforMicrosoftHyper-Vupgradeconsiderations13Determinewhichfeaturestoinstall14InstallDataProtectionforMicrosoftHyper-Vfeatureswithdefaultsettings14Installthebackup-archiveclient(datamover).
.
15InstalltheIBMSpectrumProtectrecoveryagent16Installinginsilentmode18UninstallingDataProtectionforMicrosoftHyper-V19UninstallingDataProtectionforMicrosoftHyper-VwiththeMicrosoftWindowsInstallerTool.
.
.
.
19Chapter3.
ConfiguringDataProtectionforMicrosoftHyper-V21Creatingandmodifyingtheclientoptionsfile.
.
.
21ConfiguringDataProtectionforMicrosoftHyper-Vinaclusterenvironment23ConfiguringtheIBMSpectrumProtectrecoveryagentGUI25EnablingsecurecommunicationfromtherecoveryagenttotheIBMSpectrumProtectserver29ManuallyconfiguringaniSCSIdevice32Chapter4.
TuningscheduledVMbackupsforWindowsServer2012and2012R2clusters35Chapter5.
Commandreference.
.
.
.
37Readingsyntaxdiagrams37BackupVM39Expire47QueryVM48RestoreVM52Chapter6.
Optionsreference55Dateformat55Detail57Domain.
vmfull57Exclude.
vmdisk60Filelist62Inactive63Include.
vm64Include.
vmdisk65INCLUDE.
VMSNAPSHOTATTEMPTS67Mode68Mbobjrefreshthresh69Mbpctrefreshthresh70Noprompt71Numberformat71Pick73Pitdate.
73Pittime.
74Skipsystemexclude74Timeformat75Vmbackdir76Vmctlmc.
77Vmmaxparallel78Vmmaxpersnapshot79Vmmaxsnapshotretry81Vmmc82Vmprocessvmwithphysdisks83Vmskipphysdisks.
84Chapter7.
Mountandfilerestore.
.
.
85IBMSpectrumProtectrecoveryagentconfigurations85Snapshotmountoverview86Mountguidelines87Filerestoreoverview87Filerestoreguidelines89Restoringoneormorefiles89Chapter8.
IBMSpectrumProtectrecoveryagentcommands93Mount93Set_connection96Help97Recoveryagentcommand-lineinterfacereturncodes98CopyrightIBMCorp.
2011,2017iii|||||||||||||||||||||||||||||AppendixA.
Troubleshooting.
.
.
.
101AppendixB.
AccessibilityfeaturesfortheIBMSpectrumProtectproductfamily.
103Notices105Glossary109Index111ivIBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuide||AboutthispublicationThispublicationprovidesoverview,planning,anduserinstructionsforIBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-V.
WhoshouldreadthispublicationThispublicationisintendedforadministratorsanduserswhoareresponsibleforimplementingabackupsolutionwithIBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-Vinoneofthesupportedenvironments.
Inthispublication,itisassumedthatyouhaveanunderstandingofthefollowingapplications:vMicrosoftWindowsServer2016withtheHyper-VroleinstalledvMicrosoftWindowsServer2012or2012R2withtheHyper-VroleinstalledvTheIBMSpectrumProtectbackup-archiveclientvTheIBMSpectrumProtectserverPublicationsTheIBMSpectrumProtectproductfamilyincludesIBMSpectrumProtectSnapshot,IBMSpectrumProtectforSpaceManagement,IBMSpectrumProtectforDatabases,andseveralotherstoragemanagementproductsfromIBM.
ToviewIBMproductdocumentation,seeIBMKnowledgeCenter.
CopyrightIBMCorp.
2011,2017v|viIBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuideWhat'snewinVersion8.
1.
2DataProtectionforMicrosoftHyper-VVersion8.
1.
2introducesnewfeaturesandupdates.
ForalistofnewfeaturesandupdatesinthisreleaseandpreviousVersion8.
1releases,seeDataProtectionforMicrosoftHyper-Vupdates.
Newandchangedinformationinthisproductdocumentationisindicatedbyaverticalbar(|)totheleftofthechange.
EnhancedsupportforDataProtectionforMicrosoftHyper-VrunningonWindowsServer2016Backupvirtualmachinesbyusingresilientchangetracking(RCT)Toimprovethescalabilityandperformanceofvirtualmachine(VM)backups,resilientchangetracking(RCT)isusedforallVMbackupoperationsofHyper-VhoststhatrunontheMicrosoftWindowsServer2016operatingsystem.
Formoreinformation,see"Virtualmachinebackupswithresilientchangetracking(RCT)"onpage2.
ExercisemorecontroloverbackupoperationsonVMswithphysicaldisksYoucancontrolwhetherfullHyper-VRCTVMbackupsareprocessediftheVMhasoneormorephysicaldisks(pass-throughdisks)provisioned.
Formoreinformation,seethefollowingoptions:v"Vmprocessvmwithphysdisks"onpage83v"Vmskipphysdisks"onpage84SpecifythenumberofsnapshotattemptsandthelevelofdataconsistencyforbackupoperationsTodeterminethetotalnumberofsnapshotattemptstotryforavirtualmachinethatfailsduringbackupprocessingduetosnapshotfailure,usetheINCLUDE.
VMSNAPSHOTATTEMPTSoption.
Youcanchoosetoattemptapplication-consistentorcrash-consistentsnapshots.
Formoreinformation,see"INCLUDE.
VMSNAPSHOTATTEMPTS"onpage67.
ExcludeVMdisksfromorincludeVMdisksinbackupoperationsYoucanusetheexclude.
vmdiskoptiontoexcludeaVMdisk(VHDX)fromVMbackupoperationsorusetheinclude.
vmdiskoptiontoincludeaVMdiskinVMbackupoperations.
Formoreinformation,seethefollowingtopics:v"Exclude.
vmdisk"onpage60v"Include.
vmdisk"onpage65v"Domain.
vmfull"onpage57v"BackupVM"onpage39EnhancedsupportforDataProtectionforMicrosoftHyper-VrunningonWindowsServer2012and2012R2CopyrightIBMCorp.
2011,2017viiScalabilityandreliabilityofVMbackupsareimprovedVMsarelogicallygroupedintoasinglesnapshottoreduceoreliminatesnapshotconflictsattheHyper-Vhostlevel.
Improvedsnapshotretryprocessingsimplifiesschedulingandimprovesreliabilityacrossclusternodes.
vTocontrolthenumberofVMstoincludeinasnapshot,usethevmmaxpersnapshotoption.
Formoreinformation,seeVmmaxpersnapshot.
vTocontrolhowmanysnapshotretriesareattempted,usethevmmaxsnapshotretryoption.
Formoreinformation,see"Vmmaxsnapshotretry"onpage81.
Usethesegroupingandretryimprovementsalongwiththevmmaxparalleloptiontohelpimproveperformance.
Forinformation,see:Chapter4,"TuningscheduledVMbackupsforWindowsServer2012and2012R2clusters,"onpage35viiiIBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuideChapter1.
ProtectionforMicrosoftHyper-VvirtualmachinesIBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-Visalicensedproductthatprovidesstoragemanagementservicesforvirtualmachines(VMs)inaMicrosoftHyper-Venvironment.
DataProtectionforMicrosoftHyper-VworkswiththeIBMSpectrumProtectbackup-archiveclienttoprotectHyper-Vvirtualmachinesonthefollowingoperatingsystems:vMicrosoftWindowsServer2012vMicrosoftWindowsServer2012R2vMicrosoftWindowsServer2016BackupHyper-VvirtualmachinesDataProtectionforMicrosoftHyper-Vcreatesanincremental-foreverfullorincremental-foreverincrementalbackupofHyper-Vvirtualmachines(VMs).
AconsistentsnapshotistakenoftheVM,andtheVMisbackeduptotheIBMSpectrumProtectserver.
YoucanbackupHyper-VVMsthatexistonalocaldisk,aSAN-attacheddisk,orClusterSharedVolume(CSV).
Forexample,youcanbackupVMsthatarestoredonCSVsinaHyper-VclusterenvironmentoronServerMessageBlock(SMB)filesharesthatareonaremotesystem.
YoucanbackupanyguestoperatingsystemsthataresupportedbytheHyper-Vserveronremoteshares,regardlessofwhetherIBMSpectrumProtectsupportsthemdirectly.
ThefollowingbackuptypesaresupportedforMicrosoftHyper-VVMswithvirtualdisksthatusetheVHDXdiskformat:Incremental-foreverfullbackupCreatesabackupofsnapshotdiskdatatotheIBMSpectrumProtectserver.
Incremental-foreverincrementalbackupCreatesasnapshotoftheblocksthatchangedsincethelastincremental-foreverfullbackuporincremental-foreverincrementalbackup.
IfyouarerunningtheHyper-VhostontheWindowsServer2012orWindowsServer2012R2operatingsystem,MicrosoftVolumeShadowCopyService(VSS)isusedtocreateaconsistentsnapshotoftheVM.
ChangesthatoccurintheVMbetweeneachbackuparetrackedinasnapshotdifferencingfile.
IfyouarerunningtheHyper-VhostonaWindowsServer2016orlateroperatingsystem,snapshotsarecreatedbytheWindowsAPI,andresilientchangetracking(RCT)isusedtotrackchangesinaVHDXdiskbetweeneachbackupoperation.
CopyrightIBMCorp.
2011,20171||||VirtualmachinebackupswithVolumeShadowCopyService(VSS)ForHyper-VbackupsonWindowsServer2012and2012R2,MicrosoftVolumeShadowCopyService(VSS)isusedtocreateconsistentsnapshotsofvirtualmachines(VMs)duringbackupoperations.
Duringaninitialincremental-foreverfullbackupoperation,theclientcreatesasnapshotofthevirtualmachineharddisk(VHDX)andsendsthecontenttotheIBMSpectrumProtectserver.
Changesthatoccuraftertheinitialsnapshotarestoredinasnapshotdifferencingfile(.
avhdx).
Subsequentincremental-foreverincrementalbackupoperationsbackuponlythedatathatwaschangedsincethelastbackup.
Ifyourunanincremental-foreverincrementalbackupbeforeyoucreateanincremental-foreverfullbackup,theclientwillrunanincremental-foreverfullbackup.
HowsnapshotsworkwithVSSbackupsDuringeachVMbackup,anewsnapshotdifferencingfile(.
avhdx)iscreatedtotrackthechangestotheVMthatoccurafterthebackupoperation.
ThisdifferencingsnapshotissavedontheHyper-Vhosttocollectthewritesforthenextincrementalbackup.
InpreviousreleasesofDataProtectionforMicrosoftHyper-V,asnapshotcouldcontainonlyoneVM.
Thisbehaviorcouldcauseschedulingcontentionduringclusterbackupoperationsbecausetoomanysnapshotshadtobetaken.
ByusingthevmmaxpersnapshotoptioninDataProtectionforMicrosoftHyper-VVersion8.
1.
2,youcanreducethenumberofsnapshotsthataretakenforabackupoperationbygroupingseveralVMsinasinglesnapshot.
Formoreinformation,seeChapter4,"TuningscheduledVMbackupsforWindowsServer2012and2012R2clusters,"onpage35.
Virtualmachinebackupswithresilientchangetracking(RCT)ForHyper-VbackupsonMicrosoftWindowsServer2016orlaterversions,theresilientchangetracking(RCT)featureisusedtobackupvirtualmachines(VMs).
RCTisafeaturethatprovidesbuilt-inchangeblocktrackingcapabilityforHyper-VVMdisks.
DataProtectionforMicrosoftHyper-VusesRCTtotrackchangestoaVMdisk(VHDX)thatoccurinbetweenbackupoperations.
Thechangesaretrackedatthedatablocklevel.
Onlyblocksthathavechangedsincethelastbackupoperationarecandidatesforthenextincremental-foreverincrementalbackup.
WindowsServer2016alsoprovidesthecapabilitytocreatebackupsnapshots(alsoknownascheckpoints)directlywithoutusingMicrosoftVolumeShadowCopyService(VSS)(althoughVSSisstillusedinsideWindowsguestVMstoquiescetheVMsforapplication-consistentbackups).
VMbackupoperationswithRCTrequiretheHyper-VVMtobeVersion6.
2orlater.
IfyourVMwascreatedontheWindowsServer2012R2orearlieroperatingsystem,andthenlatermovedtoaWindowsServer2016hostserver(orthehostserverwasupgradedtoWindowsServer2016),youmusttaketheVMofflineand2IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuide|||||||||||||||||||||||||||||||||||||||||||||upgradetheVMversionbeforeitcanbebackedup.
YoucanupgradetheVMVersionbyusingtheHyper-VManagerortheUpdate-VMVersioncmdlet.
DataProtectionforMicrosoftHyper-VV8.
1.
0usesVSStobackupVMsintheHyper-VenvironmentonWindowsServer2016.
StartinginV8.
1.
2,allHyper-VVMbackupoperationsintheWindowsServer2016orlaterenvironmentusesRCT.
BecausepreviousVSSbackupsdonothaveRCTchange-trackinginformation,thefirsttimeyouuseDataProtectionforMicrosoftHyper-VV8.
1.
2tobackupyourVMsonWindowsServer2016,anincremental-foreverfullbackupiscreated.
AfteryoubackedupaVMusingRCT,youcannolongeruseDataProtectionforMicrosoftHyper-VV8.
1.
0torunVSSbackupsonthatVM.
HowsnapshotsworkwithRCTbackupsDuringanincremental-foreverfullbackupoperationforaVM,asnapshotiscreatedoftheVMdiskandthesnapshotcontentsarebackeduptotheIBMSpectrumProtectserver.
Thesnapshotisdeletedautomaticallyafterthebackupoperationiscompleted.
Duringthenextincremental-foreverincrementalbackup,anewsnapshotiscreatedandverifiedagainsttheRCTchange-trackinginformationfromthepreviousbackupoperationtodeterminethedatathathaschanged.
OnlythechangedblocksarebackeduptotheIBMSpectrumProtectserver.
Afterthebackupoperation,thesnapshotismergedwiththeVMbyHyper-V,andthesnapshotdifferencingfile(.
avhdx)isdeletedautomatically.
ThisprocessisunliketheVSSsnapshotprocessingonWindowsServer2012and2012R2operatingsystems,inwhichthesnapshotdifferencingfileisretainedontheVMtostoreincrementalchanges.
AnysnapshotthatyoucreatemanuallyorwithanotherbackupproductdonotaffectthebackupchainthatiscreatedbytheRCTprocess.
Youcancreatesnapshotsmanuallyorwithathird-partybackupproductbeforeorafteraDataProtectionforMicrosoftHyper-VRCTbackupoperation,andthenextincrementalbackupoperationbyDataProtectionforMicrosoftHyper-VwillbebasedontheRCTchange-trackinginformationfromthepreviousbackupoperation.
FeaturesthatareavailableforRCTbackupsMostDataProtectionforMicrosoftHyper-VfeaturesthatworkonWindowsServer2012and2012R2alsoapplytoWindowsServer2016.
ProceduresforbackingupandrestoringVMbackupsarethesameinDataProtectionforMicrosoftHyper-VV8.
1.
2andpreviousversionsofDataProtectionforMicrosoftHyper-V.
However,snapshotoperationsaredifferentforRCTbackupsinV8.
1.
2becauseoftheavailabilityofRCT.
Formoreinformation,see"HowsnapshotsworkwithRCTbackups.
"SupportforhostfailoverwithClusterSharedVolumes(CSVs)isunchangedfromV8.
1.
0andearlier,butrunningaVMbackupduringarollingupgradeofaHyper-Vclusteroperatingsystemisnotsupported.
InadditiontothefeaturesthatareavailablewithVSS,thefollowingfeaturesalsoapplytoRCTbackupoperationsonWindowsServer2016.
Chapter1.
ProtectionforMicrosoftHyper-Vvirtualmachines3|||||||||||||||||||||||||||||||||||||||||||Table1.
FeaturesavailableonlyforRCTbackupoperationsFeatureMoreinformationControlbackupoperationsforVMswithphysicaldisks(pass-throughdisks).
v"Vmprocessvmwithphysdisks"onpage83v"Vmskipphysdisks"onpage84Choosethelevelofdataconsistencytoachieveduringbackupoperationsbyspecifyingthenumberofsnapshotattempts.
"INCLUDE.
VMSNAPSHOTATTEMPTS"onpage67SpecifywhetherVMdisks(VHDX)areincludedinorexcludedfromRCTbackupoperations.
v"Exclude.
vmdisk"onpage60v"Include.
vmdisk"onpage65v"Domain.
vmfull"onpage57v"BackupVM"onpage39HowtoqueryRCTbackupsYoucanusethequeryVMcommandtodisplayinformationaboutaVMthatwasbackeduptotheIBMSpectrumProtectserver.
Usethe-detailparameterwiththequeryvmcommandtoshowdetailedinformationaboutthebackupoperation.
Formoreinformation,see"QueryVM"onpage48.
Youcanalsousethebackupvm-previewcommandtodisplaytheVMdisklocationsthatcanbeusedforthebackupvmcommand.
Formoreinformation,see"BackupVM"onpage39.
Relatedconcepts:"DataProtectionforMicrosoftHyper-Vupgradeconsiderations"onpage13"LimitationsonHyper-Vbackupoperations"onpage9"VirtualmachinebackupswithVolumeShadowCopyService(VSS)"onpage2Relatedtasks:"MigratingfromVSSbackupstoRCTbackups"Relatedreference:AppendixA,"Troubleshooting,"onpage101MigratingfromVSSbackupstoRCTbackupsTotakeadvantageoftheresilientchangetracking(RCT)feature,migrateyourvirtualmachine(VM)backupoperationsfromtheMicrosoftVolumeShadowCopyService(VSS)toRCT.
BeforeyoubeginvVerifythattheHyper-VVMisatVersion6.
2orlater.
YoucandeterminetheVMversionintheHyper-VManagerorbyrunningtheGet-VMcmdlet.
vWhenyoumigrateyourHyper-VenvironmentfromWindowsServer2012or2012R2toWindowsServer2016,theVMversionoftheHyper-VVMsisnotupdatedautomatically.
YoumustupdatetheVMstothenewversionbeforetheycanbebackedupbyDataProtectionforMicrosoftHyper-V.
EnsurethatyoutaketheguestVMofflinebeforeyouupdatetheVMversionofaVM.
YoucanupdatetheVMversionintheHyper-VManagerorwiththeUpdate-VMVersioncmdlet.
4IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuide||||||||||||||||||||||||||||||||||||||||||||||||||ProcedureTomigrateVSSbackupstoRCT:1.
InstallandconfigureDataProtectionforMicrosoftHyper-VV8.
1.
2ontheHyper-VhostserverontheWindowsServer2016operatingsystem.
2.
Runanincremental-foreverfullbackupoperationonyourVMs.
AllDataProtectionforMicrosoftHyper-VbackupoperationsintheWindowsServer2016orlaterenvironmentuseRCTbackups.
ResultsvBecausepreviousVSSbackupsdonothaveRCTchange-trackinginformation,anincremental-foreverfullbackupiscreatedthefirsttimeyoubackupaVMwithDataProtectionforMicrosoftHyper-VV8.
1.
2.
vVSSbackupsaredisabledaftertheinitialbackupofaVMwithRCT.
vWithDataProtectionforMicrosoftHyper-VV8.
1.
2,youcanstillrestoreVMsthatwerebackeduponWindowsServer2016inV8.
1.
0.
SubsequentbackupsofVMsuseRCT.
Relatedconcepts:"Virtualmachinebackupswithresilientchangetracking(RCT)"onpage2"VirtualmachinebackupswithVolumeShadowCopyService(VSS)"onpage2RestoreHyper-VvirtualmachinesYoucanrestoreHyper-Vvirtualmachinesbyusingseveralmethods.
Youcanrestoreanentirevirtualmachine,restoreanentirevirtualmachinetoanalternativelocation,orrestoreindividualfilesfromavirtualmachine.
ThesemethodsapplytoHyper-VhostsrunningonWindowsServer2016orWindowsServer2012operatingsystems.
RestoreanentireHyper-VvirtualmachineEachHyper-VvirtualmachinebackupisrestoredfromtheIBMSpectrumProtectserverasasingleentity.
YoucanrestoreanyguestoperatingsystemsthatarehostedbytheHyper-VserverregardlessofwhethertheguestoperatingsystemissupportedbyIBMSpectrumProtect.
ADataProtectionforMicrosoftHyper-Vrestoreoperationensuresthatthesameblockontheproductiondiskisrestoredonlyonce.
OlderbackupversionsexpireaccordingtotheIBMSpectrumProtectservermanagementclasspolicythatisassociatedwiththevirtualmachine.
RestoreanentireHyper-VvirtualmachinetoanalternativelocationYoucanrestoreaHyper-Vvirtualmachinetoanalternativevirtualmachinename,toanalternativelocationontheHyper-Vhost,orboth.
YoucanalsorestoreaHyper-VvirtualmachinetoadifferentHyper-Vhost.
However,torestorethevirtualmachinetoadifferenthost,youmustruntherestoreoperationfromtheHyper-Vhostwherethevirtualmachineisbeingrestoredto.
Chapter1.
ProtectionforMicrosoftHyper-Vvirtualmachines5|||||||||||||||||||||||RestoreafilefromaHyper-VvirtualmachineUsethisrestoremethodwhenonlyoneormorefilesmustberestored.
ThefilesaremanuallycopiedfromamountedvirtualmachinediskthatisaccessedthroughaniSCSItargetorpartition.
ThismethodrequirestheIBMSpectrumProtectrecoveryagenttobeinstalled.
PolicymanagementatthevirtualmachinelevelStoragerequirementsforHyper-VvirtualmachinebackupsaredeterminedbyIBMSpectrumProtectservermanagementclasses.
Youcansetdifferentpoliciesfordifferentvirtualmachines.
AlthoughthedefaultmanagementclassdeterminesstoragecharacteristicsforallHyper-Vbackups,youcanoverridethedefaultmanagementclassorspecifyamanagementclasstousefortheHyper-Vcontrolfiles.
YoucanchangethedefaultmanagementclassforHyper-Vvirtualmachinebackupswiththevmmcoption.
YoucanchangethedefaultmanagementclassforHyper-Vcontrolfileswiththevmctlmcoption.
Relatedreference:"Vmmc"onpage82"Vmctlmc"onpage77UserinterfacesforHyper-VoperationsYoucanuseseveraluserinterfacestocompleteHyper-Voperations.
TheIBMSpectrumProtectbackup-archiveclientmustbeinstalledontheHyper-Vhostserver.
CompleteallDataProtectionforMicrosoftHyper-Vbackup,restore,andquerytaskswiththebackup-archiveclientJavaGUIorbackup-archivecommand-lineclient.
TorestoreindividualfilesfromaHyper-Vvirtualmachine,usetheIBMSpectrumProtectrecoveryagentGUI.
Thefollowingfiguresarethehigh-leveloverviewsofDataProtectionforMicrosoftHyper-VintheWindowsServer2016orlaterandtheWindowsServer2012environments.
6IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuide||||||Figure1.
High-leveloverviewofDataProtectionforMicrosoftHyper-VintheWindowsServer2016environmentChapter1.
ProtectionforMicrosoftHyper-Vvirtualmachines7||||IncrementalforeverbackupstrategyAnincrementalforeverbackupstrategyminimizesbackupwindowswhileprovidingfasterrecoveryofyourdata.
IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-Vprovidesabackupstrategycalledincrementalforever.
Thisbackupsolutionrequiresonlyoneinitialfullbackup.
Afterward,anongoing(forever)sequenceofincrementalbackupsoccurs.
Theincrementalforeverbackupsolutionprovidestheseadvantages:vReducestheamountofdatathatgoesacrossthenetwork.
vReducesdatagrowthbecauseallincrementalbackupscontainonlytheblocksthatchangedsincethepreviousbackup.
vNocomparisonwiththebackuptargetisneededsinceonlychangedblocksareidentified.
vMinimizesimpacttotheclientsystem.
vReducesthelengthofthebackupwindow.
vNoneedtoscheduleaninitialfullbackupasaseparateschedule:thefirstissueofanincrementalforeverbackupautomaticallydefaultstoanincrementalforeverfullbackup.
Inaddition,therestoreprocessisoptimized,asonlythelatestversionsofblocksthatbelongtoarestoredbackuparerestored.
Sincethesameareaontheproductiondiskisrecoveredonlyonetime,thesameblockisnotwrittentomultipletimes.
Asaresultoftheseadvantages,incrementalforeveristhepreferredFigure2.
High-leveloverviewofDataProtectionforMicrosoftHyper-VintheWindowsServer2012environment8IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuidebackupstrategy.
SnapshotmanagementwithWindowsPowerShellOnaMicrosoftHyper-Vsystem,youcanuseWindowsPowerShell"cmdlets"toremove(undo)snapshotsthatwerecreatedbyIBMSpectrumProtectforaHyper-Vvirtualmachine.
YoucanusethesecmdletsonlyontheHyper-Vsystem;youcannotremovesnapshotsfromtheMicrosoftSystemCenterVirtualMachineManager.
Hyper-Vsystemsissuecautionarymessagestodiscourageyoufromeditingvirtualharddisksthatcontainsnapshots,orvirtualharddisksthatareassociatedwithachainofdifferencing(incremental-forever)snapshots.
Instead,usethecmdletstomanagesnapshotstominimizetheriskofdataloss.
ForalistofcmdletsthatareavailableforHyper-V,gotohttp://technet.
microsoft.
com/en-us/library/hh848559.
aspxandreadtheinformationfortheavailablecmdlets.
UsetheGet-VMSnapshotcmdletwiththe-SnapshotTypeRecoveryparametertoretrievesnapshotsforavirtualmachine.
UsetheRemove-VMSnapshotcmdlettoremoveasnapshot.
Removingasnapshotmergestheinformationthatthesnapshotwrotetothesnapshotdifferencesfile(theAVHDXfile)backtothevirtualmachineharddisk(theVHDXfile).
LimitationsonHyper-VbackupoperationsBeforeyoustartaHyper-Vbackupoperation,reviewthelimitations.
SomelimitationsapplytoallHyper-Vbackupoperations,whileothersapplyonlytoHyper-VbackupsonWindowsServer2012or2012R2orWindowsServer2016environments.
LimitationsthatapplytoallHyper-VbackupsDataProtectionforMicrosoftHyper-Vsupportsincremental-foreverfullbackupandincremental-foreverincrementalbackupoperationsforMicrosoftHyper-Vvirtualmachines(VMs)inVHDXdiskformatonly.
IfyouneedtobackupHyper-VVMsinVHDdiskformat,usetheVersion7.
1.
6orearlierbackup-archiveclientwithoutDataProtectionforMicrosoftHyper-VtocreateanimagebackupofthefullVM.
Issuethebackup-archiveclientdsmcbackupvmvmname-mode=fullcommandtocreateanimagebackupofallobjectsonaMicrosoftHyper-VvirtualmachineVHDorVHDXdisk.
Optionally,convert.
vhdfilesto.
vhdxformataccordingtoinstructionsavailableinMicrosoftdocumentation.
TheMicrosoftWindowsManagementInstrumentation(WMI)Service(winmgmt)mustberunningonthesystemswhereDataProtectionforMicrosoftHyper-V,IBMSpectrumProtectbackup-archiveclient,andIBMSpectrumProtectrecoveryagentareinstalled.
OperationsfailiftheWMIServiceisnotrunning.
Therefore,donotturnofftheWMIService.
VerifythatnoExchangeServerdatabaseishostedonrawdevicemapped(RDM)disksinphysicalcompatibilitymode,independentdisks,orondisksthatareattacheddirectlytotheguestthroughin-guestiSCSI.
YoucannotbackupaVMwithasharedvirtualharddisk.
Chapter1.
ProtectionforMicrosoftHyper-Vvirtualmachines9|||||||||LimitationsthatapplyonlytoVSSbackupsonWindowsServer2012and2012R2DataProtectionforMicrosoftHyper-VdoesnotbackupVMswithattachedphysicaldisks(pass-throughdiskssuchasiSCSIdisks).
ThislimitationoccursbecauseDataProtectionforMicrosoftHyper-VusesVolumeShadowCopyService(VSS)forbackupoperationsandVSScannotcreateasnapshotofthephysicaldisks.
IfyoutrytobackupaVMwithattachedphysicaldisks,thebackupoperationoftheVMwiththephysicaldiskfails,butbackupoperationscontinueforotherVMs.
Hyper-VconfigurationsontheWindowsServer2012R2operatingsystemarenotcompatiblewithWindowsServer2012.
Asaresult,arestoreoperationfromWindowsServer2012R2toWindowsServer2012fails.
However,arestoreoperationfromWindowsServer2012toWindowsServer2012R2succeeds.
Formoreinformation,gottotheMicrosoftKnowledgeBaseandsearchforArticle2868279.
LimitationsthatapplyonlytoRCTbackupsonWindowsServer2016orlaterYoucannotrunaVMbackupoperationduringarollingupgradeofaHyper-Vclusteroperatingsystem.
IfDataProtectionforMicrosoftHyper-Visunabletoretrievethechangetrackinginformation,anincremental-foreverfullbackupisrun.
YoucannotrunconcurrentbackupoperationsonthesameVM.
Forexample,ifyouruntwobackupvmcommandsonthesameVMatthesametime,oneofthebackupoperationsfailswithanerrormessage.
DataProtectionforMicrosoftHyper-Vcannotcreateanapplication-consistentsnapshotofaVMthatisinthePausedstate.
Onlyacrash-consistentsnapshotcanbecreatedofaVMinthePausedstate.
Forexample,setthefollowingoptioninthedsm.
optfile:INCLUDE.
VMSNAPSHOTATTEMPTSVM_name11YoucannotinstallDataProtectionforMicrosoftHyper-VonNanoServerforWindowsServer2016.
However,youcanuseDataProtectionforMicrosoftHyper-VonWindowsServer2016tocreatecrash-consistentbackupsofNanoServerguestVMs.
Forlate-breakingupdatesaboutknownissuesandlimitations,seetechnote1993768.
DocumentationresourcesIBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-Vsoftwareprovidesseveralcomponentstoassistwithprotectingyourvirtualmachines.
Asaresult,multipledocumentationresourcesareprovidedtoassistwithspecifictasks.
10IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuide|||||||||||||||||||||||||Table2.
DataProtectionforMicrosoftHyper-VdocumentationresourcesDocumentationContentsLocationIBMSpectrumProtectforVirtualEnvironmentsDataProtectionforMicrosoftHyper-VInstallationandUser'sGuideOverviewinformation,strategyplanning,installation,configuration,backupandrestorescenarios,andcommand-linereference.
IBMKnowledgeCenterathttps://www.
ibm.
com/support/knowledgecenter/SSERB6_8.
1.
2/ve.
user/r_pdf_ve.
htmlOnlinehelpfortheIBMSpectrumProtectbackup-archivecommand-lineclientBackupandrestoretasksrelatedtoHyper-Vguestsvirtualmachines.
StarttheIBMSpectrumProtectbackup-archivecommandlineclientbyusingeitherofthefollowingmethods:vOntheWindowssystem,gotoStart>Appsbyname>IBMSpectrumProtect>Backup-ArchiveCommandLine.
vOpenanAdministratorcommandpromptwindowandchangetothebackup-archiveclientinstallationdirectory(cd"C:\ProgramFiles\tivoli\tsm\baclient").
Rundsmc.
exe.
Accessthehelpbyusingeitherofthefollowingmethods:vAfteryoustartthecommandlineclient,attheProtect>prompt,enterhelptodisplaythetableofcontentsforthehelp.
vTodisplaythehelpinitsownwindow,openanAdministratorcommandpromptwindowandchangetothebackup-archiveclientinstallationdirectory(cd"C:\ProgramFiles\tivoli\tsm\baclient").
Rundsmc.
exehelptodisplaythehelptableofcontents.
Youcanalsoappendatopictitletothecommandtodisplayhelpforatopic.
Forexample,dsmchelpoptionsdisplaysthehelptopicthatdescribeshowtouseclientoptions;dsmchelpbackupvmdisplaysthehelpforthebackupvmcommand.
Chapter1.
ProtectionforMicrosoftHyper-Vvirtualmachines11Table2.
DataProtectionforMicrosoftHyper-Vdocumentationresources(continued)DocumentationContentsLocationOnlinehelpfortheIBMSpectrumProtectbackup-archiveGUIBackupandrestoretasksrelatedtoHyper-Vguestsvirtualmachines.
StarttheIBMSpectrumProtectbackup-archiveGUIclientusingeitherofthefollowingmethods:vOntheWindowssystem,gotoStart>Appsbyname>IBMSpectrumProtect>Backup-ArchiveGUI.
vOpenanAdministratorcommandpromptwindowandchangetothebackup-archiveclientinstallationdirectory(cd"C:\ProgramFiles\tivoli\tsm\baclient").
Rundsm.
exe.
Accessthehelpusingeitherofthefollowingmethods:vSelectthehelpiconandclickHelpTopicsorGettingstarted.
vYoucanalsopresstheF1keytoopentheHelpTopicshelp.
12IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuideChapter2.
InstallingDataProtectionforMicrosoftHyper-VInstallationofDataProtectionforMicrosoftHyper-Vincludesunderstandingthesystemrequirements,determiningwhichfeaturestoinstall,andinstallation.
Upgradeconsiderationsanduninstallationproceduresarealsoprovided.
DeterminesystemrequirementsIBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-Vrequires500MBofdiskspaceforinstallationandasupportedoperatingsystem.
DataProtectionforMicrosoftHyper-VrequirestheHyper-VroletobeinstalledontheMicrosoftWindowsServer2012,2012R2,orWindowsServer2016system.
OnWindowsServer2012or2012R2,toensurerobustnessandperformance,itisbestpracticetouseaVSShardwareproviderratherthanasoftwareprovider.
YoucannotinstallDataProtectionforMicrosoftHyper-VonNanoServerforWindowsServer2016.
However,youcanuseDataProtectionforMicrosoftHyper-VonWindowsServer2016tocreatecrash-consistentbackupsofNanoServerguestVMs.
FordetailedDataProtectionforMicrosoftHyper-Vsoftwareandhardwarerequirements,seeDataProtectionforMicrosoftHyper-VRequirementsattechnote1993754.
DataProtectionforMicrosoftHyper-VupgradeconsiderationsBeforeyouupgradetoDataProtectionforMicrosoftHyper-VVersion8.
1.
2,reviewtheconsiderationsthatapplytovirtualmachine(VM)backupoperationsonWindowsServer2016.
vWhenyouupgradeyourHyper-VenvironmentfromWindowsServer2012or2012R2toWindowsServer2016,theVMversionofthevirtualmachinesisnotupdatedautomatically.
TheHyper-VadministratormustupdatetheVMstothenewversionaftertheenvironmentisupgradedtoWindowsServer2016.
DataProtectionforMicrosoftHyper-VV8.
1.
2doesnotbackupVMsthatarenotupdatedtothenewVMversion.
EnsurethattheguestVMisofflinebeforeyouupdatetheVMversion.
YoucanupdatetheVMversionintheHyper-VManagerortheUpdate-VMVersioncmdlet.
vVMbackupoperationswithresilientchangetracking(RCT)inDataProtectionforMicrosoftHyper-VV8.
1.
2requiretheHyper-VVMtobeVersion6.
2orlater.
DataProtectionforMicrosoftHyper-VV8.
1.
0andearliercontinuestosupportearlierVMversionsbyusingtheVSSbackupmethod.
Relatedtasks:"MigratingfromVSSbackupstoRCTbackups"onpage4CopyrightIBMCorp.
2011,201713|||||||||||||||||||||||||DeterminewhichfeaturestoinstallReviewthefeaturesthatareavailableforyoutoinstall.
ThefollowingfeaturesareavailableforyoutoinstallwiththeIBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-Vproductdownloadimage:vTheDataProtectionforMicrosoftHyper-VproductcodeProvidesvirtualizationprotectionforMicrosoftHyper-Vvirtualmachines.
Tip:TheDataProtectionforMicrosoftHyper-Vproductcodeisinstalledwitheveryfeature.
ToinstalltheDataProtectionforMicrosoftHyper-Vproductcode,followthestepsin"InstallDataProtectionforMicrosoftHyper-Vfeatureswithdefaultsettings.
"vTheIBMSpectrumProtectbackup-archiveclientWhenyouoffloadbackupworkloads,thebackup-archiveclientrunstheoperationonthebackupserverand"moves"thedatatotheIBMSpectrumProtectserver.
Thisclientisreferredtoasthedatamover.
Toinstallthebackup-archiveclient,followthestepsin"Installthebackup-archiveclient(datamover)"onpage15.
vTheIBMSpectrumProtectrecoveryagentProvidesvirtualmountandfilerestorecapability.
ToinstalltheIBMSpectrumProtectrecoveryagent,followthestepsin"InstalltheIBMSpectrumProtectrecoveryagent"onpage16.
InstallDataProtectionforMicrosoftHyper-VfeatureswithdefaultsettingsInstalltheIBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-Vsoftwareandthebackup-archiveclient(datamover)withoutmodifyingfeaturesorinstallationdirectories.
AboutthistaskToinstallDataProtectionforMicrosoftHyper-Vwithdefaultsettings,completethefollowingsteps:Procedure1.
DownloadtheDataProtectionforMicrosoftHyper-VproductimagefromIBMPassportAdvantage.
2.
Tostarttheinstallationprogram,double-clicktheSetup.
exefile.
Choosethelanguagefortheinstallationprocess,thenclickNext.
3.
OntheWelcometotheInstallShieldWizardforIBMSpectrumProtectforVirtualEnvironments:DataProtectionforHyper-Vsuitepage,clickNext.
4.
OntheLicenseAgreementpage,readthetermsofthelicenseagreement.
ClickIacceptthetermsinthelicenseagreement.
Ifyoudonotacceptthetermsofthelicenseagreement,theinstallationends.
ClickNext5.
OntheInstallationTypepage,theinstallationprocessbeginsimmediatelyafteryouclickTypicalInstallation.
Youcannotchangeyourselectiononcetheinstallationprocessbegins.
IfyouaresurethatyouwanttoinstallDataProtectionforMicrosoftHyper-Vandthebackup-archiveclient(datamover)withoutmodifyingfeaturesorinstallationdirectories,clickTypicalInstallation.
14IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuideTip:Theinstallationprocessmighttakeseveralminutestocomplete.
6.
OntheInstallWizardCompletedpage,clickFinishtoexitthewizard.
ResultsDataProtectionforMicrosoftHyper-Vandthebackup-archiveclient(datamover)areinstalled.
WhattodonextBeforeyouattemptabackuporrestoreoperation,completethetasksdescribedin"Creatingandmodifyingtheclientoptionsfile"onpage21.
Installthebackup-archiveclient(datamover)Installthebackup-archiveclientandmodifyfeaturesorinstallationdirectories.
BeforeyoubeginvThebackup-archiveclientrunstheoperationonthebackupserverand"moves"thedatatotheIBMSpectrumProtectserver.
Thisclientisreferredtoasthedatamover.
vTheIBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-Vproductcodeisalsoinstalledwiththisfeature.
AboutthistaskToinstallthebackup-archiveclient(datamover),completethefollowingsteps:Procedure1.
DownloadtheDataProtectionforMicrosoftHyper-VproductimagefromIBMPassportAdvantage.
2.
Tostarttheinstallationprogram,double-clicktheSetup.
exefile.
Choosethelanguagefortheinstallationprocess,thenclickNext.
3.
OntheWelcometotheInstallShieldWizardforIBMSpectrumProtectforVirtualEnvironments:DataProtectionforHyper-Vsuitepage,clickNext.
4.
OntheLicenseAgreementpage,readthetermsofthelicenseagreement.
ClickIacceptthetermsinthelicenseagreement.
Ifyoudonotacceptthetermsofthelicenseagreement,theinstallationends.
ClickNext5.
OntheInstallationTypepage,clickAdvancedInstallation.
OntheAdvancedInstallationpage,theinstallationprocessbeginsimmediatelyafteryouclickInstalltheIBMSpectrumProtectbackup-archiveclient(datamover).
Youcannotchangeyourselectionaftertheinstallationprocessbegins.
6.
Ifyouaresurethatyouwanttoinstallthebackup-archiveclient(datamover),clickInstalltheIBMSpectrumProtectbackup-archiveclient(datamover).
7.
OntheWelcometotheInstallShieldWizardforIBMSpectrumProtectforVirtualEnvironments:DataProtectionforHyper-Vsuitepage,clickNext.
8.
OntheDestinationFolderpage,specifywheretoinstallDataProtectionforMicrosoftHyper-V.
YoucanacceptthedefaultlocationthatisshownintheDestinationFolderfieldorclickChangetospecifyanotherlocation.
ClickNextafteryoumakeyourselection.
9.
OntheReadytoInstalltheProgrampage,clickInstalltobegininstallingyourselectedcomponents.
Chapter2.
InstallingDataProtectionforMicrosoftHyper-V1510.
OntheInstallWizardCompletedpage,clickFinishtoexitthewizard.
TheInstallShieldWizardbeginsinstallingthedatamover.
11.
OntheLocationtoSaveFilespage,specifywheretosavethedatamoverfiles.
YoucanacceptthedefaultlocationthatisshownintheSavefilesinfolderfieldorclickChangetospecifyanotherlocation.
ClickNextafteryoumakeyourselection.
12.
OntheWelcometotheInstallShieldWizardforIBMSpectrumProtectClientpage,clickNext.
13.
OntheDestinationFolderpage,specifywheretoinstallthesoftware.
YoucanacceptthedefaultlocationthatisshownintheInstallIBMSpectrumProtectClienttofieldorclickChangetospecifyanotherlocation.
ClickNextafteryoumakeyourselection.
14.
OntheSetupTypepage,selectoneofthefollowingthetypes:TypicalorCustom.
vTypicalAtypicalinstallationinstallsthefollowingfeatures:–Thebackup-archiveclientGUIfiles(neededtousetheJavaGUI)–Thebackup-archiveclientwebfiles(neededtousethewebclient)–TheclientAPIfiles(asneededbyyourclientandoperatingsystem)vCustomAcustominstallationselectsthesamefilesasatypicalinstallation.
However,youcanacceptthedefaultlocationthatisshownintheInstalltofieldorclickChangetospecifyanotherlocation.
ClickSpacetoviewrequireddiskspace.
ClickNextafteryoumakeyourselection.
15.
OntheReadytoInstalltheProgrampage,clickInstalltobegininstallingyourselectedbackup-archiveclient(datamover)features.
Tip:AfteryouclickInstall,theinstallationprocessmighttakeseveralminutestocomplete.
16.
OntheInstallWizardCompletedpage,clickFinishtoexitthewizard.
ResultsThebackup-archiveclient(andDataProtectionforMicrosoftHyper-V)areinstalled.
WhattodonextBeforeyouattempttobackupaHyper-Vvirtualmachine,completethetasksdescribedin"Creatingandmodifyingtheclientoptionsfile"onpage21.
InstalltheIBMSpectrumProtectrecoveryagentInstalltheIBMSpectrumProtectrecoveryagentforvirtualmountandfilerestoreoperations.
BeforeyoubeginvTheIBMSpectrumProtectrecoveryagentinstallationrequiresthesystemtoberestarted.
Therefore,toavoidpossibleissuesthatarerelatedtorestartingtheHyper-Vhostsystem,donotinstalltherecoveryagentontheHyper-Vhostsystem.
16IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuidevTCPports22(SSHdefaultport)and3260(iSCSIdefaultport)mustbeopenandavailablebeforeyouinstalltheIBMSpectrumProtectrecoveryagent.
Tochecktheportstatus,openingacommandpromptandissuethefollowingcommands:netstat-npTCP|find"22"netstat-npTCP|find"3260"vTheIBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-Vproductcodeisalsoinstalledwiththisfeature.
AboutthistaskToinstalltheIBMSpectrumProtectrecoveryagent,completethefollowingstepsonavirtualmachineorothersystemthatisnottheHyper-Vhostsystem:Procedure1.
DownloadtheDataProtectionforMicrosoftHyper-VproductimagefromIBMPassportAdvantage.
2.
Tostarttheinstallationprogram,double-clicktheSetup.
exefile.
Choosethelanguagefortheinstallationprocess,thenclickNext.
IfyoualreadycompletedaTypicalInstallation,theProgramMaintenancepagedisplaysafteryoudouble-clicktheSetup.
exefile:a.
OntheProgramMaintenancepage,clickModify.
b.
OntheCustomSetuppage,clickIBMSpectrumProtectrecoveryagent,thenclickInstall.
c.
GotoStep11andfollowtheremaininginstallationsteps.
3.
OntheWelcometotheInstallShieldWizardforIBMSpectrumProtectforVirtualEnvironments:DataProtectionforHyper-Vsuitepage,clickNext.
4.
OntheLicenseAgreementpage,readthetermsofthelicenseagreement.
ClickIacceptthetermsinthelicenseagreement.
Ifyoudonotacceptthetermsofthelicenseagreement,theinstallationends.
ClickNext.
5.
OntheInstallationTypepage,clickAdvancedInstallation.
OntheAdvancedInstallationpage,theinstallationprocessbeginsimmediatelyafteryouclickInstalltheIBMSpectrumProtectrecoveryagent.
Youcannotchangeyourselectiononcetheinstallationprocessbegins.
6.
Ifyouaresurethatyouwanttoinstalltherecoveryagent,clickInstalltheIBMSpectrumProtectrecoveryagent.
Tip:Theinstallationprocessmighttakeseveralminutestocomplete.
7.
OntheWelcometotheInstallShieldWizardforIBMSpectrumProtectforVirtualEnvironments:DataProtectionforHyper-Vsuitepage,clickNext.
8.
OntheDestinationFolderpage,specifywheretoinstallthesoftware.
YoucanacceptthedefaultlocationthatisshownintheDestinationFolderfieldorclickChangetospecifyanotherlocation.
ClickNextafteryoumakeyourselection.
9.
OntheReadytoInstalltheProgrampage,clickInstalltobegininstallingyourselectedcomponents10.
OntheInstallWizardCompletedpage,clickFinishtoexitthewizard.
11.
OntheWelcometotheInstallShieldWizardforIBMSpectrumProtectforVirtualEnvironments:DataProtectionforHyper-Vsuitepage,clickNext.
12.
OntheSoftwareLicenseAgreementpage,readthetermsofthelicenseagreement.
ClickIacceptthetermsinthelicenseagreement.
Ifyoudonotacceptthetermsofthelicenseagreement,theinstallationends.
ClickNext.
Chapter2.
InstallingDataProtectionforMicrosoftHyper-V1713.
OntheCustomSetuppage,youcanclickSpacetoviewrequireddiskspace.
ClickChangetospecifywheretoinstallthisfeature.
Thefollowinguserinterfacesareinstalled:vTheIBMSpectrumProtectrecoveryagentGUIvTheIBMSpectrumProtectrecoveryagentcommand-lineinterface(RecoveryAgentShell.
exe)ClickNextafteryoumakeyourselection.
14.
OntheReadytoInstalltheProgrampage,clickInstalltobegininstallingyourselectedcomponents.
vYouarepromptedtoinstalltheIBMVirtualVolumedriver.
Thisdriverisusedformountoperations.
ClickInstalltoinstallthedriver.
Ifyoudonotinstallthedrivernow,youarepromptedagaintoinstallitwhenyouattempttomountavolume.
vTCPports22(SSHdefaultport)and3260(iSCSIdefaultport)mustbeopenandavailabletocompletetheinstallationprocess.
ClickOK.
15.
OntheIBMSpectrumProtectforVirtualEnvironmentsInstallShieldWizardCompletedpage,clickFinishtoexitthewizard.
Youmustrestartyoursystemafterinstallationcompletes.
ResultsTheIBMSpectrumProtectrecoveryagent(andDataProtectionforMicrosoftHyper-V)areinstalled.
WhattodonextBeforeyouattempttomountabackedupHyper-Vvirtualmachinedisktorestoreafile,completethetasksdescribedin"ConfiguringtheIBMSpectrumProtectrecoveryagentGUI"onpage25.
InstallinginsilentmodeInstallallIBMSpectrumProtectforVirtualEnvironmentsanddatamoverfeaturessilentlyonasinglesystem.
AboutthistaskRestriction:Allfeaturesareinstalledtotheirdefaultlocation.
YoucannotsilentlyinstallIBMSpectrumProtectforVirtualEnvironmentsanddatamoverfeaturestoanon-defaultlocation.
Procedure1.
DownloadtheimagefromIBMPassportAdvantage.
2.
Fromacommandpromptwindow,usethecdcommandtochangetoTSM4VE_WIN.
3.
Enterthefollowingcommand:setup.
exe/silent4.
Restartthesystemafterinstallationcompletes.
Thefollowingmessageisdisplayedthefirsttimethatyoumountavolume:18IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuideTheVirtualVolumeDriverisnotyetregistered.
RecoveryAgentcanregisterthedrivernow.
Duringregistration,aMicrosoftWindowsLogowarningmaybedisplayed.
Acceptthiswarningtoallowtheregistrationtocomplete.
DoyouwanttoregistertheVirtualVolumeDrivernowYoumustregistertheVirtualVolumeDrivertoproceedwiththeIBMSpectrumProtectrecoveryagentoperations.
UninstallingDataProtectionforMicrosoftHyper-VTheprocessforuninstallingIBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-Visthesameforanewinstallationandforanupgradedversion.
BeforeyoubeginRestriction:YoumustunmountallvirtualvolumesbeforeuninstallingtheIBMSpectrumProtectrecoveryagent.
Otherwise,thesemountedvirtualvolumescannotbeunmountedaftertheIBMSpectrumProtectrecoveryagentisreinstalled.
Procedure1.
GotoStart>ControlPanel>Programs-Uninstallaprogram.
2.
OntheUninstallorchangeaprogrampage,selectIBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VandclickUninstall.
3.
OntheUninstallorchangeaprogrampage,selectIBMSpectrumProtectclientandclickUninstall.
4.
OntheUninstallorchangeaprogrampage,selectIBMSpectrumProtectrecoveryagentandclickUninstall.
UninstallingDataProtectionforMicrosoftHyper-VwiththeMicrosoftWindowsInstallerToolUninstallIBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VfromaMicrosoftWindowsServerCorewiththeMicrosoftWindowsInstallerTool.
Procedure1.
LocatetheDataProtectionforMicrosoftHyper-VUninstallStringintheWow6432Noderegistrypath.
Forexample:[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall\{060612C6-E661-4502-ADD0-AF912CDB02C9}]2.
Runthefollowingcommand:C:\"C:\ProgramFiles(x86)\InstallShieldInstallationInformation\{060612C6-E661-4502-ADD0-AF912CDB02C9}\Setup.
exe"-remove-runfromtempChapter2.
InstallingDataProtectionforMicrosoftHyper-V1920IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuideChapter3.
ConfiguringDataProtectionforMicrosoftHyper-VAftersuccessfullyinstallingtheIBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-Vsoftware,youmustconfiguretheclientbeforeperforminganybackupandrestoreoperations.
YoumustalsoconfiguretheIBMSpectrumProtectrecoveryagenttorestoreindividualfiles.
CreatingandmodifyingtheclientoptionsfileTheclientoptionsfileisaneditabletextfilethatcontainsconfigurationinformationforthebackup-archiveclientoptionsthatareusedforIBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-Voperations.
AboutthistaskThefirsttimethatyoustarttheWindowsbackup-archiveclientGUI,theinstallationprogramsearchesforanexistingclientoptionsfile,calleddsm.
opt.
Ifthisfileisnotdetected,aclientoptionsfileconfigurationwizardstartsandpromptsyoutospecifyinitialclientconfigurationsettings.
Whenthewizardcompletes,itsavestheinformationthatyouspecifiedinthedsm.
optfile.
Bydefault,thedsm.
optfileissavedtoC:\ProgramFiles\Tivoli\TSM\baclient.
Theoptionsfilemustcontainthefollowinginformationtocommunicatewiththeserver:vThehostnameorIPaddressoftheIBMSpectrumProtectserver.
vTheportnumberthattheserverlistensonforclientcommunications.
Adefaultportnumberisconfiguredbytheclientoptionsfileconfigurationwizard.
Youdonotneedtooverridethisdefaultportnumberunlessyourserverisconfiguredtolistenonadifferentport.
vYourclientnodename.
Thenodenameisanamethatuniquelyidentifiesyourclientnode.
Thenodenamedefaultstotheshorthostnameofthecomputerthattheclientisinstalledon.
Additionalclientoptionscanbespecified,asneeded.
Tip:Clientoptionscanalsobesetontheserverinaclientoptionset.
Clientoptionsthataredefinedontheserverinaclientoptionsetoverrideclientoptionsthataresetintheclientoptionsfile.
Asampleoptionsfileiscopiedtoyourdiskwhenyouinstallthebackup-archiveclient.
Thefileiscalleddsm.
smp.
Bydefault,thedsm.
smpfileiscopiedtoC:\ProgramFiles\Tivoli\TSM\config\.
Youcanviewthecontentsofthisfiletoseeexamplesofdifferentoptionsandhowtheyarespecified.
Thefilealsocontainscommentsthatexplainsyntaxconventionsforincludelists,excludelists,andwildcarduse.
Youcanalsousethisfileasatemplateforyourclientoptionsfilebyeditingitandsavingitasdsm.
optintheC:\ProgramFiles\Tivoli\TSM\baclientdirectory.
Aftertheinitialclientoptionsfileiscreated,youcanmodifytheclientoptionsbyaddingorchangingtheoptionsasneeded.
Youcanmodifythedsm.
optfileinanyofthefollowingways:CopyrightIBMCorp.
2011,201721vByrunningtheclientoptionsfileconfigurationsetupwizardvByusingtheclientpreferenceseditorvByeditingthedsm.
optfilewithatexteditorprogram,suchasNotepadPerformthefollowingstepstomodifytheclientoptions:Procedure1.
Selectamethodtomodifythefile.
MethodStepsSetupwizardTheconfigurewizardopensautomaticallywhenthebackup-archiveclientisinstalledforthefirsttime.
Ifthewizarddoesnotopenautomatically,completethefollowingsteps:1.
ClickStart>AllPrograms>IBMSpectrumProtect>Backup-ArchiveGUI.
2.
SelectUtilities>SetupWizard>HelpmeconfiguretheClientOptionsFile.
On-screentextandonlinehelpisavailabletoprovideguidanceasyounavigatethroughthewizardpanels.
Thisclientoptionsfileconfigurationwizardofferslimitedchoicesandconfiguresonlythemostbasicoptions.
Preferenceseditor1.
ClickStart>AllPrograms>IBMSpectrumProtect>Backup-ArchiveGUI.
2.
SelectEdit>ClientPreferences.
Selectthetabsinthepreferenceseditortosetclientoptions.
Specifytheoptionsinthedialogboxes,dropdownlists,andothercontrols.
Onlinehelpisprovided.
Clickthequestionmark()icontodisplaythehelptopicsfortheonlinehelpforthetabthatyouareediting.
Youcansetmoreoptionsinthepreferenceseditorthanyoucansetinthesetupwizard.
Editthedsm.
optfile1.
Editthedsm.
optfilebyusingaplaintexteditor.
EachoftheoptionsisdescribedindetailinthedocumentationinChapter6,"Optionsreference,"onpage55.
Thismethodisthemostversatilewaytosetclientoptionsbecausenotalloptionscanbesetintheclientoptionsfileconfigurationwizardorinthepreferenceseditor.
2.
Tocommentoutasetting,insertanasterisk(*)asthefirstcharacteronthelinethatyouwanttocommentout.
Removetheasterisktomakethecommentedoptionactive.
2.
Savethechanges.
22IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuidea.
Changesmadeintheclientoptionsfileconfigurationwizardandinthepreferenceseditoraresavedandrecognizedbytheclientwhenthewizardcompletes,orwhenyouexitthepreferenceseditor.
b.
Ifyouedittheclientoptionsfilewithatexteditorwhiletheclientisrunning,youmustsavethefileandrestarttheclientsothechangesaredetected.
3.
Verifythatyourconfigurationiscompletebymakingsurethatyoucanviewthevirtualmachinesinyourenvironment:vToverifyyourconfigurationwiththeIBMSpectrumProtectbackup-archivecommandlineclient,issuethedsmcshowvmcommand.
Alistofvirtualmachinesthatareavailableforbackupdisplays.
vToverifyyourconfigurationwiththeIBMSpectrumProtectbackup-archiveGUI,clickActions>BackupVM.
IntheBackupVirtualMachinewindow,expandtheHyper-VVMsnodetoshowthevirtualmachinesthatareavailableforbackup.
Ifyoucanviewthevirtualmachinesinyourenvironment,youarereadytobackupyourvirtualmachinesasdescribedin"BackupVM"onpage39.
WhattodonextIfyouplantorunbackupandrestoreoperationsinacluster,completethetasksdescribedin"ConfiguringDataProtectionforMicrosoftHyper-Vinaclusterenvironment"beforeyouattemptabackuporrestoreoperation.
ConfiguringDataProtectionforMicrosoftHyper-VinaclusterenvironmentConfigurationconsistsofupdatingthedsm.
optfilesandregisteringthenodesforeachphysicalserverinthecluster.
BeforeyoubeginYoucanusetheHyper-VfailoverclusteringfeaturetoallowHyper-Vvirtualmachinestofailoverfromoneclusternodetoanotherclusternodewhenanoutageoccurs.
Forinformationaboutinstallingthisfeature,andforinformationthatdescribeshowtosetupaclusterconfigurationforHyper-Vvirtualmachines,seetheMicrosoftdocumentationforHyper-Vandyouroperatingsystem.
Inafailoverclusterconfiguration,youcanensurethattheHyper-Vvirtualmachinesarebackedupto(andrestorablefrom)asingleIBMSpectrumProtectservercontainer,regardlessofwhichclusternodeisbackingthemup.
Youimplementthisconfigurationbycreatingaproxyrelationship,ontheIBMSpectrumProtectserver,toalloweachphysicalservernode(NODENAMEoption)toperformoperationsonbehalfofanodethatservesasacontainerontheIBMSpectrumProtectserver(ASNODENAMEoption).
Youcanmovevirtualmachineswithintheclusterandstillbackupdatatothesamecontainer.
AboutthistaskBeforeyoubegin,assignauniquenodenameforeachphysicalserverinthecluster(forexample,Host1,Host2).
Next,assignanodenamethatistheIBMSpectrumProtectservercontainerforallthevirtualmachinebackupsinthecluster(forexample,clusternode).
Chapter3.
ConfiguringDataProtectionforMicrosoftHyper-V23ProcedureCompleteStep1throughStep3ontheIBMSpectrumProtectserver:1.
Logontotheserverandstartanadministrativeclientsessionincommandlinemode:dsmadmc-id=admin-password=admin2.
IssuetheREGISTERNODEcommandtoregistereachphysicalservernodeinthecluster,andtheclusternode,totheserver.
Forthisexample,youregisterthefollowingnodes:REGISTERNODEHOST1REGISTERNODEHOST2REGISTERNODECLUSTERNODETheASNODENAMEvalue(CLUSTERNODE)identifiesacontainerontheserverwherefilesarestoredthatwerebackedupbythephysicalservernodesinthecluster.
3.
IssuetheGRANTPROXYNODEcommandtograntproxyauthoritytoeachphysicalservernodeinthecluster.
ThisproxyauthorityallowseachphysicalservernodeintheclustertobackupfilestotheCLUSTERNODE.
Forthisexample,youregisterthefollowingproxyauthority:a.
ThiscommandallowsHOST1toperformoperationsonbehalfofCLUSTERNODE:GRANTPROXYNODETARGET=CLUSTERNODEAGENT=HOST1b.
ThiscommandallowsHOST2toperformoperationsonbehalfofCLUSTERNODE:GRANTPROXYNODETARGET=CLUSTERNODEAGENT=HOST2CompleteStep4throughStep6oneachphysicalservernodeinthecluster:4.
InstallandconfiguretheIBMSpectrumProtectbackup-archiveclientoneachphysicalservernodeinthecluster.
Fordetailedinstructions,seethefollowingcontents:v"Installthebackup-archiveclient(datamover)"onpage15v"Creatingandmodifyingtheclientoptionsfile"onpage215.
Identifyeachphysicalservernodewithauniquenodename,andsettheNODENAMEoptioninthedsm.
optfileoneachphysicalservernodeinthecluster.
Forthisexample,assumethatyouspecifiedthefollowingvaluesfortheNODENAMEoption:vInthedsm.
optfileonHost1,youspecifiedNODENAMEHOST1vInthedsm.
optfileonHost2,youspecifiedNODENAMEHOST26.
SettheASNODENAMEoptioninthedsm.
optfileoneachphysicalservernodeinthecluster.
vTheASNODENAMEvaluemustbethesameinalldsm.
optfilesinthecluster.
vTheASNODENAMEvaluemustnotmatchanyNODENAMEvalueinanydsm.
optfilesinthecluster.
Forthisexample,assumethatyouspecifiedthefollowingvaluesfortheASNODENAMEoption:vInthedsm.
optfileonHost1,youspecifiedASNODENAMECLUSTERNODEvInthedsm.
optfileonHost2,youspecifiedASNODENAMECLUSTERNODE24IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuideResultsWheneitherofthenodes(HOST1,HOST2)backsupdatatotheIBMSpectrumProtectserver,thebackupsarestoredinthecontainernamedCLUSTERNODE.
Bothnodes(HOST1,HOST2)canbackuporrestoredatafromthatIBMSpectrumProtectservercontainer.
ExampleForexample,whenthiscommandisissuedonHOST2,itperformsanincrementalforeverfullbackupofvirtualmachineVM1(ownedbyHOST2)totheIBMSpectrumProtectservercontaineridentifiedbyCLUSTERNODE:dsmcbackupvmVM1-mode=iffull-asnode=clusternodeConfiguringtheIBMSpectrumProtectrecoveryagentGUIYoumustsetuptheIBMSpectrumProtectrecoveryagentGUIformountandfilerestoreoperations.
BeforeyoubeginTheseconfigurationtasksmustbecompletedbeforeyouusetheIBMSpectrumProtectrecoveryagentGUI.
Procedure1.
Logontothesystemwhereyouwanttorestorefiles.
TheIBMSpectrumProtectrecoveryagentmustbeinstalledonthesystem.
2.
ClickSelectIBMSpectrumProtectserverintheIBMSpectrumProtectrecoveryagentGUItoconnecttotheIBMSpectrumProtectserver.
Specifythefollowingoptions:ServeraddressEntertheIPaddressorhostnameoftheIBMSpectrumProtectserver.
ServerportEntertheportnumberthatisusedforTCP/IPcommunicationwiththeserver.
Thedefaultportnumberis1500.
Nodeaccessmethod:AsnodenameSelectthisoptiontouseaproxynodetoaccessthevirtualmachinebackupsthatareinthetargetnode.
Theproxynodeisanodethatisgranted"proxy"authoritytoperformoperationsonbehalfofthetargetnode.
Typically,youusethegrantproxynodecommandtocreatetheproxyrelationshipbetweentwoexistingnodes.
Ifyouselectthisoption,completethefollowingsteps:a.
Enterthenameofthetargetnode(thenodewherethevirtualmachinebackupsarelocated)intheTargetNodefield.
b.
EnterthenameoftheproxynodeintheAuthenticationnodefield.
c.
EnterthepasswordfortheproxynodeinthePasswordfield.
d.
ClickOKtosavethesesettingsandexittheIBMSpectrumProtectpage.
Chapter3.
ConfiguringDataProtectionforMicrosoftHyper-V25Whenyouusethismethod,theIBMSpectrumProtectrecoveryagentuserknowsonlytheproxynodepassword,andthetargetnodepasswordisprotected.
FromnodeSelectthisoptiontouseanodewithaccesslimitedonlytothesnapshotdataofspecificvirtualmachinesinthetargetnode.
Typically,thisnodeisgivenaccessfromthetargetnodethatownsthevirtualmachinebackupsbyusingthesetaccesscommand:setaccessbackup-TYPE=VMvmdisplaynamemountnodenameForexample,thiscommandgivesthenodenamedmyMountNodetheauthoritytorestorefilesfromthevirtualmachinenamedmyTestVM:setaccessbackup-TYPE=VMmyTestVMmyMountNodeIfyouselectthisoption,completethefollowingsteps:a.
Enterthenameofthetargetnode(thenodewherethevirtualmachinebackupsarelocated)intheTargetNodefield.
b.
EnterthenameofthenodethatisgivenlimitedaccessintheAuthenticationnodefield.
c.
EnterthepasswordforthenodethatisgivenlimitedaccessinthePasswordfield.
d.
ClickOKtosavethesesettingsandexittheIBMSpectrumProtectpage.
Whenyouusethismethod,youcanseeacompletelistofbacked-upvirtualmachines.
However,youcanrestoreonlythosevirtualmachinebackupstowhichthenodewasgrantedaccess.
Inaddition,thesnapshotdataisnotprotectedfromexpirationontheserver.
DirectSelectthisoptiontoauthenticatedirectlytothetargetnode(thenodewherethevirtualmachinebackupsarelocated).
Ifyouselectthisoption,completethefollowingsteps:a.
Enterthenameofthetargetnode(thenodewherethevirtualmachinebackupsarelocated)intheAuthenticationnodefield.
b.
EnterthepasswordforthetargetnodeinthePasswordfield.
c.
ClickOKtosavethesesettingsandexittheIBMSpectrumProtectpage.
UsePasswordaccessgenerateWhenthisoptionisselectedandthepasswordfieldisempty,theIBMSpectrumProtectrecoveryagentauthenticateswithanexistingpasswordthatisstoredinthepasswordstore.
Ifnotselected,youmustmanuallyenterthepassword.
Tousethisoption,youmustfirstmanuallysetaninitialpasswordforthenodetowhichtheoptionapplies.
YoumustspecifytheinitialpasswordwhenyouconnecttotheIBMSpectrumProtectnodeforthefirsttimebyenteringthepasswordinthePasswordfieldandselectingtheUsePasswordaccessgeneratecheckbox.
However,whenyouusethelocaldatamovernodeastheAuthenticationnode,thepasswordmightalreadybestoredinthepasswordstore.
Asaresult,selecttheUsePasswordaccessgeneratecheckboxanddonotenterapassword.
26IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuide||||||||||||||Formoreinformationaboutthepasswordstore,seeSecurepasswordstorage.
TheIBMSpectrumProtectrecoveryagentqueriesthespecifiedserverforalistofprotectedvirtualmachines,andshowsthelist.
3.
Setthefollowingmount,backup,andrestoreoptionsbyclickingSettings:VirtualVolumewritecacheTheIBMSpectrumProtectrecoveryagentthatisrunningonthebackupproxyhostsavesdatachangesonavirtualvolumeinthewritecache.
Bydefault,thewritecacheisenabledandthemaximumcachesizeis90%oftheavailablespacefortheselectedfolder.
Topreventthesystemvolumefrombecomingfull,changethewritecachetoapathonavolumeotherthanthesystemvolume.
FolderfortemporaryfilesSpecifythepathwheredatachangesaresaved.
Thewritecachemustbeonalocaldriveandcannotbesettoapathonasharedfolder.
CachesizeSpecifythesizeofthewritecache.
Themaximumallowedcachesizeis90%oftheavailablespacefortheselectedfolder.
Restriction:Topreventanyinterruptionduringrestoreprocessing,excludethewritecachepathfromallantivirussoftwareprotectionsettings.
DataAccessSpecifythetypeofdatatobeaccessed.
Ifyouareusinganofflinedevice(suchastapeorvirtualtapelibrary),youmustspecifytheapplicabledatatype.
StoragetypeSpecifyoneofthefollowingstoragedevicesfromwhichtomountthesnapshot:Disk/FileThesnapshotismountedfromadiskorfile.
Thisdeviceisthedefault.
TapeThesnapshotismountedfromatapestoragepool.
Whenthisoptionisselected,itisnotpossibletomountmultiplesnapshots.
VTLThesnapshotismountedfromanofflinevirtualtapelibrary.
Concurrentmountsessionsonthesamevirtualtapelibraryaresupported.
Requirement:Whenthestoragetypeischanged,youmustrestarttheserviceforthechangestotakeeffect.
DisableexpirationprotectionDuringamountoperation,thesnapshotontheIBMSpectrumProtectserverislockedtopreventitfromexpiringduringtheoperation.
Expirationmightoccurbecauseanothersnapshotisaddedtothemountedsnapshotsequence.
Thisvaluespecifieswhethertodisableexpirationprotectionduringthemountoperation.
Chapter3.
ConfiguringDataProtectionforMicrosoftHyper-V27||vToprotectthesnapshotfromexpiration,donotselectthisoption.
Thisoptionisclearedbydefault.
ThesnapshotontheIBMSpectrumProtectserverislockedandthesnapshotisprotectedfromexpirationduringthemountoperation.
vTodisableexpirationprotection,selectthisoption.
ThesnapshotontheIBMSpectrumProtectserverisnotlockedandthesnapshotisnotprotectedfromexpirationduringthemountoperation.
Asaresult,thesnapshotmightexpireduringthemountoperation.
Thisexpirationcanproduceunexpectedresultsandnegativelyimpactthemountpoint.
Forexample,themountpointcanbecomeunusableorcontainerrors.
However,expirationdoesnotaffectthecurrentactivecopy.
Theactivecopycannotexpireduringanoperation.
Whenthesnapshotisonatargetreplicationserver,thesnapshotcannotbelockedbecauseitisinread-onlymode.
Alockattemptbytheservercausesthemountoperationtofail.
Toavoidthelockattemptandpreventsuchafailure,disableexpirationprotectionbyselectingthisoption.
ReadAheadsize(in16-KBblocks)Specifythenumberofextradatablocksthatareretrievedfromthestoragedeviceafterareadrequestissenttoasingleblock.
Thedefaultvaluesareasfollows:vDiskorfile:64vTape:1024vVTL:64Themaximumvalueforanydeviceis1024.
ReadAheadcachesize(inblocks)Specifythesizeofthecachewheretheextradatablocksarestored.
Thedefaultvaluesareasfollows:vDiskorfile:10000vTape:75000vVTL:10000Sinceeachsnapshothasitsowncache,makesuretoplanhowmanysnapshotsaremountedorrestoredsimultaneously.
Thecumulativecachesizecannotexceed75000blocks.
Drivertimeout(seconds)Thisvaluespecifiestheamountoftimetoprocessdatarequestsfromthefilesystemdriver.
Ifprocessingisnotcompletedintime,therequestiscanceledandanerrorisreturnedtothefilesystemdriver.
Considerincreasingthisvaluewhenyouexperiencetimeouts.
Forexample,timeoutsmightoccurwhenthenetworkisslow,thestoragedeviceisbusy,ormultiplemountsessionsarebeingprocessed.
Thedefaultvaluesareasfollows:vDiskorfile:60vTape:180vVTL:60ClickOKtosaveyourchangesandexittheSettings.
28IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuide4.
VerifythateachIBMSpectrumProtectservernode(thatwasspecifiedwiththeAsnodenameandFromnodeoptions)allowsbackupstobedeleted.
TheIBMSpectrumProtectrecoveryagentcreatesunusedtemporaryobjectsduringoperations.
TheBACKDELete=Yesserveroptionallowstheseobjectstoberemovedsothattheydonotaccumulateinthenode.
a.
LogontotheIBMSpectrumProtectserverandstartanadministrativeclientsessionincommand-linemode:dsmadmc-id=admin-password=admin-dataonly=yesb.
Enterthiscommand:QueryNodeFormat=DetailedMakesurethecommandoutputforeachnodeincludesthefollowingstatement:BackupDeleteAllowed:YesIfthisstatementisnotincluded,updateeachnodewiththiscommand:UPDateNodeBACKDELete=YesRuntheQueryNodecommandagainforeachnodetoverifythateachnodeallowsbackupstobedeleted.
EnablingsecurecommunicationfromtherecoveryagenttotheIBMSpectrumProtectserverIftheIBMSpectrumProtectserverisconfiguredtousetheSecureSocketsLayer(SSL)orTransportLayerSecurity(TLS)protocol,youcanenabletherecoveryagenttocommunicatewiththeserverbyusingtheprotocol.
BeforeyoubeginConsiderthefollowingrequirementsbeforeyoubeginconfigurationforsecurecommunicationtotheserver:vEachserverthatisenabledforSSLmusthaveauniquecertificate.
Thecertificatecanbeoneofthefollowingtypes:–Acertificatethatisself-signedbytheserver.
–Acertificatethatisissuedbyathird-partycertificateauthority(CA)certificate.
TheCAcertificatecanbefromacompanysuchasSymantecorThawte,oraninternalcertifcatethatismaintainedwithinyourcompany.
vForperformancereasons,useSSLorTLSonlyforsessionswheresecurityisrequired.
Consideraddingmoreprocessorresourcesontheserversystemtomanagetheincreasedrequirements.
vForaclienttoconnecttoaserverthatisusingTLSVersion1.
2,thecertificatesignaturealgorithmmustbeSecureHashAlgorithm1(SHA-1)orlater.
Ifyouareusingaself-signedcertificatetoaserverthatisusingTSLV1.
2,youmustusethecert256.
armcertificate.
YourIBMSpectrumProtectadministratormightneedtochangethedefaultcertificateontheserver.
vTodisablesecurityprotocolsthatarelesssecurethanTLS1.
2,addtheSSLDISABLELEGACYtlsyesoptiontotheC:\windows\system32\fb.
optorC:\Windows\SysWOW64\fb.
optfile.
TLS1.
2orlaterhelpstopreventattacksbymaliciousprograms.
Chapter3.
ConfiguringDataProtectionforMicrosoftHyper-V29EnablingsecurecommunicationbyusinganIBMSpectrumProtectserverself-signedcertificateIftheIBMSpectrumProtectserverisusingaself-signedcertificate,youmustobtainacopyofthatcertificatefromtheserveradministratorandconfiguretherecoveryagenttocommunicatewiththeserverbyusingtheSSLorTLSprotocol.
AboutthistaskEachservergeneratesitsowncertificate.
Version6.
3andlaterserversgeneratefilesthatarenamedcert256.
armiftheserverisusingTLS1.
2orlaterorcert.
armiftheserverisusinganearlierversionofSSLorTLS.
ServerversionsearlierthanV6.
3generatefilesthatarenamedcert.
armregardlessoftheprotocol.
Youmustchoosethecertificatethatissetasthedefaultontheserver.
Thecertificatefileisstoredontheserverworkstationintheserverinstancedirectory.
Forexample,C:\IBM\tivoli\tsm\server\bin\cert256.
arm.
Ifthecertificatefiledoesnotexist,thecertificatefileiscreatedwhenyourestarttheserverwiththeseoptionsset.
ProcedureToenableSSLorTLScommunicationfromtherecoveryagenttotheserverbyusingaself-signedcertificate:1.
AppendtheGSKitbinarypathandlibrarypathtothePATHenvironmentvariableontheclient.
Forexample:setPATH=C:\ProgramFiles\CommonFiles\Tivoli\TSM\api64\gsk8\bin\;C:\ProgramFiles\CommonFiles\Tivoli\TSM\api64\gsk8\lib64;%PATH%2.
IfyouareconfiguringSSLorTLSontheclientforthefirsttime,youmustcreatetheclientlocalkeydatabasedsmcert.
kdb.
FromtheC:\Windows\SysWOW64directory,runthegsk8capicmd_64commandasshowninthefollowingexample:gsk8capicmd_64-keydb-create-populate-dbdsmcert.
kdb-pwpassword-stashThepasswordthatyouprovideisusedtoencryptthekeydatabase.
Thepasswordisautomaticallystoredencryptedinthestashfile(dsmcert.
sth).
Thestashfileisusedbytheclienttoretrievethekeydatabasepassword.
3.
Obtaintheserverself-signedcertificate.
4.
Importthecertificateintothedsmcert.
kdbdatabase.
Youmustimportthecertificateforeachclientintothedsmcert.
kdb.
FromtheC:\Windows\SysWOW64directory,runthegsk8capicmd_64commandasshowninthefollowingexample:gsk8capicmd_64-cert-add-dbdsmcert.
kdb-stashed-label"Serverserver_nameself-signedkey"-filepath_to_certificate-formatascii-trustenableMultipleservercertificatescanbeaddedtothedsmcert.
kdbdatabasesothattheclientcanconnecttodifferentservers.
Differentcertificatesmusthavedifferentlabels.
Usemeaningfulnamesforthelabels.
Important:Foradisasterrecoveryoftheserver,ifthecertificatehasbeenlost,theserverautomaticallygeneratesanewcertificate.
Eachclientmustthenimportthenewcertificate.
5.
Aftertheservercertificateisaddedtothedsmcert.
kdbdatabase,addthesslyesoptiontotheC:\Windows\SysWOW64\fb.
optfileandupdatethevalueofthetcpportoption.
30IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuideImportant:TheserverisnormallysetupforSSLandTLSconnectionsonadifferentportthannon-SSLandTLSconnections.
Donotspecifyanon-SSLorTLSportnumberforthetcpportvalue.
Ifthevalueoftcpportisincorrect,therecoveryagentcannotconnecttotheserver.
Youcannotconnecttoanon-SSLorTLSportwitharecoveryagentthatisenabledforSSLorTLSorconnectaSSLorTLSporttoarecoveryagentthatisnotenabledforSSLorTLS.
6.
SetthecorrectSSLorTLSportsinthefollowingrecoveryagentconfigurationfiles:vC:\ProgramData\Tivoli\TSM\RecoveryAgent\mount\RecoveryAgent.
confvC:\ProgramData\Tivoli\TSM\RecoveryAgent\mount\RecoveryAgentDMNodes.
confEnablingsecurecommunicationbyusingathird-partycertificateIftheIBMSpectrumProtectserverisusingathird-partycertificateauthority(CA),youmustobtaintheCArootcertificate.
AboutthistaskIfthecertificatewasissuedbyaCAsuchasSymantecorThawte,theclientisreadyforSSLorTLSandyoucanskipthefollowingconfigurationsteps.
ForthelistofpreinstalledCArootcertificates,seeCertificateAuthoritiesrootcertificates.
IfthecertificatewasnotissuedbyapreinstalledrootcertificateorisaninternalCAcertificatethatismaintainedwithinyourcompany,youmustconfiguretherecoveryagenttocommunicatewiththeserverbyusingtheSSLorTLSprotocol.
ProcedureToenableSSLorTLScommunicationfromtherecoveryagenttotheserverbyusingaCAcertificate:1.
AppendtheGSKitbinarypathandlibrarypathtothePATHenvironmentvariable.
Forexample:setPATH=C:\ProgramFiles\CommonFiles\Tivoli\TSM\api64\gsk8\bin\;C:\ProgramFiles\CommonFiles\Tivoli\TSM\api64\gsk8\lib64;%PATH%2.
IfyouareconfiguringSSLorTLSontheclientforthefirsttime,youmustcreatetheclientlocalkeydatabasedsmcert.
kdb.
Forclients,fromtheC:\Windows\SysWOW64directory,runthegsk8capicmd_64commandasshowninthefollowingexample:gsk8capicmd_64-keydb-create-populate-dbdsmcert.
kdb-pwpassword-stashThepasswordthatyouprovideisusedtoencryptthekeydatabase.
Thepasswordisautomaticallystoredencryptedinthestashfile(dsmcert.
sth).
Thestashfileisusedbytheclienttoretrievethekeydatabasepassword.
3.
ObtaintheCAcertificate.
4.
Importthecertificateintothedsmcert.
kdbdatabase.
Youmustimportthecertificateforeachclientintothedsmcert.
kdb.
Forclients,fromtheC:\Windows\SysWOW64directory,runthegsk8capicmd_64commandasshowninthefollowingexample:gsk8capicmd_64-cert-add-dbdsmcert.
kdb-stashed-label"XYZCertificateAuthority"-filepath_to_CA_root_certificate-formatascii-trustenableChapter3.
ConfiguringDataProtectionforMicrosoftHyper-V31Multipleservercertificatescanbeaddedtothedsmcert.
kdbdatabasesothattheclientcanconnecttodifferentservers.
Differentcertificatesmusthavedifferentlabels.
Usemeaningfulnamesforthelabels.
Important:Foradisasterrecoveryoftheserver,ifthecertificatehasbeenlost,theserverautomaticallygeneratesanewcertificate.
Eachclientmustimportthenewcertificate.
5.
Aftertheservercertificateisaddedtothedsmcert.
kdbdatabase,addthesslyesoptiontotheC:\Windows\SysWOW64\fb.
optfileandupdatethevalueofthetcpportoption.
Important:TheserverisnormallysetupforSSLandTLSconnectionsonadifferentportthannon-SSLandTLSconnections.
Donotspecifyanon-SSLorTLSportnumberforthetcpportvalue.
Ifthevalueoftcpportisincorrect,therecoveryagentcannotconnecttotheserver.
Youcannotconnecttoanon-SSLorTLSportwitharecoveryagentthatisenabledforSSLorTLSorconnectaSSLorTLSporttoarecoveryagentthatisnotenabledforSSLorTLS.
6.
SetthecorrectSSLorTLSportsinthefollowingrecoveryagentconfigurationfiles:vC:\ProgramData\Tivoli\TSM\RecoveryAgent\mount\RecoveryAgent.
confvC:\ProgramData\Tivoli\TSM\RecoveryAgent\mount\RecoveryAgentDMNodes.
confManuallyconfiguringaniSCSIdeviceYoumustconfiguretheWindowssystemthatisusedduringaniSCSImountoperation.
ThesnapshotismountedfromIBMSpectrumProtectserverstorage.
BeforeyoubeginReviewthefollowingiSCSIrequirementsbeforeyouproceedwiththistask:vDuringaniSCSImount,aniSCSItargetiscreatedontheIBMSpectrumProtectrecoveryagentsystem.
YoucanconnecttotheiSCSItargetfromanysystemtocreateavolumethatcontainsthebackupdata.
Also,youcanthenmountthisvolumefromanothersystem.
viSCSIinitiatorisrequiredonanysystemthatmustconnecttotheiSCSItarget.
vMakesurethataniSCSIinitiatorisinstalledonthesystemwherethedataistoberestored.
vMicrosoftiSCSIInitiatorisnotrequiredontheIBMSpectrumProtectrecoveryagentsystem.
Reviewthefollowingdiskandvolumerequirementsbeforeyouproceedwiththistask:vIfavolumespansseveraldisks,youmustmountalltherequireddisks.
Whenmirroredvolumesareused,mountonlyoneofthemirroreddisks.
Mountingonediskpreventsatime-consumingsynchronizationoperation.
vIfmultipledynamicdiskswereusedonthebackupsystem,thesedisksareassignedtothesamegroup.
Asaresult,WindowsDiskManagermightconsidersomedisksasmissingandissueanerrormessagewhenyoumountonlyone32IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuidedisk.
Ignorethismessage.
Thedataonthebackedupdiskisstillaccessible,unlesssomeofthedataisontheotherdisk.
Thisissuecanbesolvedbymountingallthedynamicdisks.
AboutthistaskCompletethesetaskstoconfiguretheWindowssystemthatisusedduringaniSCSImountoperation:Procedure1.
OntheIBMSpectrumProtectrecoveryagentsystem,openport3260intheLANfirewallandtheWindowsclientfirewall.
RecordtheiSCSIinitiatornameonthesystemwheredataistoberestored.
TheiSCSIinitiatornameisshownintheiSCSIinitiatorconfigurationwindowoftheControlPanel.
Forexample:iqn.
1991-05.
com.
microsoft:hostname2.
CompletethesetasksonthesystemwheretheIBMSpectrumProtectrecoveryagent(oriSCSItarget)isinstalled:a.
StarttheIBMSpectrumProtectrecoveryagentGUI.
CompletetheSelectIBMSpectrumProtectserverandSelectsnapshotdialogsandclickMount.
b.
IntheChoosemountdestinationdialog,selectMountaniSCSItarget.
c.
Createatargetname.
MakesurethatitisuniqueandthatyoucanidentifyitfromthesystemthatrunstheiSCSIinitiator.
Forexample:iscsi-mount-tsm4ved.
EntertheiSCSIInitiatornamethatwasrecordedinStep1andclickOK.
e.
VerifythatthevolumeyoujustmountedisdisplayedintheMountedVolumesfield.
3.
LocateandstarttheiSCSIInitiatorprogramontheinitiatorsystemthatwasselectedinStep1:a.
ConnecttotheiSCSItarget:1)IntheTargetstab,entertheTCP/IPaddressoftheIBMSpectrumProtectrecoveryagent(iSCSItarget)usedinStep2intheTarget:dialog.
ClickQuickConnect.
2)TheQuickConnectdialogshowsatargetthatmatchesthetargetnamethatwasspecifiedinStep2c.
Ifitisnotalreadyconnected,selectthistargetandclickConnect.
b.
Ontheinitiatorsystem,gotoControlPanel>AdministrativeTools>ComputerManagement>Storage>DiskManagement.
1)IfthemountediSCSItargetislistedasType=Foreign,right-clickForeignDiskandselectImportForeignDisks.
TheForeignDiskGroupisselected.
ClickOK.
2)Thenextscreenshowsthetype,condition,andsizeoftheForeignDisk.
ClickOKandwaitforthedisktobeimported.
3)Whenthediskimportcompletes,pressF5(refresh).
ThemountediSCSIsnapshotisvisibleandcontainsanassigneddriveletter.
Ifdrivelettersarenotautomaticallyassigned,right-clicktherequiredpartitionandselectChangeDriveLettersorPaths.
ClickAddandselectadriveletter.
4.
OpenWindowsExplorer(orotherutility)andbrowsethemountedsnapshotforafilerestoreoperation.
5.
Afterthefileisrestored,completethesetasks:Chapter3.
ConfiguringDataProtectionforMicrosoftHyper-V33a.
DisconnecteachiSCSItargetbyusingtheiSCSIInitiatorPropertiesdialog.
b.
DismountthevolumefromStep2byselectingthevolumeintheIBMSpectrumProtectrecoveryagentGUIandclickingDismount.
34IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuideChapter4.
TuningscheduledVMbackupsforWindowsServer2012and2012R2clustersBeginningwithDataProtectionforMicrosoftHyper-VVersion8.
1.
2,youcanbackupmorevirtualmachines(VMs)inparallelandacrossnodesinacluster.
Aclusternodebackupoperationalwaysretriesthesnapshotonvolumeswithsnapshotsthatfailedwitharecoverablecondition.
YoucanalsotunethenumberofVMsinasnapshottoreducetheworkloadofasnapshotfortheHyper-Vhost.
Youcanusethefollowingoptionstotunehowsnapshotsaretakenduringthebackup:vUsethevmmaxparalleloptiontocontrolhowmanyVMsaresentinparalleltotheIBMSpectrumProtectserver.
Thesettingforthisoptionhasthemostnotableimpactonperformance.
vUsethevmmaxpersnapshotoptiontocontrolhowmanyVMscanbeincludedineachsnapshotthatiscreatedduringthebackupoperation.
Beforeyoubackupacluster,reviewandtunethevaluesforthesetwooptionsfortheenvironment.
Usethefollowinggeneralapproachtotuneyourclusterbackupoperations:1.
PlantouseanappropriatelysizedandconfiguredIBMSpectrumProtectserverthatusescontainerpools.
Forinformationabouthowtosizetheserver,seeIBMSpectrumProtectBlueprints.
2.
Asastartingpoint,usethedefaultvaluesforthevmmaxpersnapshotandvmmaxparalleloptions.
3.
Runthebackupscheduleandnotetheresults,suchaswhetherbackupscompletedwithintheschedulewindoworwhethertoomanysnapshotretriesoccurred.
4.
Adjustthevalueforthevmmaxparalleloptiontoworkinyourenvironment.
Forexample,setthevalueto10.
5.
Adjustthevalueofvmmaxpersnapshottoavaluethatminimizesthenumberofretriesthatoccur.
Theretriesarereportedinthebackupstatistics.
WhenyouchooseasmallernumberofVMspersnapshot,youincreasethenumberofsnapshotsthatareneededtocompleteabackupoperation.
ThisincreaseinsnapshotscanleadtodelaysduringclusterbackupoperationsofVMsonCSVs.
Thedelayoccursbecauseonlyonesnapshotcanbecreatedatatime,andbackupoperationsofothernodesintheschedulearedelayedduringsnapshotcreation.
ByincreasingthenumberofVMsinasnapshot,youcanreducethenumberofsnapshotsthataretakenforabackupoperation.
TodeterminethenumberofVMstoincludeinasnapshot,considerthefollowingfactors:vAsnapshotwithmoreVMstakeslongertocompleteandincreasestheloadonthesystem.
AlargernumberofVMsmeansthatthesnapshotpersistslonger,whichcanaffectsystemperformance.
vThevmmaxpersnapshotandvmmaxparalleloptionsworktogethertodeterminehowmanysnapshotsaretakeninabackupoperation.
ThevmmaxparalleloptionspecifieshowmanyVMscanbebackedupsimultaneously.
DataProtectionforMicrosoftHyper-Vtakesasmanysnapshotsasneededtomeetthevmmaxparallelsetting.
CopyrightIBMCorp.
2011,201735|||||||||||||||||||||||||||||||||||||||||||||||VMsaresortedandselectedbasedonthevolumesthatareneededtocreatethesnapshotfortheVMs.
AsnapshotiscreatedforasetofVMsthatshareasetofvolumes.
Thus,thenumberofsnapshotsvariesdependinguponthevolumesthatareusedbytheVMs.
ThenumberofVMspersnapshotneverexceedsthevalueforthevmmaxpershapshotoption.
ThefollowingtableshowsexamplesofhowmanyVMscanbeprocessedpersnapshotwithvariousvmmaxpersnapshotandvmmaxparallelsettings.
Intheseexamples,assumethatalltheVMsareonthesamevolume.
Table3.
NumberofsnapshotsandVMs(onthesamevolume)processedwiththevmmaxpersnapshotandvmmaxparallelsettingsvmmaxpersnapshotsettingvmmaxparallelsettingNumberofsnapshotscreated1020Twosnapshotsarecreatedwith10VMseach.
WhenthenumberofVMsbeingprocessedislessthanthevmmaxparallelsetting,anothersnapshotistaken.
2020Onesnapshotiscreatedcontaining20VMs.
2010Onesnapshotiscreatedcontaining20VMs,and10VMsarebackedupduetothevmmaxparallelsettingduringthefirstrun.
Theremaining10VMsarebackedupduringthesecondrun(asecondsnapshotisnotneeded).
YoucanalsousethevmmaxsnapshotretryoptiontospecifythemaximumnumberoftimestoretryasnapshotoperationofaVMiftheinitialsnapshotfailswitharecoverablecondition.
Formoredetailedguidelinesaboutoptimizingsnapshots,seetechnote2004284.
Relatedconcepts:"LimitationsonHyper-Vbackupoperations"onpage9Relatedreference:"Vmmaxpersnapshot"onpage79"Vmmaxsnapshotretry"onpage81"Vmmaxparallel"onpage7836IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuide|||||||||||||||||||||||||||||||||||||||||||Chapter5.
CommandreferenceThefollowingsectionscontaindetailedinformationabouteachoftheclientcommandsthatareusedforIBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-Voperations.
IssuethesecommandsfromtheIBMSpectrumProtectbackup-archivecommandlineclient.
StartthecommandlineclientusingeitherofthefollowingmethodsontheWindowssystem:vGotoStart>Appsbyname>IBMSpectrumProtect>Backup-ArchiveCommandLine.
vOpenanAdministratorcommandpromptwindowandchangetothebackup-archiveclientinstallationdirectory(cd"C:\ProgramFiles\tivoli\tsm\baclient").
Rundsmc.
exe.
TocompletethesetasksfromtheIBMSpectrumProtectbackup-archiveGUI,startthebackup-archiveGUIclientusingeitherofthefollowingmethodsontheWindowssystem:vGotoStart>Appsbyname>IBMSpectrumProtect>Backup-ArchiveGUI.
vOpenanAdministratorcommandpromptwindowandchangetothebackup-archiveclientinstallationdirectory(cd"C:\ProgramFiles\tivoli\tsm\baclient").
Rundsm.
exe.
AccessrelatedGUItaskhelpusingeitherofthefollowingmethods:vSelectthehelpiconandclickHelpTopicsorGettingstarted.
vYoucanalsopresstheF1keytoopentheHelpTopicshelp.
ReadingsyntaxdiagramsToreadasyntaxdiagramforenteringacommand,followthepathoftheline.
Readfromlefttorightandfromtoptobottom.
vThesymbolindicatesthebeginningofasyntaxdiagram.
vThesymbolattheendofalineindicatesthatthesyntaxdiagramcontinuesonthenextline.
vThesymbolatthebeginningofalineindicatesthatasyntaxdiagramcontinuesfromthepreviousline.
vThesymbolindicatestheendofasyntaxdiagram.
Syntaxitems,suchasakeywordoravariable,canbe:vOntheline(requiredelement)vAbovetheline(defaultelement)vBelowtheline(optionalelement)SymbolsEnterthesesymbolsexactlyastheyappearinthesyntaxdiagram.
v*Asteriskv{}Bracesv:ColonCopyrightIBMCorp.
2011,201737v,Commav=EqualSignv-Hyphenv()Parenthesesv.
PeriodvSpacev"quotationmarkv'singlequotationmarkVariablesItalicizedlowercaseitemssuchasindicatevariables.
Inthisexample,youcanspecifyawhenyouenterthecmd_namecommand.
cmd_nameRepetitionAnarrowreturningtotheleftmeansthattheitemcanberepeated.
Acharacterwithinthearrowmeansthatyoumustseparaterepeateditemswiththatcharacter.
,repeatAfootnote(1)bythearrowreferstoalimitthattellshowmanytimestheitemcanberepeated.
,(1)repeatNotes:1Specifyrepeatupto5times.
RequiredchoicesWhentwoormoreitemsareinastackandoneofthemisontheline,youmustspecifyoneitem.
Inthisexample,youmustchooseA,B,orC.
cmd_nameABCOptionalchoicesWhenanitemisbelowtheline,thatitemisoptional.
Inthefirstexample,youcanselectAornothingatall.
38IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuidecmd_nameAWhentwoormoreitemsareinastackbelowtheline,allofthemareoptional.
Inthesecondexample,youcanchooseA,B,C,ornothingatall.
cmd_nameABCRepeatablechoicesAstackofitemsfollowedbyanarrowreturningtotheleftindicatesthatyoucanselectmorethanoneitem,orinsomecases,repeatasingleitem.
Inthisexample,youcanselectanycombinationofA,B,orC.
,cmd_nameABCDefaultsDefaultsareabovetheline.
Thedefaultisselectedunlessyouoverrideit,oryoucanselectthedefaultexplicitly.
Tooverridethedefault,includeanoptionfromthestackbelowtheline.
Inthisexample,Aisthedefault.
SelecteitherBorCtooverrideA.
Acmd_nameBCBackupVMUsethebackupvmcommandtobackupHyper-Vvirtualmachines.
YoucanbackupHyper-Vgueststhatexistonalocaldisk,aSAN-attacheddisk,aClusterSharedVolume(CSV),orgueststhatexistonaremotefileservershare.
RemotefileserversharesmustbeonaWindowsServer2012orlatersystem.
Inaddition,remotefilesharesmustbeServerMessageBlock(SMB)3.
0withtheFileServerVSSAgentServiceinstalledontheserver.
SyntaxChapter5.
Commandreference39,vmnameBackupVM,vmname:vhdx=disk_locationIFIncremental-MODE=IFFull-VMBACKUPUPDATEGUID-PREview-DETailoptionsParametersvmnameSpecifiesthenameofthevirtualmachinethatyouwanttobackup.
Tospecifymultiplevirtualmachines,separatemultiplevirtualmachinenameswithcommas(vm1,VM2,Vm5),orusethedomain.
vmfulloption.
Thenamesarecase-sensitiveandmustmatchthecapitalizationthatisshownontheHyper-VhostintheHyper-VManager>VirtualMachinesview.
Wildcardscanbeusedinvirtualmachinenames.
vmname:vhdx=disk_locationThisparameterspecifiesthevirtualmachineharddisk(VHDX)toincludeinHyper-VRCTvirtualmachinebackupoperationsonWindowsServer2016orlateroperatingsystems.
ThevmnamevariablespecifiesthenameoftheVMtobackup.
WildcardcharacterscanbeusedtoselectVMnamesthatmatchapattern.
Anasterisk(*)matchesanysequenceofcharacters.
Aquestionmark()matchesanysinglecharacter.
The:vhdx=disk_locationkeywordspecifiesthelocationoftheVMdisktoincludeinthebackupoperation.
Thedisklocationisspecifiedintheformat"controller_typecontroller_numberdisk_location_number_inside_controller".
Thecontrollertypemustbe"SCSI"or"IDE".
Forexample:dsmcbackupvm"vm1:VHDX=IDE10"YoucanobtainthedisklocationinformationintheHyper-VManager.
IntheVirtualMachinesview,right-clickaVMandclickSettings.
IntheHardwaresectionoftheSettingswindow,locatetheIDEControllerorSCIController,andclickHardDrivetoviewtheharddisksettings.
ThecontrollernumberanddisklocationaredisplayedintheControllerandLocationfields.
YoucanalsoobtainthedisklocationinformationbyrunningtheWindowsPowerShellcmdletGet-VMHardDiskDrive.
YoucanexcludeaVMdiskfrombackupoperationsbyspecifyingtheexcludeoperator(-)beforethevhdx=keyword.
Forexample,use-vhdx=toexcludeaVMdiskfromthebackupoperationofaVM:dsmcbackupvm"vm1:-VHDX=IDE10:-VHDX=SCSI01"40IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuide|||||||||||||||||||||||||IfyouspecifymultipleVMdiskstoincludeorexclude,thevhdx=or-vhdx=keywordandassociatedvaluesmustbeseparatedbycolons,withnointerveningspacecharacters.
Forexample:dsmcbackupvm"*:-VHDX=IDE10:-VHDX=SCSI01"IfyouspecifymultipleVMnamesandVMdisks,theVMnameandassociatedvaluesmustbeseparatedbysemicolons,withnointerveningspacecharacters.
Forexample:dsmcbackupvm"vm1:-VHDX=IDE10:-VHDX=SCSI01;vm2:-VHDX=IDE10:-VHDX=SCSI01"-MODEYoumustspecifythebackupmodetousewhenbackingupavirtualmachinebyaddingthe-modeparameteronthecommandline.
Thefollowingmodescanbespecified:IFFullIncremental-forever-fullmode.
Inthismode,asnapshotofallusedblocksonavirtualmachine'sdisksarebackeduptotheserver.
Thebackupincludesconfigurationinformation,andallofthedisks.
IFIncrementalIncremental-forever-incremental.
Inthismode,asnapshotiscreatedoftheblocksthathavechangedsincethelastincrementalforeverbackupoperation,whetherfullorincremental.
Thebackupincludesconfigurationinformation,andallofthedisks.
-VMBACKUPUPDATEGUIDThisoptionupdatesthegloballyuniqueidentifier(GUID)forthevirtualmachinethatyouarebackingup.
Thisparameterisintendedforuseonlyinthefollowingscenario:YouwanttorestoreanalreadybackedupvirtualmachinenamedORION.
But,beforeyoushutdownandreplacethecopyofORIONthatisrunninginyourproductionenvironment,youwanttoverifytheconfigurationoftherestoredvirtualmachinebeforeyouuseittoreplacetheexistingORION.
1.
YourestoretheORIONvirtualmachineandgiveitanewname:dsmcrestorevmOrion-vmname=Orion22.
YouupdateandverifytheORION2virtualmachineanddeterminethatitisreadytoreplacetheexistingvirtualmachinethatisnamedORION.
3.
YoupowerdownanddeleteORION.
4.
YourenameORION2soitisnownamedORION.
5.
ThenexttimethatyoubackupORION,byusingeitheranincremental-foreverfull,orincremental-forever-incrementalbackup,youaddthe-VMBACKUPUPDATEGUIDparametertothebackupvmcommand.
ThisoptionupdatestheGUID,ontheIBMSpectrumProtectserver,sothenewGUIDisassociatedwiththestoredbackupsfortheORIONvirtualmachine.
Thechainofincrementalbackupsispreserved;thereisnoneedtodeleteexistingbackupsandreplacethemwithnewbackups.
-PREViewThisparameterdisplaysadditionalinformationaboutavirtualmachine,includingthelabelsofthevirtualharddisksthatareinthevirtualmachine.
Chapter5.
Commandreference41||||||||Whenyouissuethe-previewoption,thebackupoperationdoesnotstart.
Youmustissuethebackupcommandwithoutthe-previewoptiontostartthebackupoperation.
Youcanuseboththe-previewoptionandthe-detailoptiononthecommandtodisplayinformationaboutsubdisksthatareincludedwhenthebackupisrun.
AsubdiskistheAVHDXfilethatiscreatedwhenasnapshotistakenofaVHDXfile.
-DETailThisparameterdisplaysdetailedinformationaboutavirtualmachine.
Usethisoptionwith-previewtoviewmoredetailsaboutthedisksthatareinvolvedinthebackupoperation.
Whenyouissuethe-detailoption,thebackupoperationdoesnotstart.
Youmustissuethebackupcommandwithoutthe-detailoptiontostartthebackupoperation.
ExamplecommandsThefollowingcommandstartsanincremental-foreverincrementalbackupofaHyper-Vvirtualmachinethatisnamed"VM1":dsmcbackupvmVM1-mode=ifincrementalForWindowsServer2016orlateroperatingsystems:ThefollowingcommandexcludesanIDEdisk(withcontrollernumber1anddisklocation0)andaSCSIdisk(withcontrollernumber0anddisklocation1)fromanincremental-foreverincrementalHyper-VRCTbackupofavirtualmachine,"vm2":dsmcbackupvm"vm2:-VHDX=IDE10:-VHDX=SCSI01"-mode=ifincrementalForWindowsServer2016orlateroperatingsystems:ThefollowingcommandshowsthepreviewofaHyper-VRCTbackupofavirtualmachine,"VM05":dsmcbackupvmVM05-mode=ifincremental-previewInthecommandoutput,the-previewparameterdisplaystheVHDXlabelsinthevirtualmachine.
Whenthe-detailparameterisspecifiedwiththe-previewparameter,noadditionalinformationisshownforHyper-VRCTbackups.
42IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuide|||||||||||BackupVMcommandstarted.
Totalnumberofvirtualmachinestoprocess:11.
VMName:VM05DomainKeyword:VM05Mode:IncrementalForever-IncrementalTargetNodeName:NODE14DataMoverNodeName:NODE14ClusterResource:NoDisk[1]Name:\\node14\d$\Hyper_V_Virtual_Machine\VM05\VirtualHardDisks\VM05.
vhdxCapacity:15.
00GBSize:10.
91GBStatus:includedDiskType:VHDXNumberofSubdisk:0ControllerLocation:IDE00Disk[2]Name:\\node14\d$\Hyper_V_Virtual_Machine\VM05\VirtualHardDisks\VM05_Disk2.
vhdxCapacity:2.
00GBSize:132.
00MBStatus:includedDiskType:VHDXNumberofSubdisk:0ControllerLocation:SCSI01Totalnumberofvirtualmachinesprocessed:1ForWindowsServer2012or2012R2:Thefollowingcommandstartsanincrementalforever-incrementalbackupofaHyper-Vvirtualmachine,"VM3":dsmcbackupvmVM3-mode=ifincremental-previewInthecommandoutput,the-previewparameterdisplaystheVHDXlabelsinthevirtualmachine:VMName:VM3DomainKeyword:all-vmMode:IncrementalForever-IncrementalTargetNodeName:NODE1DataMoverNodeName:NODE1ClusterResource:YesDisk[1]Name:c:\ClusterStorage\Volume1\Hyper-V\VM3\VM3.
VHDXCapacity:40.
00GBSize:9.
09GBFullBackup:includedIncrementalBackup:excludedDiskType:VHDXNumberofSubdisk:1Disk[2]Name:c:\ClusterStorage\Volume3\Hyper-V\VM3\VM3-DISK2.
VHDXCapacity:127.
00GBSize:4.
00MBFullBackup:includedIncrementalBackup:excludedDiskType:VHDXNumberofSubdisk:1Whenthe-detailparameterisspecifiedwiththe-previewparameter,theVHDXlabelsandtheirsubdisksareshown.
Thefollowingexampleoutputisabbreviatedtoshowonlyinformationaboutonevirtualmachineandonedisk:Chapter5.
Commandreference43||||||||||||||||||||||||||||||||VMName:VM3DomainKeyword:all-vmMode:IncrementalForever-IncrementalTargetNodeName:NODE1DataMoverNodeName:NODE1ClusterResource:YesDisk[1]Name:c:\ClusterStorage\Volume1\Hyper-V\VM3\VM3.
VHDXCapacity:40.
00GBSize:9.
09GBFullBackup:includedIncrementalBackup:excludedDiskType:VHDXNumberofSubdisk:1Subdisk[1]Name:c:\ClusterStorage\Volume1\Hyper-V\VM3\VM3_9B26166-9C3E.
avhdxCapacity:40.
00GBSize:1.
25GBFullBackup:includedIncrementalBackup:includedDiskType:AVHDXOptionsfileexamplesInthefollowingexamples,thedomain.
vmfulloptionisusedtoprocessspecificvirtualmachines.
ForWindowsServer2016orlateroperatingsystems:Inthefollowingexample,thedomain.
vmfulloptionisspecifiedasfollows:domain.
vmfullVM04,VM05ThefollowingcommandshowsapreviewofaHyper-VRCTbackupofallvirtualmachinesspecifiedinthedomain.
vmfulloption.
Thecommanddisplayspreviewinformationabouteachvirtualmachine:dsmcbackupvm-mode=iffull-previewThefollowingoutputisshown:44IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuide||||||||BackupVMcommandstarted.
Totalnumberofvirtualmachinestoprocess:21.
VMName:VM04DomainKeyword:VM04Mode:IncrementalForever-FullTargetNodeName:NODE14DataMoverNodeName:NODE14ClusterResource:NoDisk[1]Name:\\node14\d$\Hyper_V_Virtual_Machine\VM04\VirtualHardDisks\VM04.
vhdxCapacity:36.
00GBSize:9.
16GBStatus:includedDiskType:VHDXNumberofSubdisk:0ControllerLocation:IDE002.
VMName:VM05DomainKeyword:VM05Mode:IncrementalForever-FullTargetNodeName:NODE14DataMoverNodeName:NODE14ClusterResource:NoDisk[1]Name:\\node14\d$\Hyper_V_Virtual_Machine\VM05\VirtualHardDisks\VM05.
vhdxCapacity:15.
00GBSize:10.
91GBStatus:includedDiskType:VHDXNumberofSubdisk:0ControllerLocation:IDE00Disk[2]Name:\\node14\d$\Hyper_V_Virtual_Machine\VM05\VirtualHardDisks\VM05_Disk2.
vhdxCapacity:2.
00GBSize:132.
00MBStatus:includedDiskType:VHDXNumberofSubdisk:0ControllerLocation:SCSI01Totalnumberofvirtualmachinesprocessed:2ForWindowsServer2012or2012R2:Inthefollowingexample,thedomain.
vmfulloptionspecifiesthesevirtualmachines:domain.
vmfullBigVM,myGentoox64,HPV2VM3-OLD,Local10Thefollowingcommandshowsapreviewofanincremental-foreverincrementalbackupoperationofallHyper-Vvirtualmachinesspecifiedinthedomain.
vmfulloption.
Thecommanddisplayspreviewinformationabouteachvirtualmachine:dsmcbackupvm-mode=iffull-previewThefollowingoutputisshown:Chapter5.
Commandreference45|||||||||||||||||||||||||||||||||||||||||||||||||1.
VMName:BigVMDomainKeyword:all-vmMode:IncrementalForever-FullTargetNodeName:MSFDataMoverNodeName:MSFClusterResource:NoDisk[1]Name:\\lingonberry\c$\Users\michael\Documents\Storage\BigVM.
vhdxCapacity:5.
85TBSize:5.
00MBFullBackup:includedIncrementalBackup:excludedDiskType:VHDXNumberofSubdisk:02.
VMName:Gentoox64DomainKeyword:all-vmMode:IncrementalForever-FullTargetNodeName:MSFDataMoverNodeName:MSFClusterResource:No3.
VMName:HPV2VM3-OLDDomainKeyword:all-vmMode:IncrementalForever-FullTargetNodeName:MSFDataMoverNodeName:MSFClusterResource:No4.
VMName:Local10DomainKeyword:all-vmMode:IncrementalForever-FullTargetNodeName:MSFDataMoverNodeName:MSFClusterResource:NoDisk[1]Name:\\lingonberry\c$\Users\michael\Documents\Storage\Local10.
vhdxCapacity:127.
00GBSize:4.
00MBFullBackup:includedIncrementalBackup:excludedDiskType:VHDXNumberofSubdisk:0Totalnumberofvirtualmachinesprocessed:4ANS1900IReturncodeis0.
ANS1901IHighestreturncodewas0.
RelatedlinksforbackingupHyper-Vvirtualmachinesv"Detail"onpage57v"Domain.
vmfull"onpage57v"Mbobjrefreshthresh"onpage69v"Mbpctrefreshthresh"onpage70v"Mode"onpage68v"QueryVM"onpage48v"RestoreVM"onpage5246IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuideExpireTheexpirecommanddeactivatesthebackupobjectsthatyouspecifyinthefilespecificationorwiththefilelistoption.
Youcanspecifyanindividualfiletoexpire,orafilethatcontainsalistoffilestoexpire.
IfOBJTYPE=VM,thiscommanddeactivatesthecurrentbackupforavirtualmachine.
Whenyouareworkingininteractivemode,apromptnotifiesyoubeforefilesareexpired.
Theexpirecommanddoesnotremoveworkstationfiles.
Ifyouexpireafileordirectorythatstillexistsonyourworkstation,thefileordirectoryisbackedupagainduringthenextincrementalbackup,unlessyouexcludetheobjectfrombackupprocessing.
Ifyouexpireadirectorythatcontainsactivefiles,thosefilesarenotdisplayedinasubsequentqueryfromtheGUI.
However,thesefilesaredisplayedonthecommandline,ifyouspecifythecorrectquerywithawildcardcharacterforthedirectory.
Note:Becausetheexpirecommandchangestheserverpictureoftheclientfilesystemwithoutchangingtheclientfilesystem,theexpirecommandisnotallowedonfilesthatareonafilesystemthatismonitoredbytheIBMSpectrumProtectjournalservice.
SyntaxOBJTYPE=FILEfilespecEXPireOBJTYPE=VMvmnameoptionsParametersOBJTYPE=FILEfilespecSpecifiesapathandafilenamethatyouwanttoexpire.
Youcanenteronlyonefilespecificationonthiscommand.
However,youcanusewildcardstoselectagroupoffilesorallthefilesinadirectory.
Ifyouspecifythefilelistoption,thefilespecdesignationisignored.
OBJTYPE=VMvmnamevmnamespecifiesthenameofavirtualmachine.
Theactivebackupforthespecifiedvirtualmachineisexpired.
Thevirtualmachinenamecannotcontainwildcardcharacters.
Whenobjtype=VMisspecified,theexpirecommandexpiresonlyfullvirtualmachinebackups(MODE=FULLorMODE=IFFULL)forthevirtualmachinethatisspecifiedonthevmnameparameter.
Table4.
Expirecommand:RelatedoptionsOptionWheretousedateformat"Dateformat"onpage55Clientoptionsfile(dsm.
opt)orcommandline.
Chapter5.
Commandreference47Table4.
Expirecommand:Relatedoptions(continued)OptionWheretousefilelist"Filelist"onpage62Commandlineonly.
noprompt"Noprompt"onpage71Commandlineonly.
numberformat"Numberformat"onpage71Clientoptionsfile(dsm.
opt)orcommandline.
pick"Pick"onpage73Commandlineonly.
timeformat"Timeformat"onpage75Clientuser-optionsfile(dsm.
opt)orcommandline.
ExamplesTaskDeactivatetheletter1.
txtfileinthehomedirectory.
Command:dsmcexpirec:\home\letter1.
txtTaskDeactivateallfilesintheadmin\mydirdirectory.
Command:dsmcexpirec:\admin\mydir\*TaskDeactivateallfilesthatarenamedinthec:\avi\filelist.
txtfile.
Command:dsmcexpire-filelist=c:\avi\filelist.
txtTaskDeactivatethecurrentbackupofthevirtualmachinethatisnamedvm_test.
Command:dsmcexpire–objtype=VMvm_testQueryVMUsethequeryvmcommandtodeterminewhichHyper-Vvirtualmachines(VMs)werebackedup.
SyntaxQueryVMvmnameoptionsParametersvmnameSpecifiesthevirtualmachinehostnamethatyouwanttoquery.
Thevirtualmachinenameiscase-sensitive.
Ifyouspecifyavirtualmachinenameonthecommand,thenamecannotcontainwildcardcharacters.
Ifyouomitthevirtualmachinename,thecommanddisplaysallvirtualmachinebackupsontheIBMSpectrumProtectserver.
48IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuideTable5.
QueryVMcommand:RelatedoptionsforHyper-Vvirtualmachinequeries.
OptionWheretousedetail"Detail"onpage57Commandline.
Displaysthedetailsofeachdisk(label,name)anditsstatus(protectedorexcluded),andincremental-foreverbackupperformancestatistics.
inactive"Inactive"onpage63Commandline.
pitdate"Pitdate"onpage73Commandline.
pittime"Pittime"onpage74Commandline.
ExamplesTaskListallvirtualmachinesthathavebeenbackedupbyIBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VontheHyper-Vhost.
dsmcqueryvmQueryVMexamples(Hyper-V)ThefollowingexampleshowsaqueryVMcommandthatdisplayssummaryinformationaboutallHyper-Vvirtualmachinesthathavebeenbackedup.
dsmcqueryvmQueryVirtualMachineforFullVMbackup#BackupDateMgmtClassSizeTypeA/ILocationVirtualMachine103/19/201717:54:34STANDARD17.
00GBIFFULLASERVERDeptA_VM05203/20/201701:51:34STANDARD15.
00GBIFINCRASERVERDeptA_VM_W2k08R2303/20/201701:46:19STANDARD36.
00GBIFFULLASERVERDeptA_VM04ThefollowingqueryVMcommandwiththe-detailoptionshowsdetailedinformationaboutHyper-VVMsthathavebeenbackedup.
Thedetailedoutputincludesthetypeofbackupthatwasperformed,thesizeofthevirtualmachine,informationaboutitsdisks,andstatistics.
Chapter5.
Commandreference49||||dsmcqueryvm-detailQueryVirtualMachineforFullVMbackup#BackupDateMgmtClassSizeTypeA/ILocationVirtualMachine103/19/201717:54:34STANDARD17.
00GBIFFULLASERVERDeptA_VM05Thesizeofthisincrementalbackup:n/aThenumberofincrementalbackupssincelastfull:0Theamountofextradata:0TheIBMSpectrumProtectobjectsfragmentation:0Backupisrepresentedby:99IBMSpectrumProtectobjectsApplicationprotectiontype:n/aBackupiscompressed:NoBackupisdeduplicated:NoSnapshottype:Hyper-VRCTApplicationConsistentDisk[1]Name:DeptA_VM05.
vhdxDisk[1]Location:IDE00Disk[1]Status:ProtectedDisk[2]Name:DeptA_VM05_Disk2.
vhdxDisk[2]Location:SCSI01Disk[2]Status:ProtectedDisk[3]Name:Disk72.
00GBBus0Lun4Target0Disk[3]Location:SCSI00Disk[3]Status:Skipped:PhysicaldiskDisk[4]Name:Disk82.
50GBBus0Lun5Target0Disk[4]Location:SCSI02Disk[4]Status:Skipped:Physicaldisk203/20/201701:51:34STANDARD15.
00GBIFINCRASERVERDeptA_VM_W2k08R2Thesizeofthisincrementalbackup:544.
00KBThenumberofincrementalbackupssincelastfull:1Theamountofextradata:0TheIBMSpectrumProtectobjectsfragmentation:2Backupisrepresentedby:37IBMSpectrumProtectobjectsApplicationprotectiontype:n/aBackupiscompressed:NoBackupisdeduplicated:NoSnapshottype:Hyper-VRCTCrashConsistentDisk[1]Name:DeptA_VM_W2k08R2.
vhdxDisk[1]Location:IDE00Disk[1]Status:Protected303/20/201701:46:19STANDARD36.
00GBIFFULLASERVERDeptA_VM04Thesizeofthisincrementalbackup:n/aThenumberofincrementalbackupssincelastfull:0Theamountofextradata:0TheIBMSpectrumProtectobjectsfragmentation:0Backupisrepresentedby:79IBMSpectrumProtectobjectsApplicationprotectiontype:n/aBackupiscompressed:NoBackupisdeduplicated:NoSnapshottype:Hyper-VRCTApplicationConsistentDisk[1]Name:DeptA_VM04.
vhdxDisk[1]Location:IDE00Disk[1]Status:ProtectedAllaveragesarecalculatedonlyforincrementalforeverbackupsdisplayedabove.
Theaveragesizeofincrementalbackup:544.
00KBTheaveragenumberofincrementalbackupssincelastfull:0Theaverageoverheadofextradata:0Theaverageobjectsfragmentation:0Theaveragenumberofobjectsperbackup:71Thedetailedoutputalsoincludesthesnapshottypeanddiskinformationsuchasthefollowinginformation:SnapshottypeThetypeofsnapshotthatwastakenduringtheVMbackupoperation:50IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuide|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||Hyper-VRCTApplicationConsistentAquiescedsnapshotthatwascreatedwithHyper-VResilientchangeTracking(RCT)onWindowsServer2016.
Hyper-VRCTCrashConsistentAnon-quiescedsnapshotthatwascreatedwithHyper-VRCTonWindowsServer2016.
Hyper-VVSSAsnapshotthatwascreatedwithVolumeShadowCopyService(VSS)onWindowsServer2012orWindowsServer2012R2.
Disk[n]LocationThedisklocationofVMdiskn,wherenisanumber.
Thedisklocationconsistsofthediskcontrollertype,"IDE"or"SCSI",followedbythecontrollernumberanddevicelocationnumber.
Disk[n]StatusThebackupstatusofVMdiskn,wherenisanumber.
ProtectedIndicatesthatthedataontheVMdiskisbackedup.
Skipped:ExcludedbyuserIndicatesthattheVMdiskisexcludedduringbackupoperationsasspecifiedbytheexclude.
vmdiskoption.
Formoreinformation,see"Exclude.
vmdisk"onpage60.
Skipped:PhysicaldiskIndicatesthattheVMdiskisaphysicaldisk(pass-throughdisk)anditsdataisnotbackedup.
Onlythediskconfigurationinformationisbackedup.
Formoreinformation,see"Vmprocessvmwithphysdisks"onpage83.
ThefollowingexampleshowsthesyntaxtousetolistdetailedoutputforaspecificvirtualmachinenamedDeptA_VM_W2k08R2.
dsmcqueryvmDeptA_VM_W2k08R2-detailQueryVirtualMachineforFullVMbackup#BackupDateMgmtClassSizeTypeA/ILocationVirtualMachine103/20/201701:51:34STANDARD15.
00GBIFINCRASERVERDeptA_VM_W2k08R2Thesizeofthisincrementalbackup:544.
00KBThenumberofincrementalbackupssincelastfull:1Theamountofextradata:0TheIBMSpectrumProtectobjectsfragmentation:2Backupisrepresentedby:37IBMSpectrumProtectobjectsApplicationprotectiontype:n/aBackupiscompressed:NoBackupisdeduplicated:NoSnapshottype:Hyper-VRCTCrashConsistentDisk[1]Name:Jimmy_VM_Windows2008R2.
vhdxDisk[1]Location:IDE00Disk[1]Status:ProtectedAllaveragesarecalculatedonlyforincrementalforeverbackupsdisplayedabove.
Theaveragesizeofincrementalbackup:544.
00KBTheaveragenumberofincrementalbackupssincelastfull:1Theaverageoverheadofextradata:0Theaverageobjectsfragmentation:2Theaveragenumberofobjectsperbackup:37Chapter5.
Commandreference51||||||||||||||||||||||||||RestoreVMTherestorevmcommandcanbeusedtorestoreaMicrosoftHyper-VvirtualmachinethatwaspreviouslybackedupbyIBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-V.
IfthevirtualmachinethatyouarerestoringexistsontheHyper-Vhostserver,itisshutdownanddeletedbeforeitisrestoredfromtheimagestoredontheIBMSpectrumProtectserver.
TheRestoreVMoperationthencreatesthevirtualmachinesuchthatitscontentandconfigurationisidenticaltowhatitwaswhenthebackupoccurred.
Eventhoughtheclientshutsdownthevirtualmachinebeforedeletingit,manuallyshuttingdownthevirtualmachinebeforerunningRestoreVMisagoodpracticetobringanyin-progressapplicationactivitiestoanorderlystop.
SyntaxREStoreVMsourcevmspec-targetpath=path-vmname=new_vm_nameoptionsParametersThesourcevmspecparameterisrequired.
Theotherparametersareoptional.
Considerthefollowingscenariostodeterminetheparameterstouse:vTorestorethevirtualmachinetotheoriginalpathusingtheoriginalvirtualmachinename,useonlythesourcevmspecparameter.
ThevirtualmachineisrestoredwithitsoriginalVMwareGUID.
vTorestorethevirtualmachinetoanalternatepathusingtheoriginalvirtualmachinename,usethesourcevmspecand-targetpathparameters.
ThevirtualmachineisrestoredtothespecifiedpathwithanewVMwareGUID.
Thevirtualmachineintheoriginalpathisnotdeleted.
vTorestorethevirtualmachinetoanalternatepathusinganewvirtualmachinename,usethesourcevmspec,-targetpath,and-vmnameparameters.
ThevirtualmachineisrestoredtothespecifiedpathwiththenewnameandanewVMwareGUID.
Thevirtualmachinewiththeoriginalnameintheoriginalpathisnotdeleted.
The-vmnameparameterisvalidonlyforrestoringvirtualmachinesthatwerebackedupbyusingiffullorifincrementalmodes.
Thisparameterisignoredforvirtualmachinesthatwerebackedupbyusingthefullorincrementalmodesthatwereprovidedinpreviousproductreleases.
sourcevmspecSpecifiesthenameofthevirtualmachineyouwanttorestore.
Thevirtualmachinenameiscase-sensitive.
Youcannotusewildcardsinthevirtualmachinename.
-targetpath=pathSpecifiesthepaththatyouwanttorestorethevirtualmachineto.
Thisparameterisrequiredifthe-vmnameparameterisusedandoptionalotherwise.
Usethisparametertorestorethevirtualmachinetoanalternatepath.
52IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuide-vmname=new_vm_nameSpecifiesanewnameforthevirtualmachine.
Thenamecancontain1-100characters.
Thefollowingcharactersarenotvalid:Thisparameterrequiresthe-targetpathparameter.
Table6.
RestoreVMcommand:RelatedoptionswhenrestoringHyper-VvirtualmachinesOptionWheretouseinactiveCommandlinepickCommandlinepitdateCommandlinepittimeCommandlinereplaceCommandline,clientoptionsfile,orclientpreferenceseditor.
vmbackdirCommandline,clientoptionsfile.
ExamplesTaskRestorethemostrecentbackupversionofavirtualmachinenamedmyVM.
dsmcrestorevmmyvmChapter5.
Commandreference5354IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuideChapter6.
OptionsreferenceThefollowingsectionscontaindetailedinformationabouteachoftheclientoptionsthatareusedforIBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-Voperations.
Informationforeachoptionincludesthefollowinginformation:vadescriptionvasyntaxdiagramvdetaileddescriptionsoftheparametersvexamplesofusingtheoptionintheclientoptionsfile(ifapplicable)vexamplesofusingtheoptiononthecommandline(ifapplicable)Optionswithacommand-lineexampleofDoesnotapplycannotbeusedwithcommandlineorscheduledcommands.
DateformatThedateformatoptionspecifiestheformatyouwanttousetodisplayorenterdates.
Usethisoptionifyouwanttochangethedefaultdateformatforthelanguageofthemessagerepositoryyouareusing.
Bydefault,thebackup-archiveandadministrativeclientsobtainformatinformationfromthelocaledefinitionineffectatthetimeyoustarttheclient.
Consultthedocumentationonyourlocalsystemfordetailsaboutsettingupyourlocaledefinition.
Youcanusethedateformatoptionwiththeexpirecommand.
Whenyouincludethedateformatoptionwithacommand,itmustprecedethefromdateandpitdateoptions.
OptionsFilePlacethisoptionintheclientoptionsfile(dsm.
opt).
YoucansetthisoptionontheRegionalSettingstab,DateFormatdrop-downlistofthePreferenceseditor.
SyntaxDATEformatformat_numberParametersformat_numberDisplaysthedateusingoneofthefollowingformats.
Selectthenumberthatcorrespondstothedateformatyouwanttouse:1MM/DD/YYYYThisisthedefaultforthefollowingavailabletranslations:CopyrightIBMCorp.
2011,201755vUSEnglishvChinese(Traditional)vKorean2DD-MM-YYYYThisisthedefaultforthefollowingavailabletranslations:vBrazilianPortuguesevItalian3YYYY-MM-DDThisisthedefaultforthefollowingavailabletranslations:vJapanesevChinese(Simplified)vPolish4DD.
MM.
YYYYThisisthedefaultforthefollowingavailabletranslations:vGermanvFrenchvSpanishvCzechvRussian5YYYY.
MM.
DDThisisthedefaultforthefollowingavailabletranslations:vHungarian6YYYY/MM/DD7DD/MM/YYYYExamplesOptionsfile:dateformat3Commandline:-date=3Thisoptionisvalidontheinitialcommandlineandininteractivemode.
Ifyouusethisoptionininteractivemode,itaffectsonlythecommandwithwhichitisspecified.
Whenthatcommandcompletes,thevaluerevertstothevalueatthebeginningoftheinteractivesession.
Thisisthevaluefromthedsm.
optfileunlessoverriddenbytheinitialcommandlineorbyanoptionforcedbytheserver.
AdditionalconsiderationsforspecifyingtimeanddateformatsThedateortimeformatyouspecifywiththisoptionmustbeusedwhenusingoptionsthattakedateandtimeasinput.
Examplesare:totime,fromtime,todate,fromdate,andpittime.
Forexample,ifyouspecifythetimeformatoptionasTIMEFORMAT4,thevaluethatyouprovideonthefromtimeortotimeoptionmustbespecifiedasatimesuchas12:24:00pm.
Specifying13:24:00wouldnotbevalidbecauseTIMEFORMAT4requiresanhourintegerthatis12orless.
Ifyouwanttospecifyupto24hourvaluesonanoption,andifyouwanttousecommasasseparators,youmustspecifyTIMEFORMAT2.
56IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuideDetailUsethedetailoptiontodisplaymanagementclass,filespace,andbackupinformation.
Usethedetailwiththequeryvmcommandtodisplaythefollowingstatistics:vTheaveragenumberofIBMSpectrumProtectobjectsthatareneededtodescribeasinglemegablock,acrossallmegablocksinabackup.
vTheaveragenumberofIBMSpectrumProtectobjectsthatareneededtodescribeasinglemegablock,forallmegablocksinafilespace.
vThenumberofbackupsthatwerecreatedsincethelastfullbackupwascreatedfromtheproductiondisks.
Thevaluesreturnedonqueryvmcanhelpyoufinetunetheheuristics(seetheMbobjrefreshthreshandMbpctrefreshthreshoptions)tofinetunethevaluestriggerformegablockrefreshes.
SyntaxDETailParametersTherearenoparametersforthisoption.
ExamplesCommandline:dsmcqueryvm-detailDomain.
vmfullThedomain.
vmfulloptionspecifiesthevirtualmachines(VMs)toincludeinyourfullvirtualmachineimagebackupoperations.
Domain.
vmfullforMicrosoftHyper-VvirtualmachinesForHyper-VVMbackups,usethedomain.
vmfulloptiontospecifywhichHyper-VVMsareprocessedwhenyourunabackupvmcommand,withoutspecifyinganyHyper-VVMnames.
YoucanspecifywhichVMstoprocessbyusinganyofthefollowingtechniques:vUsetheVM=optionandspecifythenameofavirtualmachine.
vProvideacomma-separatedlistofvirtualmachinenames.
vUsewildcardsyntaxtoprocessvirtualmachinesthatmatchthenamepattern.
vUsethevmname:vhdx=optiontospecifytheVMharddisk(VHDX)toincludeorexcludeduringtheHyper-VRCTbackupoperationofaVM.
vUsetheall-vmdomain-levelparameter.
YoucanalsoincludeoneormorevirtualmachinesbyusingtheVM=keyword,orexcludeVMsbyusingthe-VM=syntax.
Chapter6.
Optionsreference57||Thevirtualmachinesthatarespecifiedonthedomain.
vmfulloptionareprocessedonlywhenthebackupvmcommandisenteredwithoutspecifyingavirtualmachineoralistofvirtualmachinesonthecommandline.
Attention:ForMicrosoftHyper-Voperations,theonlyvaliddomain-levelparameterforthedomain.
vmfulloptionisall-vm.
YoucanalsoincludeoneormorevirtualmachinesbyusingtheVM=keyword,orexcludevirtualmachinesbyusingthe-VM=syntax.
SupportedClientsThisoptioncanbeusedwithsupportedWindowsclients.
Thisoptioncanalsobedefinedontheserver.
OptionsfileSetthisoptionintheclientoptions,byusingthecommandline,orbyusingtheVMBackuptabofthePreferenceseditor.
Restriction:Thevmname:vhdx=vhdx_locationparametercannotbesetinthePreferencesEditor.
Includethissettingintheoptionsfile,oronthecommandlinewhenyourunabackupvmcommand:SyntaxforMicrosoftHyper-Vvirtualmachines;vmname1,vmname2DOMAIN.
VMFUllVM=vmname1,vmname2-VM=vmname1,vmname2vmname:vhdx=disk_location-vmname:vhdx=disk_locationALL-VMSyntaxrules:Multiplekeywordsmustbeseparatedbyasemicolon.
Therecannotbeanyspacesafterthesemicolons.
Multiplemachineordomainnamesmustbeseparatedbycommas,withnospacecharacters.
Forexamples,seevm=vmname.
ParametersvmnameDefinesthevirtualmachinenamethatyouwanttoprocess.
Youcansupplyalistofvirtualmachinehostnamesbyseparatingthenameswithcommas(vm1,VM2,Vm5).
Thenamesarecase-sensitiveandmustmatchthecapitalizationthatisshownontheHyper-VhostintheHyper-VManager>VirtualMachinesview.
vm=vmnameThevm=keywordspecifiesthatthenextsetofvaluesisalistofvirtualmachinenames.
Thevm=keywordisthedefaultandisnotrequired.
Inthisexample,vm=isnotspecifiedandcommasareusedtoseparatethemachinenames.
domain.
vmfullmy_vm1,my_vm258IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuideIfyouspecifymultiplekeywords,suchasvm=and-vm=,thevaluesthatthekeywordsrefertomustbeseparatedbysemicolons,withnointerveningspacecharacters:domain.
vmfullvm=my_vm1;vm=my_vm2domain.
vmfull-vm=my_vm3;-vm=my_vm4Wildcardcharacterscanbeusedtoselectvirtualmachinenamesthatmatchapattern.
Anasterisk(*)matchesanysequenceofcharacters.
Aquestionmark()matchesanysinglecharacter,forexample:vExcludeallfilesthathave"test"inthehostname:-vm=*test*vIncludeallvirtualmachineswithnamessuchas:"test20","test25","test29","test2A":vm=test2Youcanexcludeavirtualmachinefromabackupoperationbyspecifyingtheexcludeoperator(-)beforethevm=keyword.
Forexample,-vmisusedtoexcludeaparticularmachine,ormachines,fromadomainlevelbackup,suchas,ALL-VM.
If"vm1"isthenameofavirtualmachine,youcanbackupallofthevirtualmachinesinthedomain,butpreventthevirtualmachine"vm1"frombeingbackedup.
Setthefollowingoption:domain.
vmfullall-vm;-vm=vm1Youcannotusetheexcludeoperator(-)toexcludeadomain,suchasALL-VM.
Theexcludeoperatorworksonlyatthevirtualmachinenamelevel.
vmname:vhdx=vhdx_locationThisoptionspecifiesthelocationofthevirtualmachineharddisk(VHDX)toincludeinHyper-VRCTvirtualmachinebackupoperationsontheWindowsServer2016operatingsystem.
Thevmnamevariablespecifiesthenameofthevirtualmachinetobackup.
Wildcardcharacterscanbeusedtoselectvirtualmachinenamesthatmatchapattern.
Anasterisk(*)matchesanysequenceofcharacters.
Aquestionmark()matchesanysinglecharacter.
The:vhdx=disk_locationkeywordspecifiesthelocationofthevirtualmachinedisktoincludeinthebackupoperation.
Thedisklocationspecifiedbythedisk_locationvariablemustbeginwith"SCSI"or"IDE"followedbythecontrollernumberanddevicelocationnumber.
Forexample:domain.
vmfull"vm1:VHDX=IDE10"domain.
vmfull"vm*:VHDX=SCSI01"domain.
vmfull"vm:VHDX=SCSI01"Youcanexcludeavirtualmachinediskfrombackupoperationsbyspecifyingtheexcludeoperator(-)beforethevhdx=keyword.
Forexample,use-vhdx=toexcludeaVMdiskfromthebackupoperationofavirtualmachine.
Forexample:domain.
vmfull"vm1:-VHDX=IDE10"Ifyouspecifymultiplevirtualmachinediskstoincludeorexclude,thevhdx=or-vhdx=keywordandassociatedvaluesmustbeseparatedbycolons,withnointerveningspacecharacters.
Forexample:domain.
vmfull"vm1:vhdx=IDE10:vhdx=SCSI01"Ifyouspecifymultiplevirtualmachinenamesandvirtualmachinedisks,theVMnameandassociatedvaluesmustbeseparatedbysemicolons,withnointerveningspacecharacters.
Forexample:domain.
vmfull"vm1:VHDX=IDE10:VHDX=SCSI01;vm2:VHDX=IDE10:VHDX=SCSI01"domain.
vmfull"vm1:-VHDX=IDE10:-VHDX=SCSI01;vm2:-VHDX=IDE10:-VHDX=SCSI01"Chapter6.
Optionsreference59|||||||||||||||||||||||||||||all-vmThisoptionspecifiesthatabackupvmoperationprocessesallHyper-VvirtualmachinesthatareknowntotheHyper-Vhost.
ExamplesforMicrosoftHyper-VvirtualmachinesOptionsfile:IncludeallvirtualmachinesinfullVMbackupoperations.
domain.
vmfullall-vmIncludeallvirtualmachinesinfullVMbackupoperations,exceptfortheonesthathaveanamesuffixof_test.
domain.
vmfullall-vm;-vm=*_testIncludeallvirtualmachinesinfullVMbackupoperations,butexcludevirtualmachinestestvm1andtestmvm2.
domain.
vmfullall-vm;-VM=testvm1,testvm2IncludeIDEdisks(withcontroller1anddisklocation0)andSCSIdisks(withcontroller0anddisklocation1)inHyper-VRCTbackupoperationsofvirtualmachinesvm1andvm2.
domain.
vmfull"vm1:VHDX=IDE10:VHDX=SCSI01;vm2:VHDX=IDE10:VHDX=SCSI01"Restriction:Youcannotusetheall-vmoptiontogetherwiththevmname:-vhdx=optionintheoptionsfileoronthecommandline.
Exclude.
vmdiskTheEXCLUDE.
VMDISKoptionexcludesavirtualmachinediskfrombackupoperations.
TheEXCLUDE.
VMDISKoptionspecifiesthelabelofavirtualmachine'sdisktobeexcludedfromabackupvmoperation.
Ifyouexcludeadiskonthebackupvmcommand,thecommand-lineparametersoverrideanyEXCLUDE.
VMDISKstatementsintheoptionsfile.
EXCLUDE.
VMDISKforMicrosoftHyper-VvirtualmachinesUsetheEXCLUDE.
VMDISKoptiontoexcludeavirtualmachinediskfromHyper-VRCTbackupoperationsonWindowsServer2016orlateroperatingsystems.
DuringaVMrestoreoperation,aninformationalmessageisdisplayedtoindicatethataVMdiskisnotrestoredbecauseitwasexcludedduringthebackupoperation.
Therestoreoperationalsoverifieswhethertheoriginaldiskfilestillexistsintherestoredestinationfolder.
Iftheoriginaldiskfilestillexists,itisreconnectedtotherestoredVM.
Otherwise,anemptydiskfileiscreatedwiththesameattributes(suchasfilename,disksize,andblocksize)andtheemptydiskfileisconnectedtotherestoredVM.
Afterarestoreoperation,thecontrolleranddiskorderintherestoredVMremainsthesameastheoriginalVM.
YoudonothavetoadjustthedisklocationintheEXCLUDE.
VMDISKoptionforfuturebackupoperationsoftherestoredVM.
However,ifyouremoveaSCSIcontrollermanually,allsubsequentSCSIcontrollers'numbersarechanged.
Forexample,ifyouremove"SCSI0",thenextSCSIcontroller(previously"SCSI1")becomes"SCSI0".
Inthiscase,youmustupdatetheVMdisklocationintheEXCLUDE.
VMDISKoption.
60IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuide||||||||||||||||||||||||||||||Thedisklocationinformationsuchas"SCSI00"isdisplayedinmessagesforbackup,restore,andqueryoperations.
SupportedclientsThisoptioncanbeusedwithWindowsServer2016orlaterclients.
OptionsfileSetthisoptionintheclientoptionsfile.
Command-lineparametersoverridestatementsintheoptionsfile.
SyntaxEXCLUDE.
VMDISKvmnamedisk_locationParametersvmnameSpecifiesthenameoftheVMthatcontainsadiskthatyouwanttoexcludefromabackupvmoperation.
Thenameisthevirtualmachinedisplayname.
YoucanspecifyonlyoneVMnameoneachEXCLUDE.
VMDISKstatement.
SpecifyadditionalEXCLUDE.
VMDISKstatementsforeachVMdisktoexclude.
TheVMnamecancontainanasterisk(*)tomatchanycharacterstring,andaquestionmark()tomatchanyonecharacter.
IftheVMnamecontainsspacecharacters,surroundthenamewithquotationmarks("").
Tip:IftheVMnamecontainsspecialcharacters,suchasbracketcharacters([)or(]),theVMnamemightnotbecorrectlymatched.
IfaVMnameincludesspecialcharacters,useaquestionmark()torepresentthespecialcharacters.
Forexample,toexcludeaSCSIvirtualmachinediskfromthebackupofaVMnamed"WindowsVM3[2012R2]",usethissyntaxintheoptionsfile:EXCLUDE.
VMDISK"WindowsVM32012R2""SCSI01"disk_locationSpecifythelocationofthevirtualmachineharddisk(VHDX)toexcludefromaHyper-VRCTbackupoperation.
Thedisklocationlabelmustbeginwith"SCSI"or"IDE"followedbythecontrollernumberanddevicelocationnumber.
Wildcardcharactersarenotallowed.
Tip:Usethebackupvmcommandwiththe-previewoptiontodeterminethelocationofdisksinagivenVM.
Seethe"BackupVM"topicforthesyntax.
ExamplesOptionsfileExcludetheWindowssystemdiskfromallvirtualmachinesthatbeginwithWinVMinthefollowingstatementintheoptionsfile:exclude.
vmdiskWinVM*"IDE00"Virtualmachinevm1containsavirtualmachinediskwithIDEcontrollernumber1anddevicelocation0.
Toexcludethisvirtualmachinediskfrombackupvmoperations,specifythefollowingstatementintheoptionsfile:EXCLUDE.
VMDISKvm1"IDE10"Chapter6.
Optionsreference61|||||||||||||||||||||||||||||||||||||||||||||||||||Virtualmachinevm2containsavirtualmachinediskwithSCSIcontrollernumber0anddevicelocation1.
Excludethisdiskfrombackupoperationsbyspecifyingthefollowingstatementintheoptionsfile:EXCLUDE.
VMDISKvm2"SCSI01"CommandlineThecommandlineexamplesshowtheuseoftheexclusionoperator(-)beforethevhdx=keyword,toindicatethatthediskistobeexcluded.
ExcludeanIDEdisk(withcontrollernumber1anddevicelocation0)fromthebackupoperationofvirtualmachinevm1:dsmcbackupvm"vm1:-vhdx=IDE10"ExcludeaSCSIdisk(withcontrollernumber0anddevicelocation1)fromthebackupoperationofvirtualmachinevm2:dsmcbackupvm"vm2:-vhdx=SCSI01"Restriction:Youcannotusetheall-vmoptiontogetherwiththevmname:-vhdx=optiononthecommandlineorintheoptionsfile.
Relatedreference:"BackupVM"onpage39"RestoreVM"onpage52"Domain.
vmfull"onpage57"Include.
vmdisk"onpage65FilelistUsethefilelistoptiontoprocessalistoffiles.
Youcanusethefilelistoptionwiththeexpirecommand.
TheIBMSpectrumProtectclientopensthefileyouspecifywiththisoptionandprocessesthelistoffileswithinaccordingtothespecificcommand.
Whenyouusethefilelistoption,IBMSpectrumProtectignoresallotherfilespecificationsonthecommandline.
Thefiles(entries)listedinthefilelistmustadheretothefollowingrules:vEachentrymustbeafully-qualifiedorarelativepathtoafileordirectory.
Notethatifyouincludeadirectoryinafilelistentry,thedirectoryisbackedup,butthecontentsofthedirectoryarenot.
vEachpathmustbespecifiedonasingleline.
Alinecancontainonlyonepath.
vPathsmustnotcontaincontrolcharacters,suchas0x18(CTRL-X),0x19(CTRL-Y)and0x0A(newline).
vThefilelistcanbeanMBCSfileoraUnicodefilewithallUnicodeentries.
vAnyIBMSpectrumProtectfilelistentrythatdoesnotcomplywiththeserulesisignored.
Thefollowingareexamplesofvalidpathsinafilelist:c:\myfiles\directory\file1c:\tivoli\mydir\yourfile.
doc.
.
\notes\avi\dir1.
.
\fs1\dir2\file3"d:\fs2\HaHaHa\file.
txt""d:\fs3\file.
txt"62IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuide||||||||||||||||||||Youcanusethefilelistoptionduringanopenfilesupportoperation.
Inthiscase,IBMSpectrumProtectprocessestheentriesinthefilelistfromthevirtualvolumeinsteadoftherealvolume.
Ifanentryinthefilelistindicatesadirectory,onlythatdirectoryisprocessedandnotthefileswithinthedirectory.
Ifthefilename(thefilelistspec)youspecifywiththefilelistoptiondoesnotexist,thecommandfails.
IBMSpectrumProtectskipsanyentriesinthefilelistthatarenotvalidfilesordirectories.
IBMSpectrumProtectlogserrorsandprocessingcontinuestothenextentry.
Theentriesinthelistareprocessedintheordertheyappearinthefilelist.
Foroptimalprocessingperformance,pre-sortthefilelistbyfilespacenameandpath.
Tip:IBMSpectrumProtectmightbackupadirectorytwiceifthefollowingconditionsexist:vThefilelistcontainsanentryforthedirectoryvThefilelistcontainsoneormoreentriesforfileswithinthatdirectoryvNobackupofthedirectoryexistsForexample,yourfilelistincludestheentriesc:\dir0\myfileandc:\dir0.
Ifthe\dir0directorydoesnotexistontheserver,thec:\dir0directoryissenttotheserverasecondtime.
SyntaxFILEList=filelistspecParametersfilelistspecSpecifiesthelocationandnameofthefilethatcontainsthelistoffilestoprocesswiththecommand.
Note:Whenyouspecifythefilelistoptiononthecommandline,thesubdiroptionisignored.
ExamplesCommandline:sel-filelist=c:\avi\filelist.
txtInactiveUsetheinactiveoptiontodisplaybothactiveandinactiveobjects.
Youcanusetheinactiveoptionwiththequeryvmandrestorevmcommands.
Important:Whenusingtheinactiveoptionduringarestoreoperation,alsousethepickoptionbecauseallversionsarerestoredinanindeterminateorder.
Thisoptionisimplicitwhenpitdateisused.
Chapter6.
Optionsreference63SyntaxINActiveParametersTherearenoparametersforthisoption.
ExamplesCommandline:dsmcrestorevmVM1-inactiveInclude.
vmThisoptionoverridesthemanagementclassthatisspecifiedonthevmmcoption.
Themanagementclassspecifiedonthevmmcoptionappliestoallbackups.
Youcanusetheinclude.
vmoptiontooverridethatmanagementclass,foroneormorevirtualmachines.
Theinclude.
vmoptiondoesnotoverrideoraffectthemanagementclassthatisspecifiedbythevmctlmcoption.
Thevmctlmcoptionbindsbacked-upvirtualmachinecontrolfilestoaspecificmanagementclass.
OptionsFileSetthisoptionintheclientoptionsfile.
SyntaxINCLUDE.
VMvmnamemgmtclassnameParametersvmnameRequiredparameter.
Specifiesthenameofavirtualmachinethatyouwanttobindtothespecifiedmanagementclass.
Onlyonevirtualmachinecanbespecifiedoneachinclude.
vmstatement.
However,youcanspecifyasmanyinclude.
vmstatementsasneededtobindeachvirtualmachinetoaspecificmanagementclass.
Youcanincludewildcardsinthevirtualmachinename.
Anasterisk(*)matchesanycharacterstring.
Aquestionmark()matchesasinglecharacter.
Ifthevirtualmachinenamecontainsaspacecharacter,enclosethenameindoublequotationmarks(").
Tip:Ifthevirtualmachinenamecontainsspecialcharacters,typethequestionmarkwildcardinplaceofthespecialcharacterswhenyouspecifythevirtualmachinename.
mgmtclassnameOptionalparameter.
Specifiesthemanagementclasstousewhenthespecifiedvirtualmachineisbackedup.
Ifthisparameterisnotspecified,themanagementclassdefaultstotheglobalvirtualmachinemanagementclassthatisspecifiedbythevmmcoption.
64IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuideExamplesAssumethatthefollowingmanagementclassesexistandareactiveontheIBMSpectrumProtectserver:vMCFORTESTVMSvMCFORPRODVMSvMCUNIQUEVMExample1Thefollowinginclude.
vmstatementintheclientoptionsfilebindsallvirtualmachinesthathavenamesthatbeginwithVMTESTtothemanagementclasscalledMCFORTESTVMS:include.
vmvmtest*MCFORTESTVMSExample2Thefollowinginclude.
vmstatementintheclientoptionsfilebindsavirtualmachinethatisnamedWHOPPERVM1[PRODUCTION]tothemanagementclasscalledMCFORPRODVMS:include.
vm"WHOPPERVM1PRODUCTION"MCFORPRODVMSThevirtualmachinenamemustbeenclosedinquotationmarksbecauseitcontainsspacecharacters.
Also,thequestionmarkwildcardisusedtomatchthespecialcharactersinthevirtualmachinename.
Example3Thefollowinginclude.
vmstatementintheclientoptionsfilebindsavirtualmachinethatisnamedVM1toamanagementclassthatisnamedMCUNIQUEVM:include.
vmVM1MCUNIQUEVMRelatedinformation"Vmmc"onpage82Include.
vmdiskTheINCLUDE.
VMDISKoptionincludesavirtualmachine(VM)diskinbackupoperations.
Ifyoudonotspecifyoneormoredisklabels,alldisksintheVMarebackedup.
TheINCLUDE.
VMDISKoptionspecifiesthelabelofaVMdisktobeincludedinabackupvmoperation.
Ifyouincludeadiskonthebackupvmcommand,thecommand-lineparametersoverrideanyINCLUDE.
VMDISKstatementsintheoptionsfile.
INCLUDE.
VMDISKforMicrosoftHyper-VvirtualmachinesUsetheINCLUDE.
VMDISKoptiontoincludeaVMdiskfromHyper-VRCTbackupoperationsonWindowsServer2016orlateroperatingsystems.
SupportedclientsThisoptioncanbeusedwithWindowsServer2016orlaterclients.
Chapter6.
Optionsreference65|||||||||||||OptionsfileSetthisoptionintheclientoptionsfile.
Command-lineparametersoverridestatementsintheoptionsfile.
SyntaxforMicrosoftHyper-VvirtualmachinesINCLUDE.
VMDISKvmnamedisk_locationParametersvmnameSpecifiesthenameoftheVMthatcontainsadiskthatyouwanttoincludefromabackupvmoperation.
Thenameisthevirtualmachinedisplayname.
YoucanspecifyonlyoneVMnameoneachINCLUDE.
VMDISKstatement.
SpecifyadditionalINCLUDE.
VMDISKstatementsforeachVMdisktoinclude.
TheVMnamecancontainanasterisk(*)tomatchanycharacterstring,andaquestionmark()tomatchanyonecharacter.
IftheVMnamecontainsspacecharacters,surroundtheVMnamewithquotationmarks("").
Tip:IftheVMnamecontainsspecialcharacters,suchasbracketcharacters([)or(]),theVMnamemightnotbecorrectlymatched.
IfaVMnameincludesspecialcharacters,useaquestionmark()torepresentthespecialcharacters.
Forexample,toincludeaSCSIVMdiskinthebackupofavirtualmachinenamed"WindowsVM3[2012R2]",usethissyntaxintheoptionsfile:INCLUDE.
VMDISK"WindowsVM32012R2""SCSI01"disk_locationSpecifythelocationoftheVMdisktoincludeinaHyper-VRCTbackupoperation.
Thedisklocationlabelmustbeginwith"SCSI"or"IDE"followedbythecontrollernumberanddevicelocationnumber.
Wildcardcharactersarenotallowed.
Tip:Usethebackupvmcommandwiththe-previewoptiontodeterminethelocationofdisksinagivenvirtualmachine.
Seethe"BackupVM"topicforthesyntax.
ExamplesOptionsfileVirtualmachinevm1containsanIDEVMdisk(VHDX)atcontrollernumber1anddevicelocation0.
ToincludethisVHDXinbackupvmoperations,specifythefollowingstatementintheoptionsfile:INCLUDE.
VMDISKvm1"IDE10"Virtualmachinevm2containsaSCSIVMdiskatcontrollernumber0anddevicelocation1.
IncludethisVHDXinbackupoperationsbyspecifyingthefollowingstatementintheoptionsfile:INCLUDE.
VMDISKvm2"SCSI01"CommandlineIncludeasingleIDEdisk(atcontrollernumber1anddevicelocation0)whenvirtualmachinevm1isbackedup:dsmcbackupvm"vm1:vhdx=IDE10"66IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuide|||||||||||||||||||||||||||||||||||||||||||||||||||||IncludeaSCSIdisk(atcontrollernumber0anddevicelocation1)inthebackupoperationofvirtualmachinevm2:dsmcbackupvm"vm2:vhdx=SCSI01"Relatedreference:"BackupVM"onpage39"RestoreVM"onpage52"Domain.
vmfull"onpage57"Exclude.
vmdisk"onpage60INCLUDE.
VMSNAPSHOTATTEMPTSUsetheINCLUDE.
VMSNAPSHOTATTEMPTSoptiontodeterminethetotalnumberofsnapshotattemptstotryforavirtualmachine(VM)backupoperationthatfailsduetosnapshotfailure.
SupportedClientsThisoptioncanbeusedwithsupportedWindowsclientsthatareconfiguredtobackupVMsonHyper-VhoststhatrunonWindowsServer2016operatingsystems.
OptionsFileThisoptionisvalidintheclientoptionsfile(dsm.
opt).
Itcanalsobeincludedontheserverinaclientoptionsset.
Itisnotvalidonthecommandline.
SyntaxINCLUDE.
VMSNAPSHOTATTEMPTSvmnamenum_with_quiescingnum_without_quiescingParametersvmnameArequiredpositionalparameterthatspecifiesthenameofthevirtualmachinetoattemptthetotalnumberofsnapshotsfor,ifabackupattemptfailsduetosnapshotfailure.
Thenameisthevirtualmachinedisplayname.
OnlyonevirtualmachinecanbespecifiedoneachINCLUDE.
VMSNAPSHOTATTEMPTSstatement.
However,toconfigurethetotalsnapshotattemptsforothervirtualmachines,youcanusethefollowingmethods:vForeachvirtualmachinethatyouwantthisoptiontoapplyto,specifyasmanyINCLUDE.
VMSNAPSHOTATTEMPTSstatementsasneededtoreattemptsnapshotsthatfailed.
vUsewildcardcharactersforthevmnameparametervaluetospecifyvirtualmachinenamesthatmatchthewildcardpattern.
Anasterisk(*)matchesanycharacterstring.
Aquestionmark()matchesasinglecharacter.
Ifthevirtualmachinenamecontainsaspacecharacter,enclosethenameindoublequotationmarks(").
Chapter6.
Optionsreference67|||||||||||Tip:Ifthevirtualmachinenamecontainsspecialcharacters,typethequestionmarkwildcard()inplaceofthespecialcharacterswhenyouspecifythevirtualmachinename.
num_with_quiescingApositionalparameterthatspecifiesthefollowingaction:ForHyper-VRCTbackupoperations:Thenum_with_quiescingparameterspecifiesthenumberoftimestoattemptsnapshotswithquiescingtocreateapplication-consistentbackups.
Youcanspecifyavalueintherange0-10.
Thedefaultvalueis2.
num_without_quiescingForHyper-VRCTbackupoperations:Thenum_without_quiescingoptionspecifiesthenumberoftimestoattemptsnapshotswithoutquiescingafterthespecifiednumberofattemptsinthenum_with_quiescingoptionarecompleted.
Youcanspecifyavalueintherange0-10.
Thedefaultvalueis0.
Important:WhenthisparameterisappliedtoaVMbackup,thebackupisconsideredcrash-consistent.
Asaresult,operatingsystem,filesystem,andapplicationconsistencyarenotguaranteed.
Aninclude.
vmsnapshotattempts00entryisnotvalid.
Backupoperationsrequireatleastonesnapshot.
ExamplesHyper-Vexamples:Example1Specifythefollowingstatementintheclientoptionsfiletomaketwototalsnapshotattemptsatcrash-consistentbackupsforallHyper-VVMsthatbeginwithLinuxVM:INCLUDE.
VMSNAPSHOTATTEMPTSLinuxVM*02Example2SpecifythefollowingstatementintheclientoptionsfiletotrythreesnapshotattemptsforvirtualmachineVM1:twoapplication-consistentsnapshotattempts,andiftheyfail,totryonecrash-consistentsnapshotattempt:INCLUDE.
VMSNAPSHOTATTEMPTSVM121ModeUsethemodeoptiontospecifythebackupmodetousewhenperformingspecificbackupoperations.
Youcanusethemodeoptionwiththebackupvmcommand.
thisparameterspecifieswhethertoperformafullimagebackup,anincremental-foreverfullbackup,oranincremental-forever-incrementalbackupofHyper-Vvirtualmachines.
Themodeoptionhasnoeffectonawhenbackinguparawlogicaldevice.
68IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuide||||||||||||||||||||||||||||SyntaxIFIncrementalMODE=IFFullParametersIFIncrementalSpecifiesthatyouwanttoperformanincremental-forever-incrementalbackupofaHyper-Vvirtualmachine.
Anincremental-forever-incrementalbackupbacksuponlythediskblocksthathavechangedsincethelastbackup.
Thisisthedefaultbackupmode.
Youcannotusethisbackupmodetobackupavirtualmachineiftheclientisconfiguredtoencryptthebackupdata.
IFFullSpecifiesthatyouwanttoperformanincremental-forever-fullbackupofaHyper-Vvirtualmachine.
Anincremental-forever-fullbackupbacksupallusedblocksonavirtualmachine'sdisks.
Bydefault,thefirstbackupofaHyper-Vvirtualmachineisanincremental-forever-full(mode=iffull)backup,evenifyouspecifymode=ifincremental(orletthemodeoptiondefault).
Subsequentbackupsdefaulttomode=ifincremental.
Youcannotusethisbackupmodetobackupavirtualmachineiftheclientisconfiguredtoencryptthebackupdata.
ExamplesTaskPerformanincremental-forever-fullVMbackupofaWindowsHyper-VVMnamedmsvm1dsmcbackupvmmsvm1-mode=iffullTaskPerformanincremental-forever-incrementalbackupofaWindowsHyper-VVMnamedmsvm1dsmcbackupvmmsvm1-mode=ifincrementalRelatedreference:"BackupVM"onpage39MbobjrefreshthreshThembobjrefreshthresh(megablockobjectrefreshthreshold)optionisanumberdefiningathreshold.
WhenthenumberofIBMSpectrumProtectobjectsthatareneededtodescribeany128MBmegablockexceedsthisvalue,theentiremegablockisrefreshedandtheobjectsthatwereusedtorepresentthisarea,inpreviousbackups,areexpired.
Whenyoubackupavirtualmachine,thedataisstoredontheIBMSpectrumProtectserverin128MBunits,calledmegablocks.
Ifanareaontheproductiondiskchangesandanewincrementalbackupisperformed,anewmegablockiscreatedtorepresentthechangesthatweremadetothepreviouslybackedupdata.
Becauseanewmegablockcanbecreatedwitheachincrementalbackup,eventuallythemegablockscanadverselyaffecttheperformanceoftheIBMSpectrumProtectdatabase,andtherefore,adverselyaffecttheperformanceofmostIBMSpectrumProtectoperations.
Chapter6.
Optionsreference69UsethisoptionwhenestimatingIBMSpectrumProtectobjectsthatrepresentproductiondataforeachvirtualmachinebackup.
Forexample,whenthenumberofIBMSpectrumProtectobjectsexceedthisvalue,themegablockisrefreshed.
Thisactionmeansthattheentire128-MBblockiscopiedtotheIBMSpectrumProtectserverandisrepresentedasasingleIBMSpectrumProtectobject.
Theminimumvalueis2andthemaximumvalueis8192.
Thedefaultvalueis50.
OptionsfileThisoptionisvalidintheclientoptionsfile(dsm.
opt).
Itcanalsobeincludedontheserverinaclientoptionsset.
Itisnotvalidonthecommandline.
Syntax50MBOBJREFRESHTHRESHintegerParametersTheminimumvalueyoucanspecifyis2megablocks,thelargestvalueis8192megablocks;thedefaultis50megablocks.
ExamplesSetthisoptiontotriggeramegablockrefreshwhenthenumberofobjectsneededtorepresentanupdatedmegablockexceeds20objects:MBOBJREFRESHTHRESH20MbpctrefreshthreshThembpctrefreshthresh(megablockpercentagerefreshthreshold)optionisanumberdefiningathreshold.
WhenthenumberofIBMSpectrumProtectpercentageofobjectsthatareneededtodescribeany128MBmegablockexceedsthisvalue,theentiremegablockisrefreshedandtheobjectsthatwereusedtorepresentthisarea,inpreviousbackups,areexpired.
Whenyoubackupavirtualmachine,dataisstoredontheIBMSpectrumProtectserverin128MBunits,calledmegablocks.
Ifanareaontheproductiondiskchangesandanewincrementalbackupisperformed,anewmegablockiscreatedtorepresentthechangesthatweremadetothepreviouslybackedupdata.
Becauseanewmegablockcanbecreatedwitheachincrementalbackup,eventuallythemegablockscanadverselyaffecttheperformanceoftheIBMSpectrumProtectdatabase,andtherefore,adverselyaffecttheperformanceofmostIBMSpectrumProtectoperations.
Usethisoptionwhenestimatingtheamountofadditionaldatathatisbackedupforeachvirtualmachine.
Forexample,whena128-MBblockofaproductiondiskchangesmorethanthepercentagespecified,theentire128-MBblockiscopiedtotheIBMSpectrumProtectserver.
TheblockisrepresentedasasingleIBMSpectrumProtectobject.
70IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuideOptionsfileThisoptionisvalidintheclientoptionsfile(dsm.
opt).
Itcanalsobeincludedontheserverinaclientoptionsset.
Itisnotvalidonthecommandline.
Syntax50MBPCTREFRESHTHRESHintegerParametersTheminimumvalueyoucanspecifyis1percent,thelargestvalueis99percent;thedefaultis50percent.
ExamplesSetthisoptiontotriggeramegablockrefreshwhen50percent(ormore)oftheobjectsinamegablockonaproductiondiskhavechanged:MBPCTREFRESHTHRESHOLD50NopromptThenopromptoptionsuppressestheconfirmationpromptthatispresentedbytheexpirecommand.
Usethenopromptoptionwiththeexpirecommand.
SyntaxNOPromptParametersTherearenoparametersforthisoption.
ExamplesCommandline:dsmcexpire-nopromptc:\home\project\*NumberformatThenumberformatoptionspecifiestheformatyouwanttousetodisplaynumbers.
Usethisoptionifyouwanttochangethedefaultnumberformatforthelanguageofthemessagerepositoryyouareusing.
Bydefault,formatinformationisobtainedfromthelocaledefinitionineffectatthetimetheclientiscalled.
Consultthedocumentationonyourlocalsystemfordetailsaboutsettingupyourlocaledefinition.
Youcanonlyusethenumberformatoptionwiththeexpirecommand.
Chapter6.
Optionsreference71OptionsFilePlacethisoptionintheclientuser-optionsfile(dsm.
opt).
YoucansetthisoptionontheRegionalSettingstab,NumberFormatfieldofthePreferenceseditor.
SyntaxNUMberformatnumberParametersnumberDisplaysnumbersusinganyoneofthefollowingformats.
Specifythenumber(0–6)thatcorrespondstothenumberformatyouwanttouse.
0Usethelocale-specifieddateformat.
Thisisthedefault(doesnotapplytoMacOSX).
11,000.
00Thisisthedefaultforthefollowingavailabletranslations:vUSEnglishvJapanesevChinese(Traditional)vChinese(Simplified)vKorean21,000,0031000,00Thisisthedefaultforthefollowingavailabletranslations:vFrenchvCzechvHungarianvPolishvRussian41000.
0051.
000,00Thisisthedefaultforthefollowingavailabletranslations:vBrazilianPortuguesevGermanvItalianvSpanish61'000,00ExamplesOptionsfile:num4Commandline:-numberformat=472IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuideThisoptionisvalidontheinitialcommandlineandininteractivemode.
Ifyouusethisoptionininteractivemode,itaffectsonlythecommandwithwhichitisspecified.
Whenthatcommandcompletes,thevaluerevertstothevalueatthebeginningoftheinteractivesession.
Thisisthevaluefromthedsm.
optfileunlessoverriddenbytheinitialcommandlineorbyanoptionforcedbytheserver.
PickThepickoptioncreatesalistofbackupversionsorarchivecopiesthatmatchthefilespecificationyouenter.
Fromthelist,youcanselecttheversionstoprocess.
Includetheinactiveoptiontoviewbothactiveandinactiveobjects.
Usethepickoptionwiththerestorevmcommand.
SyntaxPIckParametersTherearenoparametersforthisoption.
ExamplesCommandline:dsmcrestorevmvmfin*-pick-inactivePitdateUsethepitdateoptionwiththepittimeoptiontoestablishapointintimetodisplayorrestorethelatestversionofyourbackups.
Filesthatwerebackeduponorbeforethedateandtimeyouspecify,andwhichwerenotdeletedbeforethedateandtimeyouspecify,areprocessed.
Backupversionsthatyoucreateafterthisdateandtimeareignored.
Usethepitdateoptionwiththequeryvmandrestorevmcommands.
Whenpitdateisused,theinactiveandlatestoptionsareimplicit.
SyntaxPITDate=dateParametersdateSpecifiestheappropriatedate.
ExamplesCommandline:dsmcrestorevmvmfin3-pitdate=02/21/2014Chapter6.
Optionsreference73PittimeUsethepittimeoptionwiththepitdateoptiontoestablishapointintimetodisplayorrestorethelatestversionofyourbackups.
Filesthatwerebackeduponorbeforethedateandtimeyouspecify,andwhichwerenotdeletedbeforethedateandtimeyouspecify,areprocessed.
Backupversionsthatyoucreateafterthisdateandtimeareignored.
Thisoptionisignoredifyoudonotspecifypitdateoption.
Usethepittimeoptionwiththequeryvmandrestorevmcommands.
SyntaxPITTime=timeParameterstimeSpecifiesatimeonaspecifieddate.
Ifyoudonotspecifyatime,thetimedefaultsto23:59:59.
ExamplesCommandline:dsmcqueryvmvmfin1-pitt=06:00:00-pitd=02/03/2014SkipsystemexcludeUsetheskipsystemexcludeoptiontospecifyhowtoprocessexcludestatementsforcertainoperatingsystemfilesthattheIBMSpectrumProtectforVirtualEnvironmentsclientskipsbydefault.
Bydefault,IBMSpectrumProtectforVirtualEnvironmentsclientsskipcertainWindowsoperatingsystemfilesthatarenotnormallyrequiredforsystemrecoveryduringvirtualmachine(VM)backupoperations.
ThesefilescanincludeWindowssystemfiles,temporaryinternetfiles,andfilesintheRecycleBin.
Youcanusethisoptiontoskiptheprocessingofexcludestatementsfortheseoperatingsystemfiles.
Bynotprocessingtheseexcludestatements,thetimeittakestobackupVMsmightbereduced.
SupportclientsThisoptionisvalidforIBMSpectrumProtectforVirtualEnvironmentsclientsonWindowsoperatingsystemsonly.
OptionsfileThisoptionisvalidintheclientoptionsfile(dsm.
opt)oronthecommandline.
TheoptioncanbesetintheclientoptionsetontheIBMSpectrumProtectserver.
Syntax74IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuide|||||||||||||||||||YesSKIPSYSTemexcludeNoParametersYesSpecifythisparametertoskiptheprocessingofexcludestatementsforcertainWindowsoperatingsystemfilesduringVMbackupoperations.
Thisparameteristhedefault.
NoSpecifythisparametertoprocessexcludestatementsofWindowsoperatingsystemfiles.
WhenyouselectthisparameterandrunafilebackupoftheHyper-Vhost,theoperatingsystemfilesareexcluded.
ExamplesOptionsfileSKIPSYSTemexcludeyesCommandlinedsmcbackupvm-SKIPSYST=yesdsmcincr-skipsyst=noTimeformatThetimeformatoptionspecifiestheformatinwhichyouwanttodisplayandentersystemtime.
Usethisoptionifyouwanttochangethedefaulttimeformatforthelanguageofthemessagerepositoryyouareusing.
Bydefault,formatinformationisobtainedfromthelocaledefinitionineffectatthetimetheclientiscalled.
Consultthedocumentationonyourlocalsystemfordetailsaboutsettingupyourlocaledefinition.
Youcanonlyusethetimeformatoptionwiththeexpirecommand.
Whenyouincludethetimeformatoptionwithacommand,itmustprecedethefromtime,pittime,andtotimeoptions.
OptionsFilePlacethisoptionintheclientoptionsfile(dsm.
opt).
YoucansetthisoptionontheRegionalSettingstab,TimeFormatfieldofthePreferenceseditor.
SyntaxTIMEformatformat_numberParametersformat_numberDisplaystimeinoneoftheformatslistedhere.
Selecttheformatnumberthatcorrespondstotheformatyouwanttouse.
Whenyouincludethetimeformatoptioninacommand,itmustprecedethepittimeoption.
Chapter6.
Optionsreference75|||||||||||||||||||||||||||||||||123:00:00223,00,00323.
00.
00412:00:00A/P5A/P12:00:00ExamplesOptionsfile:timeformat4Commandline:-time=3Thisoptionisvalidontheinitialcommandlineandininteractivemode.
Ifyouusethisoptionininteractivemode,itaffectsonlythecommandwithwhichitisspecified.
Whenthatcommandcompletes,thevaluerevertstothevalueatthebeginningoftheinteractivesession.
Thisisthevaluefromthedsm.
optfileunlessoverriddenbytheinitialcommandlineorbyanoptionforcedbytheserver.
AdditionalconsiderationsforspecifyingtimeanddateformatsThedateortimeformatyouspecifywiththisoptionmustbeusedwhenusingoptionsthattakedateandtimeasinput.
Examplesare:totime,fromtime,todate,fromdate,andpittime.
Forexample,ifyouspecifythetimeformatoptionasTIMEFORMAT4,thevaluethatyouprovideonthefromtimeortotimeoptionmustbespecifiedasatimesuchas12:24:00pm.
Specifying13:24:00wouldnotbevalidbecauseTIMEFORMAT4requiresanhourintegerthatis12orless.
Ifyouwanttospecifyupto24hourvaluesonanoption,andifyouwanttousecommasasseparators,youmustspecifyTIMEFORMAT2.
VmbackdirThevmbackdiroptionspecifiesthetemporarydisklocationwheretheclientsavescontrolfilesthatarecreatedduringfullVMbackupandrestoreoperationsofMicrosoftHyper-Vvirtualmachines.
WhenaclientonadatamovernodestartsafullVMbackupofavirtualmachine,theclientcreatesmetadatainfilesthatareassociatedwiththebackedupvirtualmachineanditsdata.
Thefilesthatcontainthemetadataarereferredtoascontrolfiles.
DuringfullVMbackupoperations,themetadataissavedonadiskinthedatamovernodeuntilthebackupcompletesandboththevirtualmachinedataandthecontrolfilesaresavedtoserverstorage.
DuringafullVMrestoreoperation,thecontrolfilesarecopiedfromtheserverandaretemporarilystoredonthedatamoverdisk,wheretheyareusedtorestorethevirtualmachineanditsdata.
Afterabackuporarestoreoperationcompletes,thecontrolfilesarenolongerneededandtheclientdeletesthemfromtheirtemporarydisklocation.
ThedirectorythatisspecifiedbythisoptionmustbeonadrivethatcontainssufficientfreespacetocontainthecontrolinformationfromafullVMbackup.
76IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuideOptionsFileSetthisoptionintheclientoptionsfile,orspecifyitonthecommandlineasanoptionforthebackupvmorrestorevmcommands.
SyntaxVMBACKDirdirectoryParametersdirectorySpecifiesthepathwherethecontrolfilesarestoredonthebackupserver.
Thedefaultisc:\mnt\tsmvmbackup\fullvm\ExamplesOptionsfile:VMBACKDc:\mnt\tsmvmbackup\Commandline:dsmcbackupvm-VMBACKUPT=fullvm-VMBACKD=G:\virtual_machine\control_files\dsmcrestorevm-VMBACKUPT=fullvm-VMBACKD=G:\san_temp\VmctlmcThisoptionspecifiesthemanagementclasstousewhenbackingupvirtualmachinecontrolfiles.
Bydefault,virtualmachinecontrolfilesareboundtothedefaultmanagementclass.
Thevmmcoptioncanbeusedtospecifyadifferentmanagementclasstowhichvirtualmachinedataandvirtualmachinecontrolfilesarebound.
Thevmctlmcoptionoverridesthedefaultmanagementclassandthevmmcoptionforthevirtualmachinecontrolfiles.
Undercertainconditions,itmightbedesirableornecessarytobindthecontrolfilestoadifferentmanagementclassthanthedatafiles.
Thevmctlmcoptionisrequiredifvirtualmachinedatafilesarebackeduptotape.
Virtualmachinecontrolfilesmustbebackeduptoadisk-basedstoragepoolthatdoesnotmigratetotape.
Thestoragepoolcanbecomposedofrandomaccessvolumesandsequentialfilevolumes;thestoragepoolcanalsobeadeduplicatedpool.
Usethevmctlmcoptiontospecifyamanagementclassthatstoresdatainsuchastoragepool.
Restriction:Themanagementclassthatisspecifiedbythevmctlmcoptiondeterminesonlythedestinationstoragepoolforvirtualmachinecontrolfiles.
Retentionofthecontrolfilesisdeterminedbythevmmcoption,ifspecified,orbythedefaultmanagementclass.
Theretentionforthevirtualmachinecontrolfilesalwaysmatchestheretentionofthevirtualmachinedatafiles.
OptionsFilePlacethisoptionintheclientoptionsfiledsm.
opt.
Chapter6.
Optionsreference77SyntaxVMCTLmcclass_nameParametersclass_nameSpecifiesamanagementclassthatappliestobackingupvirtualmachinecontrolfiles.
Ifyoudonotsetthisoption,themanagementclassthatisspecifiedonthevmmcoptionisused.
Ifyoudonotsetthisoptionandthevmmcoptionisnotset,thedefaultmanagementclassofthenodeisused.
ExamplesOptionsfile:vmctlmcdiskonlymcCommandline:Doesnotapply.
VmmaxparallelThisoptionisusedtoconfigureparallelbackupsofseveralvirtualmachines,usingasingleinstanceofthebackup-archiveclient.
Thevmmaxparalleloptionspecifiesthemaximumnumberofvirtualmachinesthatcanbebackeduptotheserver,atanyonetime.
ThisoptionisvalidonlyforHyper-VbackupoperationsonWindowsServer2012and2012R2operatingsystems.
OptionsfileThisoptionisvalidintheclientoptionsfile(dsm.
opt)oronthecommandlineforBackupVM.
Itcanalsobeincludedontheserverinaclientoptionsset.
ItcannotbesetinthePreferencesEditor.
Syntax4VMMAXParallelintegerParametersintegerSpecifiesthemaximumnumberofvirtualmachinesthatcanbebackedup,atanyonetime,duringaparallelbackupoperation.
Thedefaultis4.
Themaximumis50.
Tip:Whenusingclient-sidedatadeduplication,adeduplicationsessionisstartedforeachVM.
Thisdeduplicationsessionisnotcountedasoneofthevmmaxparallelsessions.
TheMAXNUMMPserverparameterspecifiesthemaximumnumberofmountpointsanodeisallowedtouseontheserverwhenthecopydestinationofthestoragepoolisFILEorTAPE.
MAXNUMMPmustbeequaltoorgreaterthanthe78IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuide||VMMAXPARALLELsetting.
Whenmultipleinstancesoftheclientarebackingupfiles,orwhenasingleclientperformsparallelbackups,additionalmountpointsmightbeneeded.
IfthenumberofmountpointsrequestedexceedstheMAXNUMMPvalue,theserverissuesanerror(ANS0266I).
Inresponsetotheerror,theclientreducesVMMAXPARALLELtomatchthenumberspecifiedbyMAXNUMMPandcontinuesthebackupwiththereducednumberofsessions.
IfadditionalANS0266Ierrorsaredetected,theclientreducesVMMAXPARALLELby1andattemptstocontinuethebackup.
IfVMMAXPARALLELisdecrementedto1andtheclientreceivesmoreANS0266Ierrors,theclientendsthebackupandissuesthefollowingerror:ANS5228EAbackupVMoperationfailedbecauseVMMAXPARALLELwasreducedto1andtheclientstillcannotobtainaservermountpoint.
ContactyourserveradministratorifyouneedthevaluethatiscurrentlysetforMAXNUMMPincreased,soyournodecansupportadditionalparallelbackupsessions.
OnWindowsServer2012and2012R2,duringHyper-Vvirtualmachinebackups,IBMSpectrumProtectcreatesVSSsnapshotsofallvolumesthatcontainvirtualmachinedata.
BackupdataisreadfromtheVSSsnapshots,andnotfromdatathatisonthelivefilesystem.
Inmanycases,whenIBMSpectrumProtectattemptstocreateseveralsnapshotsconcurrently,theVSSsoftwareprovidermightfailtosatisfyasnapshotrequestforseveralvirtualmachines.
ThefailuresoccurbecausetheVSSsoftwaresnapshotprovidercannothandletheloadthatiscreatedbyseveralbackupsthatareattemptedinparallel.
Toavoidthisissue,useaVSShardwaresnapshotproviderinsteadofaVSSsoftwareprovider.
ExamplesOptionsfileVMMAXP10Commandlinedsmcbackupvm-vmmaxp=10Relatedreference:"BackupVM"onpage39"Domain.
vmfull"onpage57VmmaxpersnapshotUsethevmmaxpersnapshotoptiontospecifythemaximumnumberofvirtualmachines(VMs)toincludeinaHyper-Vsnapshot.
TheVMsinthesnapshotarebackeduptotheIBMSpectrumProtectserver.
ByincreasingthenumberofVMsinasnapshot,youcanreducethenumberofsnapshotsthataretakenforabackupoperation.
ThiscapabilityreducestheschedulingcontentionthatcanbeexperiencedduringclusterbackupoperationsofVMsonClusteredSharedVolumes(CSVs).
AsnapshotwithmoreVMstakeslongertocompleteandincreasestheloadonthesystem.
AlargernumberofVMsmeansthatthesnapshotpersistslonger,whichcanaffectperformance.
ThisoptionisvalidonlyforHyper-VbackupoperationsonWindowsServer2012and2012R2operatingsystems.
Chapter6.
Optionsreference79|||||||||||||SupportedclientsThisoptionisvalidforallsupportedWindowsclients.
Thisoptioncanalsobedefinedontheserver.
OptionsfileThisoptionisvalidintheclientoptionsfile(dsm.
opt)oronthecommandlinefortheBackupVMcommand.
Itcanalsobeincludedontheserverinaclientoptionsset.
ItcannotbesetinthePreferencesEditor.
Syntax20VMMAXPERSnapshotintegerParametersintegerSpecifiesthemaximumnumberofVMsthatcanbeincludedinaHyper-Vsnapshot.
Thedefaultis20.
Themaximumis100.
Theminimumis1.
IfsomeVMsresideonlocalvolumesandsomeVMsresideonClusteredSharedVolumes(CSVs),thenumberofVMsinasnapshotmightbelessthanthevmmaxpersnapshotsetting.
AsnapshotcannotcontainamixtureofVMsonlocalandCSVvolumes.
Toavoidcreatingasnapshotthatspansvolumes,thenumberofVMsinasnapshotmightbelessthanthemaximumnumberiftheVMsareondifferentvolumes.
Forexample,fourVMsareonVolumeAandoneVMisonVolumeB.
AsnapshotistakenwithonlyfourVMs(fromVolumeA)eventhoughthemaximumsettingisfive.
AsecondsnapshotistakenforVolumeB.
ExamplesOptionsfilevmmaxpersnapshot10Commandlinedsmcbackupvm-vmmaxpers=10Relatedconcepts:Chapter4,"TuningscheduledVMbackupsforWindowsServer2012and2012R2clusters,"onpage35Relatedreference:"Vmmaxsnapshotretry"onpage8180IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuide|||||||||||||||||||||||||||||||||||||||||||||||VmmaxsnapshotretryUsethevmmaxsnapshotretryoptiontospecifythemaximumnumberoftimestoretryasnapshotoperationofavirtualmachine(VM)iftheinitialsnapshotfailswitharecoverablecondition.
DuringaVMbackup,ifasnapshotofaVMfailsduetoatemporarycondition,DataProtectionforMicrosoftHyper-Vautomaticallyretriesthesnapshotoperationuptothenumberoftimesthatisspecifiedbythevmmaxsnapshotretryoption.
Ifthesnapshotstillfailsafterthemaximumnumberofretriesisreached,thesnapshotoperationfortheVMisnotretriedandthebackupattemptfails.
Forexample,arecoverableconditionmightbecausedbytwobackuprequeststhatstartedataboutthesametime,backingupVMsthatresideonthesamevolume.
OnebackupoperationreportsthatthesnapshotfailedbecausethebackupcannotbestartedwhileanotherbackupisrunningforthesameVM.
Inthiscase,DataProtectionforMicrosoftHyper-VwillretrythesnapshotoperationafterthefirstVMbackupiscompleted.
Iftheinitialerrorisnotrecoverable,asnapshotisnotattempted.
Forexample,ifanerroroccurswiththeVolumeShadowCopyServices(VSS)writerduringtheinitialsnapshotprocess,thebackupprocessingstopsandDataProtectionforMicrosoftHyper-Vdoesnotretrythesnapshotoperation.
ThisoptionisvalidonlyforHyper-VbackupoperationsonWindowsServer2012and2012R2operatingsystems.
SupportedclientsThisoptionisvalidforallsupportedWindowsclients.
Thisoptioncanalsobedefinedontheserver.
OptionsfileThisoptionisvalidintheclientoptionsfile(dsm.
opt)oronthecommandlinefortheBackupVMcommand.
Itcanalsobeincludedontheserverinaclientoptionset.
ItcannotbesetinthePreferencesEditor.
Syntax20VMMAXSNApshotretryintegerParametersintegerSpecifiesthemaximumnumberoftimestoretrythesnapshotoperationofaVMiftheinitialsnapshotattemptfailswitharecoverablecondition.
Thedefaultis20.
Themaximumis30.
Theminimumis1.
Forexample,ifthevmmaxsnapshotretryoptionissetto12,DataProtectionforMicrosoftHyper-Vretriesthesnapshotoperationupto12timesaftertheinitialsnapshotfailedduringaVMbackupoperation.
Ifthesnapshotstillfailsafter12retriesarereached,nomoreretriesareattempted,andthebackupattemptfails.
Chapter6.
Optionsreference81|||||||||||||||||||||||||||||||||||||||||||||||||||||||Atleast10minutesmustelapsebeforethenextsnapshotretryattempt.
ThetimebetweenattemptswillbelongerwhenthefailedVMispartofasnapshotwithVMsthatarecurrentlybeingbackedup.
ThebackupoperationoftheotherVMsmustbecompletedandthesnapshotisremovedbythebackupoperationbeforearetryattemptcanbemade.
ExamplesOptionsfilevmmaxsna12Commandlinedsmcbackupvm-vmmaxsna=12Relatedconcepts:Chapter4,"TuningscheduledVMbackupsforWindowsServer2012and2012R2clusters,"onpage35Relatedreference:"Vmmaxpersnapshot"onpage79VmmcUsethevmmcoptiontostorevirtualmachinebackupsbyusingamanagementclassotherthanthedefaultmanagementclass.
OptionsFilePlacethisoptionintheclientoptionsfile(dsm.
opt),oronthecommandline.
SyntaxVMMCmanagement_class_nameParametersmanagement_class_nameSpecifiesamanagementclassthatappliestothebackedupvirtualmachinedata.
Ifyoudonotsetthisoption,thedefaultmanagementclassofthenodeisused.
ExamplesTask:RunabackupofthevirtualmachinethatisnamedmyVirtualMachineandsavethebackupaccordingtothemanagementclassthatisnamedmyManagmentClass.
dsmcbackupvm"myVirtualMachine"-vmmc=myManagmentClass82IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuide|||||||||||||||VmprocessvmwithphysdisksUsethevmprocessvmwithphysdisksoptiontocontrolwhetherHyper-VRCTvirtualmachine(VM)backupsareprocessediftheVMhasoneormorephysicaldisks(pass-throughdisks)provisioned.
AVMcanaccessthestorageonaphysicaldiskthatisconnecteddirectlytotheHyper-Vserver.
Thisphysicaldiskiscalledapass-throughdisk.
Whenyousetthisoptiontoyes,thedataonanyphysicaldisksisexcludedfrombackupoperations,buttheconfigurationinformationforthephysicaldisksissavedwiththeVMbackup.
Duringarestoreoperation,youcanrestorethephysicaldiskconfigurationbysettingthevmskipphysdisksnooption.
Iftheoriginalphysicaldisksareavailable,theyarereconnectedtotherestoredVM.
ThisoptionisvalidonlyforRCTbackupsonWindowsServer2016.
ThisoptiondoesnotapplytoHyper-VVSSbackupsonWindowsServer2012orWindowsServer2012R2.
SupportedClientsThisoptionisvalidforclientsonWindowsServer2016orlateroperatingsystems.
OptionsFilePlacethisoptionintheclientoptionsfile(dsm.
opt)orspecifyitasacommand-lineparameteronthebackupvmcommand.
SyntaxNOVMPROCESSVMWITHPHYSDisksYESParametersNoThebackupoperationoftheVMfailsifoneormorephysicaldisksaredetected.
Thisvalueisthedefault.
YesVMsthatcontainoneormorephysicaldisksarebackedup.
Thisoptionbacksupthephysicaldiskconfigurationwithoutbackingupthedataonthephysicaldisks.
ExamplesOptionsfile:VMPROCESSVMWITHPHYSDISKSYesCommandline:dsmcbackupvmvmlocal-vmprocessvmwithphysd=yesRelatedreference:"Vmskipphysdisks"onpage84Chapter6.
Optionsreference83||||||||||||||||||||||||||||||||||||||||||||||||||||VmskipphysdisksUsethevmskipphysdisksoptiontorestoreconfigurationinformationforphysicaldisks(pass-throughdisks)thatareassociatedwithaHyper-Vvirtualmachine(VM),ifthelogicalunitnumbers(LUNs)thatareassociatedwiththevolumesonthephysicaldisksareavailable.
BecausephysicaldisksarenotincludedinaVMsnapshot,onlytheconfigurationinformationcanberestored,andnotthedataonthevolumes.
ThisoptionisvalidonlyforrestoringHyper-VVMsonWindowsServer2016.
ThisoptiondoesnotapplytoHyper-VhostsonWindowsServer2012orWindowsServer2012R2.
SupportedClientsThisoptionisvalidforclientsonWindowsServer2016orlateroperatingsystems.
OptionsFilePlacethisoptionintheclientoptionsfile(dsm.
opt),orspecifyitasacommand-lineparameterontherestorevmcommand.
SyntaxNOVMSKIPPHYSDisksYESParametersNOIftheoriginalphysicaldisksareavailable,specifythisvaluetorestorethephysicaldiskconfigurationinformationthatwasbackedupwiththevmprocessvmwithphysdisksyesoption.
TheoriginalphysicaldisksarereconnectedtotherestoredVM.
Iftheoriginalphysicaldiskscannotbelocated,therestoreoperationfails.
Thisvalueisthedefault.
YESSpecifythisvalueifyoumustrestoreaVMthatyoubackedupwiththevmprocessvmwithphysdisksyesoption,andtheoriginalphysicaldiskscannotbelocated.
Thissettingcausestheclienttoskipattemptstolocatethephysicaldisks,anddoesnotrestorethephysicaldiskconfigurationinformation.
ExamplesOptionsfile:VMSKIPPHYSDISKSYESCommandline:dsmcrestorevmvm123-vmskipphysd=yesRelatedreference:"Vmprocessvmwithphysdisks"onpage8384IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuide||||||||||||||||||||||||||||||||||||||||||||||||||||Chapter7.
MountandfilerestoreIBMSpectrumProtectrecoveryagentconfigurationsTheIBMSpectrumProtectrecoveryagentprovidesavarietyofconfigurationsforperformingfilerestoreanddisk/blockdeviceexposure.
Off-hostfilerestoreTheseconfigurationsdonotrequiretheIBMSpectrumProtectrecoveryagenttobeinstalledineachvirtualmachineguest.
Instead,anoff-hostinstanceisresponsibleforfilerestoreofmultiplevirtualmachines.
Withthisconfiguration,themountprocessexposesavirtualvolumefromaselecteddiskpartition.
ForGPTdisks,thewholediskmustbeexposedtomakethepartitionsavailable,andthediskmustbeiSCSIconnected.
UsetherecoveryagentGUItoaccomplishthistask.
Youmustregisteranodethatisassociatedwiththerecoveryagent.
Therecoveryagentnodemustbegrantedproxyauthoritytoaccessthedatanode(ornodes)wherethesnapshotsarestored.
Whenasnapshotismountedtotheoff-hostserver,thevirtualvolumecanbenetwork-sharedtomakeitaccessibletothevirtualmachineguest.
Or,youcancopythefilesfromthemountedvolumetothevirtualmachineguestbyanyfile-sharingmethod.
vForstepbysteprestoreinstructions,see"Restoringoneormorefiles"onpage89In-guestfilerestoreTheseconfigurationsrequireIBMSpectrumProtectrecoveryagenttobeinstalledineachvirtualmachineguest.
Themountandrestoreprocessisperformedforasinglepartitionfromthebackedupdisk.
TheIBMSpectrumProtectrecoveryagentnodenameistypicallygrantedaccessonlytothevirtualmachinewhereitisrunningwiththeIBMSpectrumProtectbackup-archiveclientdsmcsetaccesscommand.
Therestoreprocessistypicallybegunbyauserwhologsintotheguestmachineofthevirtualmachine.
Fortheseconfigurations,besuretocomparethespecificvirtualmachineguestoperatingsystemrequirementswiththesupportedlevelsofIBMSpectrumProtectrecoveryagent.
Ifaspecificoperatingsystemisnotsupported,determineiftheoff-hostdisk/blockdeviceexposureconfigurationcanalsobeusedforfilerestore.
UsetheIBMSpectrumProtectrecoveryagentGUItoaccomplishthistask.
vForplanninginformationandoperatingsystem-basedguidelines,seeChapter7,"Mountandfilerestore.
"vForstep-by-steprestoreinstructions,see"Restoringoneormorefiles"onpage89.
Off-hostiSCSItargetThisconfigurationexposesaniSCSItargetfromtheinstanceoftheoff-hostIBMSpectrumProtectrecoveryagentandmanuallyusesanin-guestiSCSIinitiatortoaccessthedisksnapshot.
ThisconfigurationrequiresaniSCSIinitiatortobeinstalledwithinthevirtualmachineguest.
ThisapproachexposesaniSCSILUN,CopyrightIBMCorp.
2011,201785ratherthantheoff-hostfilerestore,whichexposesanindividualdiskpartition.
UsetheIBMSpectrumProtectrecoveryagentGUItoaccomplishthistask.
Inthisconfiguration,theuserspecifiesthevirtualmachineguestiSCSIinitiatornameforthesystemwheretheiSCSIdeviceisaccessed.
Afteradisksnapshotismounted,itcanbediscoveredandloggedintobyusingtheiSCSIinitiatorinthevirtualmachineguest.
IfyoubackupavirtualmachinethatcontainsGUIDPartitionTable(GPT)disksandwanttomountthevolumeintheGPTdisk,followthisprocedure:1.
MounttheGPTdiskasaniSCSItarget.
2.
UsetheMicrosoftiSCSIInitiatortologontothetarget.
3.
OpentheWindowsDiskManagementtofindthediskandbringitonline.
YoucanthenviewthevolumeintheGPTdisk.
vForplanninginformationandoperatingsystem-basedguidelines,seeChapter7,"Mountandfilerestore,"onpage85.
vForstepbysteprestoreinstructions,see"Restoringoneormorefiles"onpage89.
SnapshotmountoverviewYoucanusetheIBMSpectrumProtectrecoveryagenttomountasnapshotandusethesnapshottocompletedatarecovery.
MountsnapshotswiththeIBMSpectrumProtectrecoveryagentGUI.
InstallandruntherecoveryagentonasystemthatisconnectedtotheIBMSpectrumProtectserverthroughaLAN.
YoucannotusetherecoveryagentcomponentoperationsinaLAN-freepath.
Beawareofthesesituationswhenrunningmountoperations:vWhentheIBMSpectrumProtectrecoveryagentisinstalledonaguestmachine,youcannotstartamountoperationforanyfilesystemordiskwhiletheguestmachineisbeingbackedup.
Youmusteitherwaitforthebackuptocomplete,oryoumustcancelthebackupbeforerunningamountoperation.
Theseoperationsarenotallowedbecausethelockingmechanismisforafullvirtualmachine.
vWhenyoubrowsethesnapshotbackupinventory,theoperatingsystemversionofthevirtualmachineistheversionthatwasspecifiedwhenthevirtualmachinewasoriginallycreated.
Asaresult,therecoveryagentmightnotreflectthecurrentoperatingsystem.
vAvolumebecomesunstablewhenanetworkfailureinterruptsamountoperation.
Amessageisissuedtotheeventlog.
Whenthenetworkconnectionisreestablished,anothermessageisissuedtotheeventlog.
ThesemessagesarenotissuedtotherecoveryagentGUI.
Amaximumof20iSCSIsessionsissupported.
Thesamesnapshotcanbemountedmorethanonetime.
Ifyoumountasnapshotfromthesametapestoragepoolbyusingmultipleinstancesoftherecoveryagent,oneofthefollowingactionsoccurs:vThesecondrecoveryagentinstanceisblockeduntilthefirstinstanceiscomplete.
vThesecondrecoveryagentinstancemightinterrupttheactivityofthefirstinstance.
Forexample,itmightinterruptafilecopyprocessonthefirstinstance.
vTherecoveryagentcannotconnecttomultipleserversornodessimultaneously.
Asaresult,avoidconcurrentrecoveryagentsessionsonthesametapevolume.
86IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuideMountguidelinesSnapshotscanbemountedineitherread-onlyorread/writemode.
Inread/writemode,recoveryagentsaveschangestodatainmemory.
Iftheserviceisrestarted,thechangesarelost.
Therecoveryagentoperatesineitherofthefollowingtwomodes:NouserisloggedinTherecoveryagentrunsasaservice.
UserisloggedinTherecoveryagentcontinuestorunasaserviceuntilyoustarttherecoveryagentandusetheGUI.
WhenyouclosetherecoveryagentandGUI,theservicerestarts.
YoucanuseonlytherecoveryagentapplicationandGUIwhenrunningwithadministratorlogincredentials.
Onlyonecopyoftherecoveryagentapplicationcanbeactiveatanytime.
WhenmountedvolumesexistandyoustartMountfromtheStartmenu,thismessageisdisplayed:Somesnapshotsarecurrentlymounted.
Ifyouchoosetocontinue,thesesnapshotswillbedismounted.
Notethatifamountedvolumeiscurrentlybeingusedbyanapplication,theapplicationmaybecomeunstable.
ContinueWhenYesisclicked,themountedvolumesareunmounted,evenwhentheyareinuse.
Restriction:WhenexposingsnapshotsasiSCSItargets,andasnapshotofadynamicdiskisdisplayedtoitsoriginalsystem,theUUIDsbecomeduplicated.
LikewisewhenasnapshotofaGPTdiskisdisplayedtoitsoriginalsystem,theGUIDsbecomeduplicated.
Toavoidthisduplication,exposedynamicdisksandGPTdiskstoasystemotherthantheoriginalsystem.
Forexample,exposethesedisktypestoaproxysystem,unlesstheoriginaldisksnolongerexist.
FilerestoreoverviewUsetheIBMSpectrumProtectrecoveryagentforefficientfilerestoreoperationsandtominimizedowntimebymountingsnapshotstovirtualvolumes.
TheIBMSpectrumProtectrecoveryagentcanbeusedforthefollowingtasks:vRecoveringlostordamagedfilesfromabackupvMountingavirtualmachineguestvolumeandcreatinganarchiveofthevirtualmachineguestfilesvMountingdatabaseapplicationsforbatchreportsThevirtualvolumecanbeviewedbyusinganyfilemanager,forexampleWindowsExplorer.
Thedirectoriesandfilesinthesnapshotcanbeviewedandmanagedlikeanyotherfile.
Ifyoueditthefilesandsaveyourchanges,afteryouunmountthevolume,yourchangesarelostbecausethechangeddataisheldinmemoryandneversavedtodisk.
Becausethechangesarewrittentomemory,theIBMSpectrumProtectrecoveryagentcanusealargeamountofRAMwhenitisworkinginread/writemode.
Youcancopythechangedfilestoanothervolumebeforeyouunmountthevolume.
Chapter7.
Mountandfilerestore87Thedefaultreadonlymountoptionisthepreferredmethod,unlessamountedvolumemustbewriteable.
Forexample,anarchiveapplicationmightrequirewriteaccesstothearchivedvolume.
TheIBMSpectrumProtectrecoveryagentmountssnapshotsfromtheIBMSpectrumProtectserver.
IntheIBMSpectrumProtectrecoveryagentGUI,clickRemovetocloseanexistingconnectiontotheIBMSpectrumProtectserver.
Youmustremoveanyexistingconnectionbeforeyoucanestablishanewconnectiontoadifferentserverordifferentnode.
DismountallvolumesbeforeyouclickRemove.
Theremoveoperationfailsifthereareactivemountandrestoresessionsinthemountmachines.
Youcannotremovetheconnectiontoaserverwhenyouarerunningafilerestorefromthatserver.
Youmustfirstdismountallvirtualdevicesandstopallrestoresessionsbeforeyoudisconnectfromaserver.
Ifyoudonotdoso,theconnectionisnotremoved.
YoumustunmountallvirtualvolumesbeforeyouuninstalltheIBMSpectrumProtectrecoveryagent.
Otherwise,thesemountedvirtualvolumescannotbeunmountedaftertheIBMSpectrumProtectrecoveryagentisreinstalled.
Restoringfileinformationforablock-levelsnapshotisarandom-accessprocess.
Asaresult,processingmightbeslowwhenasequential-accessdevice(suchasatape)isused.
Torunafilerestoreofdatathatisstoredontape,considermovingthedatatodiskorfilestoragefirst.
FromtheIBMSpectrumProtectserveradministrativecommand-lineclient(dsmadmc),issuetheQUERYOCCUPANCYcommandtoseewherethedataisstored.
Then,issuetheMOVENODEDATAcommandtomovethedatabacktodiskorfilestorage.
MountingasnapshotfromthesametapestoragepoolbytwoinstancesofMountcancauseoneoftheseresults:vThesecondMountinstanceisblockeduntilthefirstinstanceiscomplete.
vBothmountssucceed,buttheperformanceispoor.
Whenrestoringdatafromamirroredvolume,mountonlyoneofthedisksthatcontainsthemirroredvolume.
MountingbothdiskscausesWindowstoattemptaresynchronizationofthedisks.
However,bothdiskscontainadifferenttimestampifmounted.
Asaresult,alldataiscopiedfromonedisktotheotherdisk.
Thisamountofdatacannotbeaccommodatedbythevirtualvolume.
Whenyoumustrecoverdatafromavolumethatspanstwodisks,andthosediskscontainamirroredvolume,completethesesteps:1.
Mountthetwodisks.
2.
UsetheiSCSIinitiatortoconnecttothefirstdisk.
3.
UseWindowsDiskManagertoimportthisdisk.
Ignoreanymessageregardingsynchronization.
4.
Deletethemirroredpartitionfromthefirst(orimported)disk.
5.
UsetheiSCSIinitiatortoconnecttotheseconddisk.
6.
UseWindowsDiskManagertoimporttheseconddisk.
Bothvolumesarenowavailable.
Restriction:DonotchangetheIBMSpectrumProtectnodepasswordwhilerunningafilerestorefromsnapshotsstoredinthatnode.
88IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuideFilerestoreguidelinesYoucanusetheIBMSpectrumProtectrecoveryagentforefficientfilerestoreandtominimizedowntimebymountingsnapshotstovirtualvolumes.
FilerestoreissupportedfromsnapshotsofNTFS,FAT,orFAT32volumes.
ThemountfunctioncannotbeusedtomountasnapshotofpartitionsfromadynamicorGPT-baseddiskasavirtualvolume.
OnlypartitionsfromanMBR-based,basicdiskcanbemountedasvirtualvolumes.
FilerestorefromGPT,dynamic,oranyothernon-MBRornon-basicdiskispossiblebycreatingavirtualiSCSItargetandusinganiSCSIinitiatortoconnectittoyoursystem.
Ifyouarerunningafilerestoreofdataondynamicdisks,thesnapshotmustbemountedtoaserverthathasthesameversionofWindows,oranewerversionofWindows,asthenodethatcreatedthesnapshot.
FilesonthedynamicdiskcanbeaccessedindirectlybynodesthathaveolderversionsofWindows,bymappingadriveontheoldernodestoaCIFSsharewherethesnapshotismounted.
Important:TheACLvaluesassociatedwiththefoldersandfilesthatarerestoredinafilerestoreoperationarenottransferredtotherestoredfiles.
TomaintainACLvalues,usetheXCOPYcommandwhencopyingfilesfromthetarget.
RestoringoneormorefilesYoucanrestoreone(ormore)filesfromavirtualmachinethatwasbackeduptoIBMSpectrumProtectserverstorage.
BeforeyoubeginIfyourrestoreoperationaccessesthevirtualmachinedisksnapshotwithanin-guestiSCSIinitiator,makesurethefollowingconditionsexistbeforeproceeding:vTheiSCSIdeviceisconfiguredandtheiSCSIInitiatorprogramisrunning.
vPort3260isopenintheLANfirewallbetweenthesystemwheretheIBMSpectrumProtectrecoveryagentGUIisinstalledandtheinitiatorsystem.
AboutthistaskTomountabackedupvirtualmachinediskandexportthemountedvolumeforafilerestoreoperation,completethefollowingsteps:Procedure1.
StarttheIBMSpectrumProtectrecoveryagentGUI.
OntheWindowssystem,gotoStart>Appsbyname>IBMSpectrumProtect>IBMSpectrumProtectRecoveryAgent.
TheIBMSpectrumProtectrecoveryagentGUIcaneitherbeinstalledonthevirtualmachineguestorinstalledonaseparatehost.
2.
ConnecttotheIBMSpectrumProtectserverbyclickingSelectIBMSpectrumProtectserver.
Thetargetnodeiswherethebackupsarelocated.
YoucanmanagethelevelofaccesstothetargetnodedatabyspecifyingadifferentnodenameintheNodeaccessmethodsection.
3.
Selectavirtualmachinefromthelist.
Chapter7.
Mountandfilerestore89Tip:Youcanfindyourvirtualmachinequicklybytypingthefirstfewlettersofthemachinenameintheeditportionofthelistbox.
Thelistshowsonlythosemachinesthatmatchthelettersyouentered.
Machinenamesarecase-sensitive.
Avirtualmachinemightdisplayinthelist,butifyouselectit,thesnapshotslistmightbeempty.
Thissituationoccursbecauseofoneofthefollowingreasons:vNosnapshotscompletedsuccessfullyforthatvirtualmachine.
vTheFromnodeoptionwasusedandthespecifiednodeisnotauthorizedtorestoretheselectedvirtualmachine.
4.
MountthesnapshotthroughaniSCSIconnection:a.
ClickMountintheIBMSpectrumProtectrecoveryagentGUI.
b.
IntheSelectmountdestinationdialog,clickMountasaniSCSItarget.
c.
Enterthenameofthetarget.
Thisnamemustbeuniqueforeachmount.
d.
EntertheiSCSIinitiatorname.
TheiSCSIinitiatornameisshownintheConfigurationtabintheiSCSIInitiatorPropertiesdialog.
Forexample:iqn.
1991-05.
com.
microsoft:hostname5.
CompletethesestepsonthetargetsystemwheretheiSCSIinitiatorisinstalled:a.
ClicktheTargetstab.
b.
IntheQuickConnectsection,entertheIPaddressorhostnameofthesystemwheretheIBMSpectrumProtectrecoveryagentGUIisinstalled.
c.
ClickQuickConnect.
d.
IntheQuickConnectdialog,selecttheIPaddressorhostnameintheDiscoveredtargetsfieldandclickConnect.
e.
AfterStatus-Connectedisshown,clickDone.
f.
GotoControlPanel>AdministrativeTools>ComputerManagement>Storage>DiskManagement.
1)IfthemountediSCSItargetislistedasType=Foreign,right-clickForeignDiskandselectImportForeignDisks.
TheForeignDiskGroupisselected.
ClickOK.
2)Thenextscreenshowsthetype,condition,andsizeoftheForeignDisk.
ClickOKandwaitforthedisktobeimported.
3)Whenthediskimportcompletes,pressF5(refresh).
ThemountediSCSIsnapshotisvisibleandcontainsanassigneddriveletter.
Ifdrivelettersarenotautomaticallyassigned,right-clicktherequiredpartitionandselectChangeDriveLettersorPaths.
ClickAddandselectadriveletter.
6.
Selectthepreferredsnapshotdate.
Alistofvirtualmachinedisksthatarebackedupintheselectedsnapshotdisplays.
SelectadiskandclickMount.
7.
IntheSelectMountDestinationdialog,checkCreatevirtualvolumefromselectedpartition.
Alistofpartitionsavailableontheselecteddiskisshown.
Foreachpartition,itssize,label,andfilesystemtypearedisplayed.
vIfthediskisnotMBR-based,anerrormessageisdisplayed.
vBydefault,onlypartitionsthatcanbeusedforfilerestorearedisplayed.
vTodisplayallpartitionsthatexistedontheoriginaldisk,cleartheShowonlymountablepartitionscheckbox.
8.
Selecttherequiredpartition.
Partitionsformattedusingunsupportedfilesystemscannotbeselected.
90IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuide9.
Specifyadriveletteroranemptyfolderasamountpointforthevirtualvolume.
10.
ClickOKtocreateaVirtualVolumethatcanbeusedtorecoverthefiles.
11.
WhentheVirtualVolumeiscreated,useWindowsExplorertocopythefilestoyourpreferredlocation.
Tip:TheACLvaluesassociatedwiththefoldersandfilesthatarerestoredinafilerestoreoperationarenottransferredtotherestoredfiles.
TomaintainACLvalues,usetheXCOPYcommandwhencopyingfilesfromthetarget.
Relatedtasks:"ConfiguringtheIBMSpectrumProtectrecoveryagentGUI"onpage25"ManuallyconfiguringaniSCSIdevice"onpage32Chapter7.
Mountandfilerestore9192IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuideChapter8.
IBMSpectrumProtectrecoveryagentcommandsTherecoveryagentCLIcanbeviewedasacommand-lineAPItotheIBMSpectrumProtectrecoveryagent.
ChangescompletedwiththerecoveryagentCLItotheIBMSpectrumProtectrecoveryagenttakeeffectimmediately.
YoucanusetherecoveryagentCLItomanageonlyonesystemrunningtheIBMSpectrumProtectrecoveryagent.
OnaWindowssystem,clickStart>Appsbyname>IBMSpectrumProtect>RecoveryAgentCLI.
MountUsethemountcommandtocompletevariousIBMSpectrumProtectrecoveryagenttasks.
TherecoveryagentCLIcanbeusedtomount(mountadd)andunmount(mountdel)volumesanddisks,andtoviewalistofmountedvolumes(mountview).
Tousethemountcommand,theIBMSpectrumProtectrecoveryagentmustberunning.
Usetheset_connectioncommandtoconnectaRecoveryAgentShell.
exetothemountapplication.
SnapshotsaremountedorunmountedonthesystemwheretheIBMSpectrumProtectrecoveryagentisrunning.
SyntaxformountingadiskRecoveryAgentShell.
exe-cmountadd-rep"tsm:ip=IPhost_nameport=portNumbernode=nodeName-as_node=nodeNamepass=NodePassword"-vmnamevmname-typedisk-diskdisk_numberdatedate_format-target"ISCSI:target=target_nameinitiator=initiator_name"SyntaxformountingpartitionRecoveryAgentShell.
exe-cmountadd-rep"tsm:ip=IPhost_nameport=portNumbernode=nodeName-as_node=nodeNamepass=NodePassword"-vmnamevmname-diskdisk_numbervmdkdatedate_format-typepartition-PartitionNumberpartNumCopyrightIBMCorp.
2011,201793-targetvolume_letter"ISCSI:target=target_nameinitiator=initiator_name"CommandtypesaddUsethiscommandtypetomountadiskorvolumeofasnapshottothesystemwhereIBMSpectrumProtectrecoveryagentisrunning.
Thefollowinglistidentifiesthetagsandparametersfortheaddcommandtype:-targetThistagisrequired.
Usethistagtospecifythefollowingtargets:vVirtualvolume-onlyforapartitionmountvReparsepoint-onlyforapartitionmountviSCSItarget-repThistagisrequired.
UseittospecifytheIBMSpectrumProtectserverthatisstoringthesnapshots,andtheIBMSpectrumProtectnodethathasaccesstothebackups.
Forexample:tsm:ip=port=node=pass=Youcanalsospecifytheas_nodeandfrom_nodeoptions.
Ifthepasswordfieldisempty,theIBMSpectrumProtectrecoveryagentattemptstousethepasswordforthestorednode.
-typeThistagisrequired.
Useittospecifythatyouwanttomountadiskorapartition.
Theoptionsare:-typedisk-typepartition-VMnameThistagisrequired.
Useittospecifythemachinenamethatissourceofthesnapshot.
Thespecifiedvalueiscase-sensitive.
-diskThistagisrequired.
Useittospecifythedisknumberofthesourcebackedupmachinetobemounted.
-dateThistagisrequired.
Useittospecifythedateofthesnapshotthatyouwanttomount.
Thedateformatisyyyy-Mmm-ddhh:mm:ss.
Forexample:-date"2013-Apr-1222:42:52AM"Toviewtheactive(orlatest)snapshot,specifylastsnapshot.
-PartitionNumberThistagisoptional.
Ifthe-typeispartition,enterthepartitionnumbertomount.
-ro|-fwUsethistagtospecifywhetherthemountedvolumeisread-only(-ro)orfake-write(-fw).
-diskThistagisrequired.
Useittospecifythedisknumberofthesourcebackedupmachinetobemounted.
-ExpireProtectThistagisoptional.
Duringamountoperation,thesnapshotontheIBMSpectrumProtectserverislockedtopreventitfrom94IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuideexpiringduringtheoperation.
Expirationmightoccurbecauseanothersnapshotisaddedtothemountedsnapshotsequence.
Thisvaluespecifieswhethertodisableexpirationprotectionduringthemountoperation.
Youcanspecifyoneofthefollowingvalues:YesSpecifyYestoprotectthesnapshotfromexpiration.
Thisvalueisthedefault.
ThesnapshotontheIBMSpectrumProtectserverislockedandthesnapshotisprotectedfromexpirationduringthemountoperation.
NoSpecifyNotodisableexpirationprotection.
ThesnapshotontheIBMSpectrumProtectserverisnotlockedandthesnapshotisnotprotectedfromexpirationduringthemountoperation.
Asaresult,thesnapshotmightexpireduringthemountoperation.
Thisexpirationcanproduceunexpectedresultsandnegativelyimpactthemountpoint.
Forexample,themountpointcanbecomeunusableorcontainerrors.
However,expirationdoesnotaffectthecurrentactivecopy.
Theactivecopycannotexpireduringanoperation.
Whenthesnapshotisonatargetreplicationserver,thesnapshotcannotbelockedbecauseitisinread-onlymode.
Alockattemptbytheservercausesthemountoperationtofail.
Toavoidthelockattemptandpreventsuchafailure,disableexpirationprotectionbyspecifyingNo.
dumpUsethiscommandtypetogetalistofalltheavailablebackupstomount.
Thefollowinglistidentifiesthetagsandparametersforthedumpcommandtype:-repThistagisrequired.
UsethistagtospecifytheIBMSpectrumProtectserverstoringthesnapshots,andtospecifytheIBMSpectrumProtectnodethathasaccesstothebackups.
Forexample:tsm:ip=port=node=pass=-fileThistagisoptional.
Usethistagtoidentifyafilenametostorethedumptext.
Ifthistagisnotspecified,thedumptextisprintedonlytostdout.
removeUsethistypetoremovetheconnectiontotheIBMSpectrumProtectserver.
Aconnectioncannotberemovedwhenitisinuse,suchaswhenmountedvolumesexist.
Thefollowinglistidentifiesthetagfortheremovecommandtype:-rep-Thistagisrequired.
UsethistagtospecifytheIBMSpectrumProtectserverconnectiontoberemoved.
viewUsethistypetoviewalistofallmountedsnapshots.
Thistypehasnotags.
ExamplecommandsThefollowingexamplesusethe-targettag:vInthefollowingexampleV:isthevirtualvolumemounttarget:-target"V:"vInthefollowingexampleareparsepointvolumemounttargetisspecified:Chapter8.
IBMSpectrumProtectrecoveryagentcommands95-target"C:\SNOWBIRD@FASTBACK\SnowbirtK\Snowbird\K\\"vInthefollowingexampleaniSCSItargetisspecified:-target"ISCSI:target=initiator="Inthisexample,asnapshotofvirtualmachinenamedVM-03entislocatedontheIBMSpectrumProtectserverwithIP10.
10.
10.
01.
Disknumber1ofthissnapshotismountedtothesystemwheretheIBMSpectrumProtectrecoveryagentisrunning.
Thefollowingcommandshowshowtospecifytheaddtypetomountadisk:mountadd-rep"tsm:ip=10.
10.
10.
01port=1500node=tsm-bapass=password"-target"iscsi:target=test1initiator=initiator_name"-typedisk-vmnameVM-03ENT-disk1-date"2014-Jan-2110:46:57AM-ExpireProtect=Yes"Thefollowingexamplesshowhowtospecifythedumptype:vListalltheavailablebackedupVMs.
mountdump–typeTSM–forTSMVE-repP-requestListVM[–file]vListalltheavailabledisksnapshotsofavirtualmachine.
mountdump–typeTSM–forTSMVE-repP-requestListSnapshots-VMNameP[-file]vListalltheavailablepartitionsofadisksnapshot.
mountdump–typeTSM–forTSMVE-repP-requestListPartitions-VMNameP-diskP-dateP[-file]Inthefollowingexample,removetheconnectiontotheIBMSpectrumProtectserver(10.
10.
10.
01)usingnodeNodeName:mountremove-rep"tsm:NodeName@ip"Thefollowingexampleusestheviewtype:mountviewRelatedlinksformountingaHyper-Vsnapshotv"Set_connection"v"Help"onpage97Set_connectionTheset_connectioncommandsetstheRecoveryAgentCLItoworkwithaspecifiedIBMSpectrumProtectrecoveryagent.
SyntaxRecoveryAgentShell.
exe-cset_connectionmount_computerIPaddressorhost_nameCommandtypemount_computerUsethiscommandtypetosettheconnectionfromtherecoveryagentCLItothesystemwheretheIBMSpectrumProtectrecoveryagentisinstalled.
Thefollowinglistidentifiestheparametersforthemount_computercommandtype:96IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuideIPaddressorhost_nameThisvariableisrequired.
SpecifytheIPaddressorhostnameofthesystemwheretheIBMSpectrumProtectrecoveryagentisinstalled.
ExamplecommandsInthefollowingexample,therecoveryagentCLIissettoworkwiththeIBMSpectrumProtectrecoveryagentontheComputerNamehost.
set_connectionmount_computerComputerNameRelatedlinksforsettingaconnectionv"Mount"onpage93v"Help"HelpThehelpcommanddisplaysthehelpforallofthesupportedrecoveryagentCLIcommands.
SyntaxRecoveryAgentShell.
exe-c-hcommandCommandtag-hUsethiscommandtagtoshowhelpinformation.
Thefollowinglistidentifiestheparameterforthemount_computercommandtype:commandThisvariableisrequired.
SpecifytheRecoveryAgentcommandforwhichyouwanthelpinformation.
ExamplecommandsInthefollowingexample,therecoveryagentCLIissettoworkwiththeIBMSpectrumProtectrecoveryagentontheComputerNamehost.
set_connectionmount_computerComputerNameRelatedlinksforsettingaconnectionv"Mount"onpage93v"Set_connection"onpage96Chapter8.
IBMSpectrumProtectrecoveryagentcommands97Recoveryagentcommand-lineinterfacereturncodesReturncodeshelpidentifytheresultsoftherecoveryagentCLIoperations.
UsethesereturncodestocheckthestatusofyourrecoveryagentCLIoperations.
Table7.
RecoveryAgentCLIreturncodesReturnCodeValueDescription0FBC_MSG_MOUNT_SUCCESSCommandsubmittedsuccessfullytoDataProtectionforMicrosoftHyper-Vmount.
0FBC_MSG_DISMOUNT_SUCCESSSuccessfullydismountedasnapshot.
0FBC_MSG_VIEW_SUCCESSViewoperationsuccessful.
0FBC_MSG_DUMP_SUCCESSDumpoperationsuccessful.
0FBC_MSG_REMOVE_SUCCESSRemoveoperationsuccessful.
1FBC_MSG_MOUNT_FAILMountfailed(Seethemountlogsfordetails).
2FBC_MSG_MOUNT_DRIVER_ERRORMountdrivererror.
3FBC_MSG_VOLUME_LETTER_BUSYVolumeletterorreparsepointisinuse.
4FBC_MSG_MOUNT_WRONG_PARAMETERSIncorrectparametersassignedtothemountcommand(Seethemountlogsfordetails).
5FBC_MSG_MOUNT_ALREADY_MOUNTEDJobisalreadymountedontherequestedtarget.
6FBC_MSG_MOUNT_WRONG_PERMISSIONSInsufficientpermissions.
7FBC_MSG_MOUNT_NETWORK_DRIVECannotmountonnetworkmappedvolume.
8FBC_MSG_MOUNT_LOCKED_BY_SERVERSnapshotlockedbytheserver.
9FBC_MSG_CAN_NOT_CHANGE_REPOSITORYCannotchangerepository.
11FBC_MSG_DISMOUNT_FAILFailedtodismountamountedsnapshot.
13FBC_MSG_VIEW_FAILRetrievinglistofvirtualvolumesfailed.
15FBC_MSG_DUMP_FAILDumpcommandlistcreationfailed.
16FBC_MSG_CONNECTION_FAILEDDisconnectedfromDataProtectionforMicrosoftHyper-Vmount.
17FBC_MSG_CONNECTION_TIMEOUTOperationtimedout.
18FBC_MSG_MOUNT_FAILED_TO_FIND_REPOSITORYFailedtofindavalidrepositorywithsnapshots.
19FBC_MSG_MOUNT_JOB_NOT_FOUNDFailedtofindtherequestedsnapshot.
20FBC_MSG_MOUNT_JOB_FOLDER_NOT_FOUNDFailedtofindtherequestedsnapshotdata.
98IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuideTable7.
RecoveryAgentCLIreturncodes(continued)ReturnCodeValueDescription22FBC_MSG_CAN_NOT_REMOVE_REPOSITORYCannotremoveselectedrepository.
23FBC_MSG_REPOSITORY_GOT_MOUNTSRepositoryhasmountedsnapshots.
38FBC_MSG_MOUNT_NOT_WRITABLE_VOLUMEThemountvolumeisnotwritable39FBC_MSG_NO_TSM_REPOSITORYNoIBMSpectrumProtectrepositorywaslocated.
40FBC_MSG_MOUNT_NOT_ALLOWED_AS_READONLYMountingtheiSCSItargetasreadonlyisnotallowed.
41FBC_MSG_RESOURCE_BUSY_IN_TAPE_MODEDataProtectionforMicrosoftHyper-Visrunningintapemode-mediaisbusy.
42FBC_MSG_DISK_TYPE_NOT_SUPPORTEDPartitionoperationnotsupportedforthistypeofdisk.
43FBC_MSG_MOUNT_INITIALIZINGTheoperationfailed,DataProtectionforMicrosoftHyper-Vmountiscurrentlyinitializing.
Tryagainlater.
44FBC_MSG_CANNOT_LOCK_SNAPSHOTThesnapshotcannotbeprotectedagainstexpirationduringthisoperation.
Refertodocumentationformoredetails.
Chapter8.
IBMSpectrumProtectrecoveryagentcommands99100IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuideAppendixA.
TroubleshootingSolutionstoDataProtectionforMicrosoftHyper-Vissuesareprovided.
Virtualmachinebackupfailswiththe0x800705B4errorintheHyper-VeventlogDuringVMbackupoperationsonWindowsServer2016,thiserrorcanoccurifyourunaresilientchangetracking(RCT)fullbackupofavirtualmachine(VM)withmanyVMdisks.
Thesnapshotoperationeithertimesoutorrunsoutofspaceonthefilespaceontheserver.
IftheVMbackupoperationfails,searchtheHyper-Veventlogforthe0x800705B4error.
Ifthiserrorispresent,completethefollowingstepstohelpimprovetheperformanceofthesnapshotoperation:1.
EnsurethattheHyper-VVMisageneration2VM.
2.
EnsurethatonlySCSIdisksareattachedtothegeneration2VM(insteadofamixofSCSIandIDEdisks).
3.
MovetheHyper-Vsnapshotfolderfromthedefaultlocation(C:\ProgramData\Microsoft\Windows\Hyper-V\Snapshots)toafasterdrivethatisnottheWindowssystemdrive(forexample,theD:drive).
CopyrightIBMCorp.
2011,2017101||||||||||||||||||102IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuideAppendixB.
AccessibilityfeaturesfortheIBMSpectrumProtectproductfamilyAccessibilityfeaturesassistuserswhohaveadisability,suchasrestrictedmobilityorlimitedvision,touseinformationtechnologycontentsuccessfully.
OverviewTheIBMSpectrumProtectfamilyofproductsincludesthefollowingmajoraccessibilityfeatures:vKeyboard-onlyoperationvOperationsthatuseascreenreaderTheIBMSpectrumProtectfamilyofproductsusesthelatestW3CStandard,WAI-ARIA1.
0(www.
w3.
org/TR/wai-aria/),toensurecompliancewithUSSection508(www.
access-board.
gov/guidelines-and-standards/communications-and-it/about-the-section-508-standards/section-508-standards)andWebContentAccessibilityGuidelines(WCAG)2.
0(www.
w3.
org/TR/WCAG20/).
Totakeadvantageofaccessibilityfeatures,usethelatestreleaseofyourscreenreaderandthelatestwebbrowserthatissupportedbytheproduct.
TheproductdocumentationinIBMKnowledgeCenterisenabledforaccessibility.
TheaccessibilityfeaturesofIBMKnowledgeCenteraredescribedintheAccessibilitysectionoftheIBMKnowledgeCenterhelp(www.
ibm.
com/support/knowledgecenter/about/releasenotes.
htmlview=kc#accessibility).
KeyboardnavigationThisproductusesstandardnavigationkeys.
InterfaceinformationUserinterfacesdonothavecontentthatflashes2-55timespersecond.
Webuserinterfacesrelyoncascadingstylesheetstorendercontentproperlyandtoprovideausableexperience.
Theapplicationprovidesanequivalentwayforlow-visionuserstousesystemdisplaysettings,includinghigh-contrastmode.
Youcancontrolfontsizebyusingthedeviceorwebbrowsersettings.
WebuserinterfacesincludeWAI-ARIAnavigationallandmarksthatyoucanusetoquicklynavigatetofunctionalareasintheapplication.
VendorsoftwareTheIBMSpectrumProtectproductfamilyincludescertainvendorsoftwarethatisnotcoveredundertheIBMlicenseagreement.
IBMmakesnorepresentationabouttheaccessibilityfeaturesoftheseproducts.
Contactthevendorforaccessibilityinformationaboutitsproducts.
CopyrightIBMCorp.
2011,2017103|RelatedaccessibilityinformationInadditiontostandardIBMhelpdeskandsupportwebsites,IBMhasaTTYtelephoneserviceforusebydeaforhardofhearingcustomerstoaccesssalesandsupportservices:TTYservice800-IBM-3383(800-426-3383)(withinNorthAmerica)FormoreinformationaboutthecommitmentthatIBMhastoaccessibility,seeIBMAccessibility(www.
ibm.
com/able).
104IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuideNoticesThisinformationwasdevelopedforproductsandservicesofferedintheUS.
ThismaterialmightbeavailablefromIBMinotherlanguages.
However,youmayberequiredtoownacopyoftheproductorproductversioninthatlanguageinordertoaccessit.
IBMmaynotoffertheproducts,services,orfeaturesdiscussedinthisdocumentinothercountries.
ConsultyourlocalIBMrepresentativeforinformationontheproductsandservicescurrentlyavailableinyourarea.
AnyreferencetoanIBMproduct,program,orserviceisnotintendedtostateorimplythatonlythatIBMproduct,program,orservicemaybeused.
Anyfunctionallyequivalentproduct,program,orservicethatdoesnotinfringeanyIBMintellectualpropertyrightmaybeusedinstead.
However,itistheuser'sresponsibilitytoevaluateandverifytheoperationofanynon-IBMproduct,program,orservice.
IBMmayhavepatentsorpendingpatentapplicationscoveringsubjectmatterdescribedinthisdocument.
Thefurnishingofthisdocumentdoesnotgrantyouanylicensetothesepatents.
Youcansendlicenseinquiries,inwriting,to:IBMDirectorofLicensingIBMCorporationNorthCastleDrive,MD-NC119Armonk,NY10504-1785USForlicenseinquiriesregardingdouble-bytecharacterset(DBCS)information,contacttheIBMIntellectualPropertyDepartmentinyourcountryorsendinquiries,inwriting,to:IntellectualPropertyLicensingLegalandIntellectualPropertyLawIBMJapanLtd.
19-21,Nihonbashi-Hakozakicho,Chuo-kuTokyo103-8510,JapanINTERNATIONALBUSINESSMACHINESCORPORATIONPROVIDESTHISPUBLICATION"ASIS"WITHOUTWARRANTYOFANYKIND,EITHEREXPRESSORIMPLIED,INCLUDING,BUTNOTLIMITEDTO,THEIMPLIEDWARRANTIESOFNON-INFRINGEMENT,MERCHANTABILITYORFITNESSFORAPARTICULARPURPOSE.
Somejurisdictionsdonotallowdisclaimerofexpressorimpliedwarrantiesincertaintransactions,therefore,thisstatementmaynotapplytoyou.
Thisinformationcouldincludetechnicalinaccuraciesortypographicalerrors.
Changesareperiodicallymadetotheinformationherein;thesechangeswillbeincorporatedinneweditionsofthepublication.
IBMmaymakeimprovementsand/orchangesintheproduct(s)and/ortheprogram(s)describedinthispublicationatanytimewithoutnotice.
Anyreferencesinthisinformationtonon-IBMwebsitesareprovidedforconvenienceonlyanddonotinanymannerserveasanendorsementofthoseCopyrightIBMCorp.
2011,2017105websites.
ThematerialsatthosewebsitesarenotpartofthematerialsforthisIBMproductanduseofthosewebsitesisatyourownrisk.
IBMmayuseordistributeanyoftheinformationyousupplyinanywayitbelievesappropriatewithoutincurringanyobligationtoyou.
Licenseesofthisprogramwhowishtohaveinformationaboutitforthepurposeofenabling:(i)theexchangeofinformationbetweenindependentlycreatedprogramsandotherprograms(includingthisone)and(ii)themutualuseoftheinformationwhichhasbeenexchanged,shouldcontact:IBMDirectorofLicensingIBMCorporationNorthCastleDrive,MD-NC119Armonk,NY10504-1785USSuchinformationmaybeavailable,subjecttoappropriatetermsandconditions,includinginsomecases,paymentofafee.
ThelicensedprogramdescribedinthisdocumentandalllicensedmaterialavailableforitareprovidedbyIBMundertermsoftheIBMCustomerAgreement,IBMInternationalProgramLicenseAgreementoranyequivalentagreementbetweenus.
Theperformancedatadiscussedhereinispresentedasderivedunderspecificoperatingconditions.
Actualresultsmayvary.
Informationconcerningnon-IBMproductswasobtainedfromthesuppliersofthoseproducts,theirpublishedannouncementsorotherpubliclyavailablesources.
IBMhasnottestedthoseproductsandcannotconfirmtheaccuracyofperformance,compatibilityoranyotherclaimsrelatedtonon-IBMproducts.
Questionsonthecapabilitiesofnon-IBMproductsshouldbeaddressedtothesuppliersofthoseproducts.
Thisinformationcontainsexamplesofdataandreportsusedindailybusinessoperations.
Toillustratethemascompletelyaspossible,theexamplesincludethenamesofindividuals,companies,brands,andproducts.
Allofthesenamesarefictitiousandanysimilaritytothenamesandaddressesusedbyanactualbusinessenterpriseisentirelycoincidental.
COPYRIGHTLICENSE:Thisinformationcontainssampleapplicationprogramsinsourcelanguage,whichillustrateprogrammingtechniquesonvariousoperatingplatforms.
Youmaycopy,modify,anddistributethesesampleprogramsinanyformwithoutpaymenttoIBM,forthepurposesofdeveloping,using,marketingordistributingapplicationprogramsconformingtotheapplicationprogramminginterfacefortheoperatingplatformforwhichthesampleprogramsarewritten.
Theseexampleshavenotbeenthoroughlytestedunderallconditions.
IBM,therefore,cannotguaranteeorimplyreliability,serviceability,orfunctionoftheseprograms.
Thesampleprogramsareprovided"ASIS",withoutwarrantyofanykind.
IBMshallnotbeliableforanydamagesarisingoutofyouruseofthesampleprograms.
106IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuideEachcopyoranyportionofthesesampleprogramsoranyderivativeworkmustincludeacopyrightnoticeasfollows:(yourcompanyname)(year).
PortionsofthiscodearederivedfromIBMCorp.
SamplePrograms.
CopyrightIBMCorp.
_entertheyearoryears_.
TrademarksIBM,theIBMlogo,andibm.
comaretrademarksorregisteredtrademarksofInternationalBusinessMachinesCorp.
,registeredinmanyjurisdictionsworldwide.
OtherproductandservicenamesmightbetrademarksofIBMorothercompanies.
AcurrentlistofIBMtrademarksisavailableontheWebat"Copyrightandtrademarkinformation"atwww.
ibm.
com/legal/copytrade.
shtml.
AdobeisaregisteredtrademarkofAdobeSystemsIncorporatedintheUnitedStates,and/orothercountries.
LinearTape-Open,LTO,andUltriumaretrademarksofHP,IBMCorp.
andQuantumintheU.
S.
andothercountries.
IntelandItaniumaretrademarksorregisteredtrademarksofIntelCorporationoritssubsidiariesintheUnitedStatesandothercountries.
LinuxisaregisteredtrademarkofLinusTorvaldsintheUnitedStates,othercountries,orboth.
Microsoft,Windows,andWindowsNTaretrademarksofMicrosoftCorporationintheUnitedStates,othercountries,orboth.
JavaandallJava-basedtrademarksandlogosaretrademarksorregisteredtrademarksofOracleand/oritsaffiliates.
SoftLayerisaregisteredtrademarkofSoftLayer,Inc.
,anIBMCompany.
UNIXisaregisteredtrademarkofTheOpenGroupintheUnitedStatesandothercountries.
TermsandconditionsforproductdocumentationPermissionsfortheuseofthesepublicationsaregrantedsubjecttothefollowingtermsandconditions.
ApplicabilityThesetermsandconditionsareinadditiontoanytermsofusefortheIBMwebsite.
PersonaluseYoumayreproducethesepublicationsforyourpersonal,noncommercialuseprovidedthatallproprietarynoticesarepreserved.
Youmaynotdistribute,displayormakederivativeworkofthesepublications,oranyportionthereof,withouttheexpressconsentofIBM.
CommercialuseYoumayreproduce,distributeanddisplaythesepublicationssolelywithinyourenterpriseprovidedthatallproprietarynoticesarepreserved.
Youmaynotmakederivativeworksofthesepublications,orreproduce,distributeordisplaythesepublicationsoranyportionthereofoutsideyourenterprise,withouttheexpressconsentofIBM.
Notices107RightsExceptasexpresslygrantedinthispermission,nootherpermissions,licensesorrightsaregranted,eitherexpressorimplied,tothepublicationsoranyinformation,data,softwareorotherintellectualpropertycontainedtherein.
IBMreservestherighttowithdrawthepermissionsgrantedhereinwhenever,initsdiscretion,theuseofthepublicationsisdetrimentaltoitsinterestor,asdeterminedbyIBM,theaboveinstructionsarenotbeingproperlyfollowed.
Youmaynotdownload,exportorre-exportthisinformationexceptinfullcompliancewithallapplicablelawsandregulations,includingallUnitedStatesexportlawsandregulations.
IBMMAKESNOGUARANTEEABOUTTHECONTENTOFTHESEPUBLICATIONS.
THEPUBLICATIONSAREPROVIDED"AS-IS"ANDWITHOUTWARRANTYOFANYKIND,EITHEREXPRESSEDORIMPLIED,INCLUDINGBUTNOTLIMITEDTOIMPLIEDWARRANTIESOFMERCHANTABILITY,NON-INFRINGEMENT,ANDFITNESSFORAPARTICULARPURPOSE.
PrivacypolicyconsiderationsIBMSoftwareproducts,includingsoftwareasaservicesolutions,("SoftwareOfferings")mayusecookiesorothertechnologiestocollectproductusageinformation,tohelpimprovetheenduserexperience,totailorinteractionswiththeenduser,orforotherpurposes.
InmanycasesnopersonallyidentifiableinformationiscollectedbytheSoftwareOfferings.
SomeofourSoftwareOfferingscanhelpenableyoutocollectpersonallyidentifiableinformation.
IfthisSoftwareOfferingusescookiestocollectpersonallyidentifiableinformation,specificinformationaboutthisoffering'suseofcookiesissetforthbelow.
ThisSoftwareOfferingdoesnotusecookiesorothertechnologiestocollectpersonallyidentifiableinformation.
IftheconfigurationsdeployedforthisSoftwareOfferingprovideyouascustomertheabilitytocollectpersonallyidentifiableinformationfromendusersviacookiesandothertechnologies,youshouldseekyourownlegaladviceaboutanylawsapplicabletosuchdatacollection,includinganyrequirementsfornoticeandconsent.
Formoreinformationabouttheuseofvarioustechnologies,includingcookies,forthesepurposes,seeIBM'sPrivacyPolicyathttp://www.
ibm.
com/privacyandIBM'sOnlinePrivacyStatementathttp://www.
ibm.
com/privacy/detailsinthesectionentitled"Cookies,WebBeaconsandOtherTechnologies,"andthe"IBMSoftwareProductsandSoftware-as-a-ServicePrivacyStatement"athttp://www.
ibm.
com/software/info/product-privacy.
108IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuideGlossaryAglossaryisavailablewithtermsanddefinitionsfortheIBMSpectrumProtectfamilyofproducts.
SeetheIBMSpectrumProtectglossary.
ToviewglossariesforotherIBMproducts,seeIBMTerminology.
CopyrightIBMCorp.
2011,2017109110IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuideIndexAaccessibilityfeatures103archivelistoffiles62Bbackupparallel78backupHyper-VVMs1backupincrementalforeverdescription8limitations9policymanagement6RCTbackupdescription2userinterfacesdescription6VSSbackupdescription2backupvmcommand39CclientfeaturesWindowsclient14clusterbackupsonWindowsServer2012reducingschedulecontention35clusterconfiguration23commandsbackupvm39expire47mount93queryVM48restorevm52set_connection96configuringclusters23IBMSpectrumProtectrecoveryagentGUI25iSCSImount32optionsfile21overview21configuringTLSenablesecurecommunicationwiththeserver29,30,31controlfiles76DDataProtectionforMicrosoftHyper-Vupgradeconsiderations13DataProtectionforMicrosoftHyper-Voverview1dateformatspecifying55dateformatoption55detailoption57disability103diskspacerequirementsWindowsclient13documentation11domainincludeforfullvmbackups57domain.
vmfulloption57EenablesecurecommunicationwiththeserverconfiguringTLS29,30,31errors101excludeEXCLUDE.
VMDISK60EXCLUDE.
VMDISK60expirecommand47Ffilespace57filelistoption62filesarchivealistof62restoreoverview87restoretask(Windows)89Ggroupbackupdisplayactiveandinactiveobjects63HhardwarerequirementsWindowsclient13Hyper-Vcmdlets9Hyper-Vsnapshotsdeleting9rollingback9IIBMKnowledgeCentervIBMSpectrumProtectrecoveryagentGUIconfiguring25options25inactiveoption63includeINCLUDE.
VMDISK65include.
vmoption64INCLUDE.
VMDISK65include.
vmsnapshotattemptsoption67incrementalbackupprocessalistoffiles62incrementalforeverdescription8installationprocedure14,15,16silent18installingoverview13CopyrightIBMCorp.
2011,2017111iSCSImountconfiguring32Kkeyboard103KnowledgeCentervLLANenvironment86limitationsonHyper-Vbackupoperations9Mmanagementclass6managingsnapshots9Mbobjrefreshthresh69Mbpctrefreshthresh70memoryrequirementsWindowsclient13modeoption68mountcommand93mountingsnapshots86NnewfeaturesinDataProtectionforMicrosoftHyper-VVersion8.
1.
2viinopromptoption71numberformatspecifying71numberformatoption71Ooptionsdateformat55detail57domain.
vmfull57EXCLUDE.
VMDISK60filelist62inactive63include.
vm64INCLUDE.
VMDISK65include.
vmsnapshotattempts67mbobjrefreshthresh69mbpctrefreshthresh70mode68noprompt71numberformat71pick73pitdate73pittime74skipsystemexclude74timeformat75vmbackdir76vmbackupupdateguid41vmmaxparallel78vmmaxpersnapshot79vmmaxsnapshotretry81vmmc82vmprocessvmwithphysdisks83vmskipphysdisks84optionsfile21optionsreference55overviewbackupHyper-VVMs1DataProtectionforMicrosoftHyper-V1Hyper-Venvironment6policymanagement6restoreHyper-VVMs5userinterfaces6VMbackupswithRCT2VMbackupswithVSS2Pparallelbackups78pickoption73pitdate73pittimeoption74problemdetermination101publicationsvQquerybackups,establishpoint-in-time73,74displayactiveandinactiveobjects63queryVMcommand48RRCTbackupsdescription2features2migratingto2resilientchangetracking(RCT)backups2restorebackups,establishpoint-in-time73,74createlistofbackupversionsto73displayactiveandinactiveobjects63Hyper-VVMsdescription5listoffiles62userinterfacesdescription6restorevmcommand52retrievelistoffiles62SscheduledclusterbackupsonWindowsServer2012tuning35set_connectioncommand96silentinstall18skipsystemexclude74snapshotmanagement9snapshotsmounting86SSLconfiguring29,30,31syntaxdiagramreading37repeatingvalues37requiredchoices37systemstatedisplayactiveandinactiveobjects63112IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuideTtimeformatspecifying75timeformatoption75troubleshooting101Uuninstalling19servercore19upgradeconsiderations13Vvmbackdiroption76vmbackupupdateguidoption41vmctlmcoption6optionsvmctlmc77vmmaxparalleloption78vmmaxpersnapshotoption79vmmaxsnapshotretry81vmmcoption6,82vmprocessvmwithphysdisksoption83vmskipphysdisksoption84VolumeShadowCopyService(VSS)backupsdescription2volumesrestoreoverview87restoretask(Windows)89VSSbackupsdescription2WWindowsclientclientfeatures14diskspacerequirements13hardwarerequirements13memoryrequirements13Windowsfeaturesinstallable14Index113114IBMSpectrumProtectforVirtualEnvironments:DataProtectionforMicrosoftHyper-VInstallationandUser'sGuideIBMProductNumber:5725-X00PrintedinUSA