Testing an include-exclude list with the Preview command
Youcanpreviewthelistofobjectstobe backeduporarchivedaccordingtothe include-excludelist,priortosendinganydatatotheserver.TheTivoliStorage Manager clientJavaGUIdirectory treeshowsdetailedinformationofincludedand excluded objects.ThedirectorytreewindowsintheTivoliStorageManagerClient Java GUIallowyoutoselectfilesanddirectoriestoinclude orexclude.Youshould usethisPreviewcommandtomakesurethatyouinclude andexcludethecorrect files.Thefollowingisasamplescenarioforusingtheinclude-excludepreview function.
Assumethatyouwanttobackupthefilesonyour/Users/homefilespace.You bringuptheTivoliStorageManagerClientJavaGUIand opentheBackuptree.
Youcanseeallofthedirectoriesandfilesthathavebeenexcluded byyour options fileand othersources.Youscrolldownthetreeandnoticethatallofthe*.ofiles in your/Volumes/home/mary/myobjdirwillbebackedup.Youdon’twanttoback upthese files,soyourightclicka .ofile,andchoose ″ViewFileDetails″fromthe popup menu.The dialogshowsthatthese filesareincluded.click the″Advanced″
buttonand createaruleto excludeall.ofilesfromthe/homefilespace.Aruleis created atthebottomofyour optionsfile.Thecurrentdirectoryisrefreshedinthe Backuptree,andthe.ofileshavethered’X’,meaningthey areexcluded.When youlookatotherdirectories,theyshowthenew excludesthatyouhaveadded.
Press″Backup″andbackupthefilesonyour/home filespace.
See “Preview”onpage297formoreinformationaboutthePreviewcommand.
Processing include and exclude options
The TivoliStorageManager servercandefineinclude-excludeoptionsusingthe inclexclparameterina clientoptionset.Theinclude-excludestatementsspecified bytheserverareevaluatedalongwith thoseinthedsm.sysfile.Theserver include-excludestatementsarealways enforcedandplacedatthebottomofthe include-excludelistandevaluatedbefore theclientinclude-excludestatements.
Ifthedsm.sys fileinclude-excludelistcontainsoneormore inclexcloptionsthat specifyinclude-excludefiles,theinclude-excludestatementsinthese filesare placedinthelistpositionoccupiedbytheinclexcloptionand processed accordingly.
Whenperforminganincrementalbackup, TivoliStorageManagerevaluatesall exclude.dirstatementsfirst,andremoves theexcluded directoriesand filesfromthe listof objectsavailable forprocessing.See “Excludingdirectories” onpage28and
“Excludeoptions”onpage168for moreinformationabouttheexclude.diroption.
Afterevaluatingallexclude.fs andexclude.dirstatements,TivoliStorageManager evaluates theinclude-excludestatementsforcontrolling symboliclinkoralias processing(exclude.attribute.symlinkand include.attribute.symlink)fromthe bottomupandstopsifit findsaninclude orexcludestatementthatmatchesthe fileitisprocessing.Aftertheinclude-excludestatementsforcontrollingsymbolic linkoraliasprocessingareprocessed, TivoliStorageManager evaluatesthe remaininginclude-excludelistfromthebottomupand stopswhenit findsan include orexcludestatementthatmatchesthefileitisprocessing.Theorderin whichtheincludeand excludeoptionsareenteredthereforeaffectswhichfiles are includedandexcluded.See Chapter9,“Usingprocessingoptions,”onpage111for more informationabouttheorderinwhichalloptionsareprocessed.
Todisplaya listofallinclude-excludestatementsineffectonyour client workstationintheactualordertheyareprocessed, usethequeryinclexcl command. See“QueryInclexcl”onpage306formoreinformation.
Theclient programprocessesthelistofinclude-excludestatementsaccordingto thefollowingrules:
1. Folders arenotchecked;filesarechecked.Therefore,ifyouhavea volume (suchas"/Volumes/LaPomme")definedusingthedomainoption,all foldersof thatvolumeare backedupregardlessofwhatyoudefinedforyourinclude and excludeoptions. Thisisthecaseeven ifthefilesinthosefoldersarenotbacked up.
2. Filenamesarecomparedtothepatternsintheinclude-excludelistfromthe bottomup.Whenamatchisfound,theprocessingstopsandcheckswhether theoptionisincludeorexclude.Iftheoptionisinclude,thefileisbackedup.If theoptionisexclude,thefileisnotbackedup.
Note: Averylargeinclude-excludelistcandecreasebackupperformance.Use wildcardsand eliminateunnecessaryincludestatementsto keepthelist asshortaspossible.
3. Ifa matchisnotfound,filesare implicitlyincludedandbackedup.
4. Whenafileisbackedup,it isbound tothedefaultmanagement classunlessit matchedan includestatementthatspecified adifferentmanagementclass name,inwhichcasethefileisbound tothatmanagementclass.
Thefollowingexamples demonstratebottomupprocessing.
Example1
Assumethat LaPomme isnotthestartupdisk.
EXCLUDE /.../*.cpp
INCLUDE "/Volumes/La Pomme/Foo/.../*.cpp"
EXCLUDE "/Volumes/La Pomme/Foo/Junk/*.cpp"
The currentfilebeingprocessedis/Volumes/La Pomme/Foo/Dev/test.cpp.
Theprocessingfollowsthesesteps:
1. Rule3(thelastincludeorexcludestatementdefined)ischeckedfirst becauseofbottomupprocessing.Thepattern/Volumes/La
Pomme/Foo/Junk/*.cppdoesnotmatchthecurrentfilenamebeing processed.
2. ProcessingmovestoRule2andchecks.Thistime,pattern/Volumes/La Pomme/Foo/.../*.cppmatches thecurrentfilenamebeingprocessed.
Processingstops,theoptionischecked,and itisinclude.
3. File /Volumes/LaPomme/Foo/Dev/test.cpp isbackedup.
Example2
Assumethat LaPomme isnotthestartupdisk.
EXCLUDE /.../*.cpp
INCLUDE "/Volumes/La Pomme/Foo/.../*.cpp"
EXCLUDE "/Volumes/La Pomme/Foo/Junk/*.cpp"
The current filebeing processedis/Volumes/La Pomme/Widget/Sample File.
Theprocessingfollowsthesesteps:
1. Rule3ischeckedandfindsnomatch.
2. Rule2ischeckedandfindsnomatch.
3. Rule1ischeckedandfindsnomatch.
4. Becausea matchisnotfound,file Volumes/LaPomme/Widget/Sample Fileisimplicitlyincludedandisbackedup.
Example3
Assumethat LaPomme isnotthestartupdisk.
EXCLUDE /.../*.cpp
INCLUDE "/Volumes/La Pomme/Foo/.../*.cpp"
EXCLUDE "/Volumes/La Pomme/Foo/Junk/*.cpp"
The currentfilebeingprocessedis/La Pomme/Lib/Src/Module1.cpp.The processingfollowsthesesteps:
1. Rule3ischeckedandfindsnomatch.
2. Rule2ischeckedandfindsnomatch.
3. Rule1ischeckedandamatchisfound.
4. Processingstops,theoptionischecked,and itisexclude.
5. File /La Pomme/Lib/Src/Module1.cppisnotbacked up.
Example4
Assumethat LaPomme isnotthestartupdisk.
EXCLUDE /.../*.cpp
INCLUDE "/Volumes/La Pomme/Foo/.../*.cpp"
EXCLUDE "/Volumes/La Pomme/Foo/Junk/*.cpp"
Thecurrentfilebeingprocessedis:/Users/user1/documents/printf.cpp.
Processingfollowsthesesteps:
1. Theexclude.attribute.symlinkstatementischeckedfirst. Ifthe
printf.cppfileisasymboliclinkoraliasitwillbe excluded,otherwise proceedtothenextstep.Notethattheexclude.attribute.symlink statementsarealways processedbefore theotherinclude-exclude statements,regardlessof theirpositionintheinclude-excludelist.
2. Rule3ischeckedandfindsnomatch.
3. Rule2ischeckedandfindsnomatch.
4. Rule1ischeckedandamatchisfound.
5. Processingstops,theoptionischecked,and itisexclude.
6. File/Users/user1/documents/printf.cppisnotbackedup.
Example5
AssumethatLa Pommeisthestartupdisk,isdefinedasthedomain,and thatyoudefinedthefollowingstatementsfortheincludeand exclude options.
EXCLUDE /.../*.cpp INCLUDE /Foo/.../*.cpp EXCLUDE /Foo/Junk/*.cpp
Thecurrentfilebeingprocessedis:/Foo/Dev/test.cpp.Processingfollows these steps:
1. Rule3(thelastincludeorexcludestatementdefined)ischeckedfirst becauseofbottomupprocessing.Thepattern/Foo/Dev/test.cpp does notmatchthecurrentfilenamebeingprocessed.
2. ProcessingmovestoRule2andchecks.Thistime,pattern /Foo/.../*.cppmatchesthecurrentfilenamebeingprocessed.
Processingstops,theoptionischecked,and itisincluded.
3. File/Foo/Dev/test.cppisbackedup.
Chapter 3. Getting started
Thischapterincludesinstructionsforthefollowingtasks:
Task Page
StartingaGUIsession 40
Startingacommand-linesession 41
StartingaWebclientsession 42
Startingtheclientschedulerautomatically 43
Changingyourpassword 43
SortingfilelistsusingtheTivoliStorageManagerJavaGUI 44
Displayingonlinehelp 45
Endingasession 45