Sistema de referencia: ED50 (European Datum 1950)

Thissectiondescribes howtousetheData ProtectionforDomino commandline interface toperformtaskswith DominoNSFandDB2databases.

Overview

Thissectionprovides anoverviewofcommandlineinterfacecharacteristics. TheData ProtectionforDominocommandlineinterface,domdsmc.Itisinstalled intheData ProtectionforDomino installationdirectory.

Characteristics

TheData ProtectionforDominocommandlinesyntaxisasfollows: domdsmc command required_parameters 0_or_more_optional_parameters

Thecommandsshown inthischapterhavethefollowingcharacteristics: v Requiredparametersarepositionalanddo notincludeaforwardslash(/). v Optionalparametersbeginwitha forwardslash (/).

v Uppercaselettersindicatetheminimumabbreviationsforparameterkeywords. Forexample,the/LOGPruneparameterhasa minimumabbreviationof/logp. v Forparametersthatrequire avalue, anequalsign(=)separatesthevalue from

theparameter.Inthefollowingexample, /logprune=60

anequalsignseparatestheparameter,/logprune,fromthevalue,60. v

Ifaparameterrequiresmorethanonevalueafter theequalsign, thevaluesare separatedwith acomma. Forexample:

domdsmc activatedbs /buffers=3,1024

v Oneormore blankspacesseparateeachparameterfromtheotherparameters. Forexample:

domdsmc activatedbs /buffers=3,1024 /configfile=test.cfg

v Ifthevalue ofaparameter includesspaces,thevaluemust beenclosedinsingle ordoublequotes.Forexample:

domdsmc incremental "*"

Setting

options

and

preferences

SelectPreferencesfromtheGUIEditmenutodefineoptionsandassignedvalues intheData ProtectionforDomino preferencesfile,bydefault,domdsm.cfg. Use theData ProtectionforDomino setcommandtospecifyData Protectionfor Domino optionsand assignedvaluesintheDataProtectionforDomino

preferencesfile,bydefault,domdsm.cfg.

Youcanenteroptionswith appropriateDataProtectionforDominocommandsto override theoptionssetinyour DataProtectionforDominopreferencesfile, domdsm.cfg.Whenanoptionisaparameterona DataProtectionforDomino commandbutisnotspecified,then thevalueintheDataProtectionforDomino

preferencesfileisused.

NSF

Commands

Thissectiondescribes howtousetheData ProtectionforDomino commandline interface withDominoNSFdatabases.

Domdsmc

Activatedbs

Thissectiondescribes thedomdsmcactivatedbscommand.

Purpose

Domdsmcactivatedbs bringsrestored databasebackupsonline.Ifthedatabaseis

logged, youcanapplyallapplicabletransactionsfromthetransactionlogsorapply transactionsuptoa specificpointin timetoupdatethedatabase.

Youcanputdatabasesinacorruptstateif youpressCTRL-C(orcancelthejob)in themiddle ofanactivate.Thispreventsthedatabasesfrombeingactivated.Also, anydatabasesactivatedbeforetheCTRL-C(orcancel)waspressed,canbe corruptedand shouldbe restoredandactivated again.

Thiscommandactsonrestoreddatabasebackupsthatare pendingactivation(that is, theyhavebeenrestoredwith the/activate=noparameter).TheTivoliStorage Manager serverisnotcontactedunlessarchivedtransactionlogsareneededwhen usingthe/applylogsparameter.

If youreceive the Domino message Recovery Manager: Database is not latest copy. whenyouissue thedomdsmcactivatedbscommandwiththe/applylogs parameter,a problemmayexistwithyour DominoLoggerID.Consult your Domino documentationtodeterminewhyyoureceivedthiserrormessage.You

canalso runthedomdsmcquerylogarchivecommandtoview archived

transactionlogextentsformoreinformation.IftwoLoggerIDsdisplayasinthe followingexample:

IBM Tivoli Storage Manager for Mail: Data Protection for Lotus Domino Version 5, Release 5, Level 1.0

(C) Copyright IBM Corporation 1999, 2008. All rights reserved.

Domino Server: restroan01 ---

Logger Id: OF88256BC1:005F8602-ON00000365:0136DCCF ---

Transaction

Log Archive Date Log Filename A/I Size --- --- --- --- 05/22/2004 10:27:26 S0000000.TXN A 64.00MB

Domino Server: restroan01 ---

Logger Id: OF88256BC1:005EDBA5-ON00000365:0136DCCF ---

Transaction

Log Archive Date Log Filename A/I Size --- --- --- --- 05/22/2004 10:20:23 S0000000.TXN A 64.00MB

Data Protectionfor Dominowilluseanalternaterestorepathforthetransaction logs ona Domino6 environmentwhentheTRANSLOG_RECOVER_PATHvariable isspecifiedintheNOTES.INIfile.Ifthealternatelogrestorepathspecifiedinthe NOTES.INIfileisnotafullyqualifiedpath,DataProtectionforDominowillnot usethealternaterestorepath.contactLotussupport todeterminewhyyour LoggerIDhaschanged.

YoucanuseanyofthedisplayedLoggerIDstorestorelogged databases.Inorder touseanyof theLoggerIDsotherthanthecurrentone,youneedtousean alternateservertorestorelogged databases.See“Alternateserverandalternate partitionrestores forNSFdatabases”onpage164for detailedinstructionsonhow toperform thisprocedure.

DOMDSMC ACTIVatedbs /ADSMNODe= nodename dsm.opt /ADSMOPTFile= optionsfile /ADSMPWD= password ,00:00:00 /APPLYLogs= ,time date 3 ,1024

/BUFFers= numbuffers ,buffersize

domdsm.cfg /CONFIGfile= cfgfilename domdsm.log /LOGFile= logfilename 60 /LOGPRUne= n No Yes /MOUNTWait= No /PICk /Quiet

Parameters

/ADSMNODe=nodename

SpecifiestheTivoliStorageManagernodenameDataProtectionforDomino usestologontotheTivoliStorageManagerserver.Thecommand-line value overridesthevalueintheTivoliStorageManageroptionsfile.

/ADSMOPTFile= optionsfile

SpecifiestheTivoliStorageManageroptionsfilename. Thefilenamecan include afullyqualifiedpath name.Ifyoudo notspecifya path,the installationdirectory andthenthecurrentdirectoryare searchedforthe specified file.Thedefaultisdsm.opt.

/ADSMPWD=password

SpecifiestheTivoliStorageManagerpasswordDataProtectionforDomino usestologontotheTivoliStorageManagerserver.Ifyouspecify

passwordaccessgeneratein theTivoliStorageManageroptionsfile,thenthe passwordisnotrequired. Inthis case,DataProtectionforDominousesthe passwordthatisstoredbytheTivoliStorageManagerAPI.

Ifpasswordaccess issettogenerateandyouspecifya password,thevalueis ignoredunlessapasswordforthisnodehasnotbeenstored.Inthiscase,the specified passwordisstoredand usedforthecurrentcommandexecution. Ifpasswordaccess issettopromptandyouspecifya passwordonthe

commandline,youarenotpromptedfora password.Thecommandlinevalue overridestheneedtoprompt.

Ifpasswordaccess issettopromptandyoudonotspecifya passwordonthe commandline,then youare promptedforapassword.

/APPLYLogs=date,time

Specifiesthattransactionlogrecoveryfortherestoreddatabasesisperformed if theyarelogged.Thedateand timevaluesmustbe specifiedinthesamedate and timeformatdefinedintheData Protectionfor Dominopreferencesfile. Thetransactionlogsareapplied toaspecified pointintimeortothecurrent dateandtimeifnodateandtimevaluesarespecified.

date Specify adatestringintheactivedateformat.Whenspecified, transactionsthatarecompletedandcommittedbefore thespecified dateareapplied totherestored database.Thedatespecifiedshouldbe after thebackupdateofthebackupimagethatisbeingrestored.The /pitoptioncanbe usedwith therestorecommandtoautomatically restorethemostrecentfullbackupimagethatisperformedbeforethe desiredpointintime.

Becausethereisone transactionlogforalllogged databases,allthe databasesshouldbeactivated together(inonecommand).This situationapplieswhenrestoringmultipledatabasesthatneedtohave transactionsapplied fromthelog.Thispreventsthefetchingof the sametransactionlogsmultiple timesfromtheTivoliStorageManager server.Thedatabasescanbe restoredseparately(ifnecessary)with the /activate=noparameterandthen activatedtogether withasingle

activatedbs command.

Ifyouarerestoringadatabasethatisbackedupfromadifferent Dominoserver,logged transactionscannotbeapplied. Inthis case,you canonlyactivateafullbackupimage.YoumustalsousetheNotes

fixuputilitytoresettheinternalsequencenumbersoftherestoredand activated database.

Note: Ifcircularloggingisineffect,it mightnotbepossibleto

properlyapplytransactionsiftheloghaswrapped.Ifanattemptto applytransactionlogsfails,thedatabaseordatabasesbeingprocessed are markedascorrupted.Thedatabaseordatabaseswillhavetobe restoredagain.

Thedatemustbe specifiedusingthesamedateformatdefinedinthe Data ProtectionforDomino preferencesfile.See“DomdsmcSet”on page114foralistofavailable dateformats.

time Specify atimestringintheactivetimeformat.Ifyouspecifya date withoutthetime,00:00:00ona 24-hourclockisused.

Thetimemustbe specifiedusingthesame timeformatdefinedinthe Data ProtectionforDomino preferencesfile.See“DomdsmcSet”on page114foralistofavailable timeformats.

/BUFFers=numbuffers,buffersize

Domino serverandtheTivoliStorageManagerAPI. Increasingthenumberor size (orboth)ofthedatabufferscanimprovethroughput.

Youcanspecifyfrom2to8 buffers,thedefaultvalueis3.Thesizeof the buffers canbefrom64to8192kilobytes,thedefaultvalueis1024.

Ifthe/buffersparameterisnotspecifiedonthecommandlineordefinedinthe preferencesfile,DataProtectionforDominousesthedefaultvalues.

/CONFIGfile= cfgfilename

SpecifiesthenameoftheData Protectionfor Dominopreferencesfile.Thefile namecanincludea fully-qualifiedpath.Ifyoudonotspecifya path,it is assumedthepreferencesfileresidesin thedirectorywhere DataProtectionfor Domino isinstalled.

Thedefaultpreferencesfileisdomdsm.cfg.

/LOGFile=logfilename

Specifiesthenameoftheactivity logthatisgeneratedbyDataProtectionfor Domino.Thelogfilenameisusedforthecurrentcommandand doesnot updatethedefaultlogfilethatisstoredin thepreferencesfile.Youcanusethe setcommandtochangethedefaultlogfilenamethatisstoredinthe

preferencesfile.Thecommand-lineparametercanbeusedtooverridethe defaultforonecommandrun.Ifthespecifiedfiledoesnotexist,itiscreated.If it doesexist, newlogentriesare appendedtothefile.Thefilenamecan include afully-qualifiedpath.Ifyoudonotspecifyapath,thefileiswritten to thedirectorywhereData ProtectionforDominoisinstalled.

Thedefaultlogfileisdomdsm.log.

WhenusingmultiplesimultaneousinstancesofDataProtectionforDominoto perform operations,usethe/logfileparametertospecifya differentlogfilefor eachinstance used.Thisdirectsloggingforeachinstance toadifferentlogfile and preventsinterspersedlogfilerecords.Failure tospecifya differentlogfile foreachinstance canresultinunreadablelogfiles.

/LOGPRUne=60|n|No

Specifieswhethertoprunelogentries.By default,logpruningisenabledand performedonceperday.Youcanusethesetcommandto:

v Changethedefaults sothatlogpruningisdisabled v Changethenumber ofdayslogentriesare saved

Youcanusethe/logpruneoptiontooverride thesedefaultsforonecommand run. Notethatwhenthevalueof /logpruneisa number,thepruneis

performedevenifonehasalreadybeenperformedfortheday. Youcanspecify:

60 Specifiesthatlogentriesare savedfor60days beforepruning.Thisis thedefault.

n Specifiesthenumberofdays tosavelogentries.Therangeofvaluesis 0 to9999.Avalueof0 deletesallentriesinthelogexceptforthe currentcommandrunentries.

No Donotprunethelog.

Changes tothevalue ofthetimeformatordateformatparametercanresult in an undesiredpruningoftheDataProtectionforDominologfile.Ifyouare runningacommandthatmayprunethelogfileandthevalue ofthe

timeformat ordateformatparameterhaschanged,perform oneofthe

followingtopreventundesiredpruningofthelogfile:

v Makeacopyoftheexistinglogfile.

v Specifyanew logfilewith the/logfileparameterorlogfilesetting.

/MOUNTWait=Yes|No

IftheTivoliStorageManagerserverisconfiguredtostoretransactionlog backupdataonremovablemedia,thentheTivoliStorageManagerservercan indicatetoData ProtectionforDominothatit iswaitingforarequiredstorage volume tobemounted.Ifthis occurs,thisoption allowsyoutospecify

whetherData Protectionfor Dominowaitsforthemediamountorstopsthe currentoperation.Removablemedia ismedia suchastapes.

Youcanspecify:

Yes Wait fortapemounts.Thisisthedefault.

No Donotwaitfortapemounts. /PICk

Displaysa listoftherestored databasesthatarewaitingforactivation.The databaseslistedare thosethatmatchthedbnamepatternspecified.Databasesto be activatedcanbe selectedfromthelist.

Thepick listispresentedasascrollablelistwiththesamemanipulation functionsasofferedinthebaseTivoliStorageManagerclientPICKfunction. Quiet

Specifiesthatstatusinformationdoesnotdisplay.However,theinformationis written totheactivitylog.

Examples

Example1: Thefollowingexamplebringsalltherestoreddatabasebackupsonline

and appliestransactionsfromthetransactionlogtoupdatethedatabasetothe datespecified:

domdsmc activatedbs /applylogs=02/23/2007

IBM Tivoli Storage Manager for Mail: Data Protection for Lotus Domino Version 5, Release 5, Level 1.0

(C) Copyright IBM Corporation 1999, 2008. All rights reserved.

Starting Domino database activation...

Initializing Domino connection...

Logging on to the Tivoli Storage Manager server, please wait...

Starting archivelog recovery...

Media Recovery Replay: 100%

02/22/07 04:32:25 PM Recovery Manager: Media Recovery complete for i:\Lotus\Domino\Data\datadir3\yyyy.nsf.dad,last update applied 02/22/07 03:51:12 PM.

Archivelog recovery completed successfully.

Activating database datadir3\yyyy.nsf, 1 of 1, Activate of datadir3\yyyy.nsf completed successfully.

Total pending databases inspected: 1 Total pending databases requested for activation: 1 Total pending databases activated: 1

Throughput rate: 0.00 Kb/Sec Total bytes transferred: 0

Elapsed processing time: 0.00 Secs

Example2: Thefollowingexamplebringsalltherestoreddatabasebackupsonline:

domdsmc activatedbs

Outputexample:

IBM Tivoli Storage Manager for Mail: Data Protection for Lotus Domino Version 5, Release 5, Level 1.0

(C) Copyright IBM Corporation 1999, 2008. All rights reserved.

Starting Domino database activation...

Initializing Domino connection...

Logging on to the Tivoli Storage Manager server, please wait...

Activating database datadir3\db8.nsf, 1 of 1, Activate of datadir3\db8.nsf completed successfully.

Total pending databases inspected: 1 Total pending databases requested for activation: 1 Total pending databases activated: 1

Throughput rate: 0.00 Kb/Sec Total bytes transferred: 0

Elapsed processing time: 0.00 Secs

Domdsmc

Archivelog

Thissectiondescribes howtousethedomdsmcarchivelogcommand.

Purpose

DomdsmcarchivelogbacksupDominotransactionlogfiles whenarchivallogging

isineffectontheDomino server.Thiscommandqueries theDomino serverto determineifanylogextentsarereadyforarchiving.Ifso,thelogfilesarebacked upto TivoliStorageManager serverstorage, andtheDominoserverisnotifiedof theiravailability forreuse.Inaddition,high andlowthresholdvaluescanbe specified asa percentageofthelogcapacitytocontrolwhetherornotlogfiles shouldbe archivedwhenthecommandisrun. Thisallowsthecommandtobe scheduledregularlytoprotectagainstalogfullconditionbuttoactuallydothe archive onlyif thelogisgettingclosetobeingfull. Thus,ifenoughlogspaceis allocatedtocontainanaverageday’s worthofupdates,itispossibletoestablisha strategy wherelogfilesarenormallyarchiveddailyduringlowusage time(e.g.a dailyschedulewithoutthresholdvalues)butunusuallyhighvolumesofchange canalso behandledonanexceptionbasis.For example,an hourlyscheduleofthe

archivelogcommandwithappropriatespecifiedthresholdvaluesperformsthe

archive onlyif necessary.

Youshouldrunthiscommandfrequentlytoensurethatallocatedtransactionlog spaceisfreed.

The activetransactionlogisalsobackedupwithDomino Server5.04(orhigher). DOMDSMC ARCHivelog /ADSMNODe= nodename dsm.opt /ADSMOPTFile= optionsfile /ADSMPWD= password 3 ,1024

/BUFFers= numbuffers ,buffersize

domdsm.cfg /CONFIGfile= cfgfilename domdsm.log /LOGFile= logfilename 60 /LOGPRUne= n No Yes /MOUNTWait= No /Quiet ,0 /THRESHold= highvalue ,lowvalue

Parameters

/ADSMNODe=nodename

SpecifiestheTivoliStorageManagernodenameDataProtectionfor Domino usestologontotheTivoliStorageManagerserver.The command-linevalue overridesthevalue intheTivoliStorageManager optionsfile.

/ADSMOPTFile=optionsfile

SpecifiestheTivoliStorageManageroptionsfilename. Thefilenamecan include afullyqualifiedpathname. Ifyoudo notspecifya path,the installationdirectory andthenthecurrentdirectoryare searchedforthe specifiedfile.Thedefaultisdsm.opt.

/ADSMPWD=password

SpecifiestheTivoliStorageManagerpasswordDataProtectionforDomino usestologontotheTivoliStorageManagerserver.Ifyouspecify

passwordaccess generateintheTivoliStorageManageroptionsfile,then thepasswordisnotrequired.Inthiscase, DataProtectionforDominouses thepasswordthatisstored bytheTivoliStorageManagerAPI.

Ifpasswordaccess isset togenerateandyouspecifya password,thevalue isignoredunlessa passwordfor thisnodehasnotbeen stored.Inthis case, thespecified passwordisstoredand usedforthecurrentcommand execution.

Ifpasswordaccess isset topromptandyouspecifya passwordonthe commandline,youarenotpromptedforapassword. Thecommandline value overridestheneedtoprompt.

Ifpasswordaccess isset topromptandyoudo notspecifya passwordon thecommandline,thenyouarepromptedfora password.

/BUFFers=numbuffers,buffersize

Specifiesthenumberand sizeofdatabuffersthattransfer databetween theDominoserverand theTivoliStorageManagerAPI.Increasing the number orsize(orboth)ofthedatabufferscanimprovethroughput. Youcanspecifyfrom2to8 buffers,thedefaultvalueis3.Thesizeof the

In document Diseño del drenaje pluvial en la localidad de parco distrito de parco provincia de Bagua Región Amazonas (página 70-74)