Escolar Documentos
Profissional Documentos
Cultura Documentos
withLiveReorg8.3
Installation Guide
Copyright2017QuestSoftwareInc.
ALLRIGHTSRESERVED.
Thisguidecontainsproprietaryinformationprotectedbycopyright.Thesoftwaredescribedinthisguideis
furnishedunderasoftwarelicenseornondisclosureagreement.Thissoftwaremaybeusedorcopiedonlyin
accordancewiththetermsoftheapplicableagreement.Nopartofthisguidemaybereproducedortransmitted
inanyformorbyanymeans,electronicormechanical,includingphotocopyingandrecordingforanypurpose
otherthanthepurchaserspersonalusewithoutthewrittenpermissionofQuestSoftwareInc.
TheinformationinthisdocumentisprovidedinconnectionwithQuestSoftwareproducts.Nolicense,express
orimplied,byestoppelorotherwise,toanyintellectualpropertyrightisgrantedbythisdocumentorin
connectionwiththesaleofQuestSoftwareproducts.EXCEPTASSETFORTHINTHETERMSAND
CONDITIONSASSPECIFIEDINTHELICENSEAGREEMENTFORTHISPRODUCT,QUESTSOFTWARE
ASSUMESNOLIABILITYWHATSOEVERANDDISCLAIMSANYEXPRESS,IMPLIEDORSTATUTORY
WARRANTYRELATINGTOITSPRODUCTSINCLUDING,BUTNOTLIMITEDTO,THEIMPLIEDWARRANTY
OFMERCHANTABILITY,FITNESSFORAPARTICULARPURPOSE,ORNON-INFRINGEMENT.INNOEVENT
SHALLQUESTSOFTWAREBELIABLEFORANYDIRECT,INDIRECT,CONSEQUENTIAL,PUNITIVE,
SPECIALORINCIDENTALDAMAGES(INCLUDING,WITHOUTLIMITATION,DAMAGESFORLOSSOF
PROFITS,BUSINESSINTERRUPTIONORLOSSOFINFORMATION)ARISINGOUTOFTHEUSEOR
INABILITYTOUSETHISDOCUMENT,EVENIFQUESTSOFTWAREHASBEENADVISEDOFTHE
POSSIBILITYOFSUCHDAMAGES.QuestSoftwaremakesnorepresentationsorwarrantieswithrespecttothe
accuracyorcompletenessofthecontentsofthisdocumentandreservestherighttomakechangesto
specificationsandproductdescriptionsatanytimewithoutnotice.QuestSoftwaredoesnotmakeany
commitmenttoupdatetheinformationcontainedinthisdocument.
Ifyouhaveanyquestionsregardingyourpotentialuseofthismaterial,contact:
QuestSoftwareInc.
Attn:LEGALDept
4PolarisWay
AlisoViejo,CA92656
RefertoourWebsite(www.quest.com)forregionalandinternationalofficeinformation.
Patents
SpaceManagerwithLiveReorgisprotectedbyU.S.PatentsNo.7,805,423and7,970,748.Additionalpatents
pending.Formoreinformation,gotowww.quest.com/legal.
Trademarks
Quest,QuestSoftware,LiveReorg,andtheQuestlogoaretrademarksofQuestSoftwareInc.intheU.S.A.and
othercountries.ForacompletelistofQuestSoftwaretrademarks,pleasevisitourwebsiteat
www.quest.com/legal.Microsoft,Windows,WindowsServer,andWindowsVistaareeitherregistered
trademarksortrademarksofMicrosoftCorporationintheUnitedStatesand/orothercountries.Oracleisa
trademarkorregisteredtrademarkofOracleand/oritsaffiliatesintheUnitedStatesandothercountries.UNIX
isaregisteredtrademarkofTheOpenGroup.LinuxisaregisteredtrademarkofLinusTorvaldsintheUnited
States,othercountries,orboth.Othertrademarksarepropertyoftheirrespectiveowners.
Legend
CAUTION:A CAUTION indicates potential damage to hardware or loss of data if instructions are
not followed.
WARNING:A WARNING indicates a potential for property damage, personal injury, or death.
SpaceManagerwithLiveReorg
InstallationGuide
January2017
Contents
Contents 3
Installation Overview 10
Overview-InstallationProcess 10
SmartStartforInstallingSpaceManager 10
About Us 43
Wearemorethanjustaname 43
Ourbrand,ourvision.Together. 43
ContactQuest 43
TechnicalSupportResources 43
Architecture
SpaceManagerwithLiveReorgincludesaWindowsclient,servercomponents,andtheServerAgent,ascript
executionengine.Italsoincludesdemonstrationdata,whichyoucanusetoexploreSpaceManager
functionalityusingsimulatedobjectsandtablespaces.
YoucanmanagemultipleOracledatabasesfromasingleSpaceManagerclient.Servercomponentsandthe
ServerAgentmustbeinstalledforeachdatabaseyouplantomanage.Servercomponentsarenormally
installedforonedatabaseatatime.Toinstallthemformultipledatabasessimultaneously,createashellscript
torunthemanualinstallscript.
SpaceManagerincludestheFindLongLONGspackagethatworksinconjunctionwiththeReorgManager
reorganizationwizard.TheFindLongLONGspackageallowsyoutofindtableswithLONGorLONGRAW
columnsthatarelargerthan32,760bytes(longLONGs).PopulatetheFindLongLONGstablebeforeyourun
theReorgManager.
Server Agent
TheServerAgentisascriptexecutionenginethatSpaceManagerusestorunreorganization,repair,and
statisticscollectionscriptsfromthedatabaseserveronascheduledbasis.Theagentmustbeusedtorunlive
reorganizationscriptsandscriptsthatuseFastCopy,FSCopy,orparallelagentprocesses.Scriptsare
automaticallyrunbytheagentwhentheyarescheduledandstoredintheSpaceManagerrepository.
Theagentisstartedwhenitisinstalled.Itthenrunscontinuously.OnUNIXandLinux,theagentrunsasa
daemon.OnWindows,itrunsasaservice.Theagentusesoneconnectionforitself.Itestablishesadditional
connectionsforeachscriptitrunsandforeachparallelprocessituses.
YoucanstopandstarttheagentfromtheSpaceManagerToolsmenuandtheScripts/JobMonitor.
Note:BeforeyouupgradetoamajornewversionofOracle,uninstalltheagent.AfterthenewOracle
databaseisinstalled,reinstalltheagent.Thisensuresthattheagentusesthecorrectfilesforthenew
versionofOracle.
System Requirements
RefertotheSpace Manager with LiveReorg Release Notesforthemostup-to-dateClient,database,and
CapacityManagerrepositoryrequirements.BeforeinstallingSpaceManagerandCapacityManager,ensure
thatyoursystemmeetstheminimumhardwareandsoftwarerequirements.
The DBA account that installs the Space Manager server objects (components) owns the objects. This
same DBA account must be used to upgrade and uninstall the server components (which include Space
Manager objects).
TheDBAaccountusedtoinstalltheservercomponentsshouldalsobeusedtoinstalltheServerAgent.
TheprivilegesneededtorunFND_STATSasanon-APPsuserareautomaticallygrantedduringinstallationof
SpaceManagerservercomponents.AnyuserwiththeDBAorQUEST_SPC_APP_PRIVrolecanrunFND_
STATSfromSpaceManager.
Oracle Privileges
ToinstalltheagentonOracle,youmusthavetheUNLIMITEDTABLESPACEsystemprivilegeandfullprivileges
forthetargetdatabase.(DonotuseSYSorSYSTEM.)ToinstalltheagentonWindows,youmusthaveall
permissionsfortheagentinstallationfolder.
Onallsupportedplatforms,theinstallationDBAmusthavetheEXECUTEprivilegeon:
l DBMS_PIPE
l DBMS_SQL
l DBMS_SYS_SQL
l DBMS_LOB
Normally,EXECUTEprivilegesaregrantedaspartoftheDBAroleorduringServerAgentinstallation.Ifthe
privilegescannotbegrantedduringinstallationoriftheyarerevoked,theagentdoesnotruncorrectly.Tofixthe
problem,grantthemissingprivilegestotheinstallationDBA.
TheinstallationDBAconnectstothetargetdatabasewhenQSAisinstalled.Italsoautomaticallyconnectsthe
agenttothedatabaseeachtimethesystemisstarted.
Note:UsethesameDBAaccounttoinstallSpaceManagerservercomponentsandtheServerAgent.The
sameaccountisautomaticallyusedwhenyouruntheServerAgentInstallerfromSpaceManager
immediatelyafterservercomponentsareinstalled.
Theprocedureshouldberunfornon-DBAusersthatwillrunSpaceManager.Theproceduregrantsthe
QUEST_SPC_APP_PRIVroleandadditionalprivilegestonon-DBAs.ItgrantsonlytheQUEST_SPC_APP_
PRIVroletonon-installationDBAs.
Note:Privilegesmustbegrantedaftereachupgrade,aswellasaftertheinitialinstallation.
YoucanmanagemultipledatabasesfromasingleSpaceManagerclient.
Note:Whenyouperformafirst-timeinstallation,youarepromptedtoenteryourSpaceManagerlicense
key.ThiskeyisalsousedforCapacityManagerforOracle,whichdoesnotrequireaseparatekey.
To configure DEP
UseoneofthefollowingmethodstoconfigureDEP:
l SelectthefollowingoptionintheWindowsControlPanel:Turn on DEP for Essential Windows programs
and services only.
l AddtheSpaceManagerexecutabletothelistofexcludedprogramsforDEP.Tochangesettingsfor
DEP,selectControl Panel | System | Advanced | Performance | Data Execution Prevention.Consult
yoursystemadministratorbeforealteringthesesettings.
3. Whentheinstallationisfinished,dooneofthefollowingtolaunchSpaceManager:
l SelectStart | All Programs | Quest | Space Manager version
l Onyourdesktop,double-clicktheSpaceManagericon.
4. IftheSpaceManagerLicensedialogdisplays,enteryourlicensekeyandsitemessage.
5. SpaceManagerstarts.Ifnecessary,createanewdatabaseconnection.SeeConnecttoDatabaseson
page14formoreinformation.
l IfthedatabasedoesnothaveSpaceManagerservercomponentsinstalled,youwillbeprompted
toinstallthem.SeeInstallorUpgradeServerObjectsonpage18formoreinformation.
Side-by-Side Installation
SpaceManager8.3(orlater)supportsside-by-sideinstallationofversionswithdifferentarchitecture(bitness)as
longastheyarealsodifferentreleases(e.g.,8.2and8.3).
Forexample,youcouldinstallthefollowingside-by-side:
l 32-bitSpaceManager8.2and64-bitSpaceManager8.3
License Key
AfteryoufirstinstalltheSpaceManagerclientandtrytoconnecttoadatabase,youarepromptedtoentera
licensekey.Onceyouenterapermanentkey,youdonotneedtoenteritagain.Itispreservedduringupgrades.
Youonlyneedtochangeorre-enteralicensekeywhen:
l Yourtrialkeyexpires.
l Youswitchfromatrialkeytoapermanentkey.
l YouchangeyourlicensingagreementwithQuestSoftware.
l YouuninstallandthenreinstalltheSpaceManagerclient.
Connect to Databases
SpaceManagerallowsyoutocreateconnectionprofilestostoredatabaseconnectioninformation.Eachprofile
iscomprisedoftheservicename,username,andpasswordforadatabaseconnection.Whenyouselecta
connectionfromthetree-listintheExplorer,thesevaluesareenteredautomatically.
TheprofilescreatedfromaSpaceManagerclientareforthatclientonly.Youcancreateasmanyprofilesas
neededfordifferentdatabasesorthesamedatabase.Adatabasecanhavedifferentprofilesfordifferentusers.
YoucanhavemultipledatabaseconnectionsopenconcurrentlyduringaSpaceManagersession.
Note:ConnectioninformationforthecurrentconnectionisdisplayedintheSpaceManagertitlebar.
Informationconsistsofservicenameforthecurrentconnectionandusernameoftheconnectinguser.
TNS/Direct Selectthetypeofconnectiontocreate.
TNSSelectifusingaTNSNames.orafile.
DirectSelecttoenterdatabaseaddressinformationdirectly,without
usingaTNSNames.orafile.
Server (TNSonly)SelecttheTNSname(netservicename)forthetarget
database.ThefieldlistsallnamesintheTNSNames.orafileontheclient
computer.
NoteIfyouarerunningSpaceManagerinanactive-activeOPSor
RACenvironment,selecttheservicenamefortheinstancewherethe
QuestServerAgent(QSA)isinstalled.
SID (Directonly)EntertheSIDorservicenameforthetargetdatabase.
Host (Directonly)Enterthehostnameforthetargetdatabase.
Port (Directonly)Enterportnumber,ifotherthanthedefault.
UserName EntertheusernameofanOracleuser.TheusermusthavetheDBArole
ortheQUEST_SPC_APP_PRIVrole.SeeSpaceManagerUser
Requirementsonpage6formoreinformation.
Password EnterthepasswordfortheOracleuser.
Note:Savedpasswordsareencrypted.
ProfileName Enteranamefortheprofile.Thisnameisusedtoidentifytheconnection
intheExplorertree-list(leftpaneofExplorerwindow).
OracleHome AllowsyoutoselecttheOraclehometouse,ifyouhavemultipleOracle
homesspecified.SpaceManagerreadstheTNSNames.orafile
associatedwiththeselectedOraclehome.
3. ClickAdd Databasetosavetheprofile.SpaceManageraddstheconnectiontothetreeviewinthe
Explorerwindow.
To connect
Useoneofthefollowingmethodstoopenaconnection:
l Selectadatabaseconnectioninthetreeview(leftpane)intheExplorer.
l Right-clickadatabaseconnectionandselectConnect.
l Selectaconnectionandclick .
Note:SpaceManagerservercomponentsmustbeinstalledinthedatabasetowhichyouwanttoconnect.
SeeInstallorUpgradeServerObjectsonpage18formoreinformation.
To disconnect
Dooneofthefollowing:
l Right-clicktheconnectionnameinthetree-listandselectDisconnect.
l Selectaconnectionnameinthetree-listandclick .
l Selectawindowthatisconnectedtothedatabasefromwhichyouwanttodisconnect.Withthiswindow
astheactivewindow,click .
3. (Upgradeonly)Ifthisisanupgrade,oneormoreofthefollowingmessagesdisplay:
l Upgrade requiredTheisthedefaultmessage.ClickYes.
l Running scriptsTheinstallprogramhasfoundscriptsthattheServerAgentisexecuting.Click
OKtocanceltheupgradeandperformitlater.
l Scheduled scriptsTheinstallprogramhasfoundscriptsthatarescheduledforexecutionby
theServerAgent.Ifyouaresuretheupgradewillcompletebeforethefirstscriptexecutes,click
Yes.Otherwise,clickNotocanceltheupgrade.Youwillneedtoupgradelater.
4. WhentheCreateSpaceManagerwithLiveReorgObjectsdialogopens,specifyanownerand
tablespaceforthecomponents.Seethefollowingformoreinformation.
Field Description
Owner Ifthisisafirst-timeinstallation,specifytheinstallationDBA.Bydefault,the
fielddisplaystheconnectinguser.TouseadifferentDBA,entertheuser
nameintheOwnerfield.AfteryouclickOK,apasswordpromptdisplays.
Tablespace SelectatablespaceforSpaceManagerobjects.Thetablespacemusthavea
standardnameandfreespaceequaltoorgreaterthantheamountfor
ExpectedAllocation.Foranupgrade,itmustalsohaveenoughfreespacefor
copiesofexistingSpaceManagertables(createdforrecoverypurposesand
droppedwhenanupgradeiscomplete).
Objectsareupgradedintheircurrenttablespace.Ifyouselectadifferent
tablespace,objectsareupgradedinthattablespaceanddroppedfromthe
currenttablespace.
Recommended VerifytherecommendedspaceallocationforSpaceManagerobjects.The
(upgradeonly) recommendationsallowforoneyearofgrowthinstatisticstables.
l Smallisfordatabaseswithlessthan1,000non-SYSsegments
l Mediumisfordatabaseswith1,000to9,999non-SYSsegments
l Largeisfordatabaseswith10,000to24,999non-SYSsegments
l Hugeisfordatabaseswithmorethan25,000non-SYSsegments
Note:Usethefollowingguidelinesfordeterminingspaceallocation:
smallforupto100GB,mediumforupto500GB,etc.
Allocationtouse SelectaspaceallocationforSpaceManagerobjects.Therecommended
allocationisenteredbydefault.
Expected VerifytheexpectedspaceallocationforSpaceManagerobjects.This
allocation correspondstotheAllocationtousevalue.
InstallSpace Ifyouwanttoinstalldemonstrationdataafterservercomponentsareinstalled,
Manager selectthischeckbox.Demonstrationdatarequires20MBor24MBofdisk
Demonstration space,dependingonyourdatabaseblocksize.
Data Note:IftheRecycleBinforanOracle10gdatabasecontainsmany
(installonly) objects,theCreateSpaceManagerwithLiveReorgObjectswindowmight
requirealongtimetodisplay.Toavoidthisproblem,emptytherecycle
binbeforeyoubegintheinstallation.
5. ClickOK.TheinstallationprogressdisplaysintheExecutingCreatedialog.Tocancelinstallation,
clickCancel.
Note:Insomecases,SpaceManagermaytrytoallocatemorethantheexpectedallocation.Itdoes
thiswhenatablespacehasalargeminimumextentsizeorislocallymanagedandusesuniform
extentallocation.Ineithercase,installationmayfail.Ifitdoes,clickOKtocleartheinstallationerror.
BegininstallationagainandselectalargertablespaceforSpaceManagerobjects.
6. YouwillencounterapromptifQUEST_COM_PRODUCTS_%tablesarealreadyinstalledforthetarget
databasebuttheownerisnottheinstallationDBAforSpaceManager.
l Tocontinue,clickYes.TheSpaceManagerobjectswillbeownedbytheinstallationDBA.And
QUEST_COM_PRODUCTS_%tableswillcontinuetobeownedbytheircurrentowner.(Public
synonymsandcertainviewswillbeownedbySYS.)
l Tocancelinstallation,clickNo.Then,whenyoustarttheinstallationagain,usetheQUEST_
COM_PRODUCTS_%tableownerastheinstallationDBA.SpaceManagerobjectsandQUEST_
COM_PRODUCTS_%tableswillbeownedbythisuser.(Publicsynonymsandcertainviewswill
beownedbySYS.)
7. IfO7_DICTIONARY_ACCESSIBILITYisFALSEforthetargetdatabaseandtheinstallationDBAdoesnot
haveEXECUTEonSYS.DBMS_SYS_SQL,youareallowedtorunscriptstogranttheprivilege.
l Whenprompted,entertheusernameandpasswordforaSYSDBAaccount.Thefirstscript
promptsyoutoenterthenameoftheinstallationDBA.
8. Whenservercomponentinstallationisfinished,oneofthefollowingdisplays:
l Asuccessmessagedisplaysifyouarenotinstallingdemonstrationdata.ClickOK.Thenthe
ServerAgentInstallerdisplayssothatyoucaninstalltheagent.SeeInstallorUpgradeServer
AgentonUNIXorLinuxonpage22formoreinformation.
l TheInstall/RefreshDemonstrationDatawindowdisplaysifyouareinstallingdemonstrationdata.
Seethenextstep.
WhenBEQUEATH_DETACHissettoNOorisnotsetforadatabase,theagentsjobschedulercannotdetect
whenscriptshavebeencancelledoraborted.Asaresult,cancelledandabortedscriptscannotberestarted
fromSpaceManager.IfyoutrytorestartascriptwhenBEQUEATH_DETACHissettoNO,oneoftheerrorsthat
mightdisplayis:
QSA-20311:Tableconflictwithscriptalreadyexecuting.
To set BEQUEATH_DETACH
1. OpentheSQLNET.ORAfileforthetargetdatabase.Thefileisstoredinadefaultdirectoryorone
specifiedwiththeTNS_ADMINenvironmentvariable.Thedefaultdirectoryvariesbyplatform:
l OnUNIXandLinuxdatabaseservers,thedefaultdirectoryis$ORACLE_HOME/network/admin
l OnWindowsdatabaseservers,thedefaultdirectoryisORACLE_HOME\network\admin
2. ChangetheBEQUEATH_DETACHsettingfromNOtoYESoraddthefollowingentrytothefile:
bequeath_detach=yes
3. SavetheSQLNET.ORAfile.
Valuesapplytothetargetdatabase.YoumustentervaluesforWORKDIR(usedforFastCopy/DBMS_
DataPump)andLW_TABLESPACE(usedforlivereorganizationsandrequiredevenifLiveReorgisnot
licensed).ClickNextwhenfinished.SeeQSAServerAgentParametersonpage27formore
information.
8. IntheInstallationFinishedwindow,clickFinishtoexittheServerAgentInstaller.
Note:BeforetheServerAgentisinstalled,youmayencounteroneofthefollowingmessages:
l Files not currentTheagentinstallationfilesareeithernotavailableornotcurrent.ExittheServer
AgentInstaller,installthemostrecentSpaceManagerclient.NewagentfilesarecopiedtoServer
Agentfolderontheclientcomputer.Youcantheninstalltheagent.
l Environment not supported / cannot proceedBothyourOracleversionandoperatingsystem
versionarenotsupported.Theagentcannotbeinstalled.YoumustupgradetoasupportedOracle
versionandasupportedoperatingsystem.SeetheSpace Manager Release Notesforalistof
supportedOracleDatabaseandOperatingSystemversions.
l Environment not supported / can proceedEitheryourOracleversionoryouroperatingsystem
versionisnotsupported.Inmostcases,asupportedversionofOracleisrunningonanunsupported
operatingsystemversion.Althoughyoucanproceedwiththeinstallation,youmayhaveproblems.
Prerequisites
l ForinstallationoneitheralocaloraremoteWindowsserver,theinstallationOracleDBAmusthaveall
permissionsfortheagentinstallationfolder.
l Onaremoteserver,thefoldermustbesharedorcopiedtotheserver.
Note:Ifupgradingtheserveragent,performtheupgradewhennoscheduledscriptsareexecutingorabout
toexecute.
3. Afterthefilesareextracted,theGUIinstallerautomaticallyopens.
4. IntheConnecttoOracleDatabasewindow,entertheservicenameofthetargetdatabaseandconnect
usingtheDBAaccountthatinstalledtheSpaceManagerservercomponents.
5. Follow the instructions in the previous section, Install the Agent on a Local Server, beginning
with step 3.
6. After installation, from the Windows Services window, verify that QSA is running. If Started does
not display as the QSA status, start the agent from the Services window or run the QSAStart.cmd
from the \bin folder under the agent installation folder (<installation path>\Quest Server
Agent\<ORACLE_SID>\bin).
Tip:Iftheagentisinstalledformorethanonedatabaseontheserver,lookfortheQuestServer
AgentnamethatincludesthetargetdatabaseSID.
(SERVICE_NAME=rac1)
(INSTANCE_NAME=rac11)
)
)
Parameter Description
LW_TABLESPACE LW_TABLESPACEspecifiesthetablespaceforobjectscreatedbyQSAduring
alivereorganization.OnesetofLiveReorgobjectsiscreatedforeachtableina
livereorganizationscript.Theobjectsareautomaticallydroppedafteratableis
reorganized.
LW_TABLESPACEmusthaveastandardnameandadatafilethatisatleast50
MBinsize.Thedatafilemusthaveatleast20MBofcontiguousfreespace.
Note:AtablespacemustbeselectedfortheLW_TABLESPACEparameter
evenifLiveReorgisnotlicensed.
WORKDIR WORKDIRspecifiesthemaindirectorythatFastCopy(orDBMS_DataPump)
shoulduseforthedataexportedtothefilesystemduringareorganization.If
QSAisinstalledonaremoteWindowsserver(separatefromtheSpace
Managerclientcomputer),specifythisdirectoryasifitwereonalocaldrive,for
example,C:\TEMP.EnterthedirectoryandpathinASCIIcharacters.
COMMIT_SIZE COMMIT_SIZEdeterminestheamountofdataFastCopyorFSCopyimports
fromthefilesystemintothedatabasebeforeaCOMMITisperformed.The
parametervaluecanrangefrom1MBto1024MB.Thedefaultis10MB.
COUNT_STAR ThisparameterdetermineswhetherQuestServerAgent(QSA)performsa
selectcount(*)ontheorig_tableandcomparesthistothenumberofrows
copied.Selectoneofthefollowingtoindicatewhetheryouwanttheagentto
performthisextracheck.
Select1toperformthecheck.Thisisthedefault.
Select0toNOTperformthecheck.
DISKSPACE_ DISKSPACE_RESERVEdetermineshowmuchspaceisreservedfor
RESERVE applicationsinWORKDIRandOVERFLOWdirectories.Unreservedspacecan
beusedbyFastCopy/DBMS_DataPumporFSCopyfordataexportedduringa
reorganization.OnceFastCopy/DBMS_DataPumporFSCopyusesall
unreservedspaceintheWORKDIRdirectory,itusesunreservedspaceinthe
firstOVERFLOWdirectory.Theparametervaluecanrangefrom1MBto1024
MB.Thedefaultis10MB.
EXPORT_BUFFER_ EXPORT_BUFFER_SIZEdeterminesthemaximumsizeoftheexportbuffer
SIZE usedbyFastCopyorFSCopy.Reorganizationsarefasterwhenexportbuffer
sizeisatleastthesizeofthelargestrowbeingreorganized.Theparameter
valuecanrangefrom32KBto1024MB.Thedefaultis1MB.
IMPORT_METHOD IMPORT_METHODdetermineshowFastCopyorFSCopyimportsdatafromthe
filesystemintothedatabase.Therearethreeoptions:
l AUTOFastCopyorFSCopyusesseveralfactors(unsupporteddata
types,rowslargerthan64KB,andSQL*Loadererrors)todetermine
whethertousethedirectorconventionalimportmethod.FastCopyor
FSCopytriesthedirectmethodfirst.Ifunsuccessful,itautomatically
switchestotheconventionalmethod.
l DIRECTFastCopyorFSCopyusesSQL*Loadersdirectpathload.
Thedirectmethodisfasterthantheconventionalbecauseitusesthe
directpathAPItomovedataandbypassesSQLprocessing.FastCopy
orFSCopyabortsthereorganization,however,ifitencountersan
unsupporteddatatype,arowlargerthan64KB,oraSQL*Loadererror.
l CONVENTIONALFastCopyorFSCopyusesOCIarrayinsertstomove
data.Althoughslowerthanthedirectmethod,theconventionalmethod
hasfewerlimitationsandassociatedproblems.Thisisthedefault.
IMPORT_BUFFER_ IMPORT_BUFFER_SIZEdeterminesthemaximumsizeoftheimportbufferthat
SIZE FastCopyorFSCopyusesduringimportswiththeconventionalmethod.The
parametervaluecanrangefrom1MBto1024MB.Thedefaultis10MB.
LW_NULL_COLUMNS Thisparameterdeterminesthemaximumnumberofcolumnstocheckfora
NULLvalue.Thedefaultis32andshouldnotbechanged.
MAX_FILE_SIZE MAX_FILE_SIZEdeterminesthemaximumsizeofFastCopyorFSCopyexport
files,whichareusedforthedataexportedfromthedatabasetothefilesystem.
(FastCopyfilesareinaproprietaryformat.)Whenthefirstfilereachesthe
maximumsize,asecondfileiscreatedautomatically,andsoon.Theparameter
valuecanrangefrom1MBto1024MB.(Itmustbelessthanyoursystems
defaultmaximumfilesize.)Thedefaultis100MB.
MAX_HISTORY_AGE MAX_HISTORY_AGEdeterminesthemaximumnumberofdaysthatrecords
arekeptintheQUEST_SCRIPT_HISTORYtable.Thetablecontainsahistoryof
scriptexecutionbyQSAandisusedtoassociatescriptlogswiththeirscripts.
Theparametervaluecanrangefrom0to32765.(Itshouldbegreaterthanthe
valueforMAX_LOG_AGE.)Thedefaultis365.
MAX_LOG_AGE MAX_LOG_AGEdeterminesthemaximumnumberofdaysthatscriptexecution
logsandQSAlogarekept.Scriptlogscanbeusedtotroubleshootscript
executionbytheagent.Theagentlog(QEXECD.LOG)canbeusedto
troubleshootallagentactivity.YoucanviewlogsfromSpaceManagers
Script/JobMonitor.YoucansendthemtoQuestSoftwareSupport.The
parametervaluecanrangefrom0to365.(0retainslogsuntilSpaceManager
isuninstalled.)Thedefaultis30.
MULTIBLOCK_READ_ MULTIBLOCK_READ_COUNTdeterminesthenumberofdatablocksthat
COUNT OraclereadsatonetimeduringaFastCopyreorganization.Thenumbershould
beamultipleofthesizeofyouroperatingsystemreadbufferdividedbyyour
databaseblocksize.Forexample,ifyouroperatingsystemreadbufferis256
KBandyourdatabaseblocksizeis8KB,settheparametertoamultipleof32
KB.Theparametervaluemustbegreaterthanorequalto0.Thedefaultis100.
OVERFLOW_DIR_01 OVERFLOW_DIRspecifiesdirectoriesthatcanbeusedinadditiontothe
thruDIR_05 WORKDIRdirectoryforthedataFastCopy/DBMS_DataPumpexports.
FastCopy/DBMS_DataPumpusesoverflowdirectorieswhenWORKDIRisfull.
Youcanspecifyupto5directories.Anewdirectoryisusedwhenthelastone
usedisfull.DirectoryandpathnamesmustbeenteredinASCIIcharacters.
Note:Eachoverflowdirectorymustbeonadifferentdisk.TheWORKDIR
diskmustnotbeusedforanOVERFLOW_DIR.
SENDMAIL Parameters
SENDMAILparametersallowyoutoconfigureQSAtoautomaticallysendemailnotificationswhenscheduled
scriptexecutionfails.Notificationsidentifythefailurereason,scriptname,executionstartandstoptimes,
databaseserverhostname,anddatabaseOracleSID.ThesubjectfielddisplaysScriptFailureNotice!
SENDMAILincludesthefollowingparameters(allexceptSENDMAIL_TO1requirevalues).
SENDMAIL_ Specifiesthedomainnameofthemailserverorrelayserver.Forexample:
DOMAIN yourcompany.com.
SENDMAIL_HOST Specifiestheaddressorfully-qualifiednameofthemailserverorrelayserver
host,forexample:www.quest.com.
SENDMAIL_PORT Specifiestheportnumberonwhichthemailserverorrelayserverislistening.
SENDMAIL_FROM Specifieswhosenttheemailnotification.Thetextstringyouentershouldbethe
emailaddressofanindividualorgroup,suchas
Administrator@yourcompany.com.
SENDMAIL_TO Specifiestheemailrecipient.Mustbetheemailaddressofanindividualorgroup,
suchasDBA@yourcompany.com.Theaddressmustbevalid.Onlyoneaddress
maybeentered.
SENDMAIL_TO1 Specifiesasecondrecipientforemailnotifications.
Tospecifythreeormorerecipients,insertarowforeachrecipientintheQUEST_
EXEC_PARAMETERtable,whereNAMEisSENDMAIL_TO#andVALUEisa
validemailaddress.EachSENDMAIL_TO#entryshouldincrementby1;for
example,SENDMAIL_TO3,SENDMAIL_TO4.Ifthereisabreakinthenumber
sequence,emailsarenotsenttorecipientsafterthebreak.Ifyoudeletearecipient
row,updatetheNAMErowsthatfollowsothenumbersequenceispreserved.You
canspecifyamaximumof99recipients.
SNMP_TO_HOST EnterthehostnamefortheSNMPmonitor.
SNMP_PORT EntertheportnumberthattheSNMPmonitorislisteningon.
SNMP_COMMUNITY EnterthenameofyourSNMPcommunity(oranyuniquestringvalue).
Parameter Description
SEND_GROUP_STATUS Sendnotificationofastaticchangetothegroupstatus.
SEND_SCRIPT_START Sendnotificationwhenscriptstarts(101).
SEND_SCRIPT_RESTART Sendnotificationwhenscriptisrestarted(104).
SEND_SCRIPT_ Sendnotificationwhenscriptisunscheduled(110).
UNSCHEDULED
SEND_SCRIPT_COMPLETE Sendnotificationwhenscriptcompletes(210).
SEND_SCRIPT_CANCELLED Sendnotificationwhenscriptiscancelled(310).
SEND_SCRIPT_ABORT Sendnotificationwhenscriptaborts(320).
SEND_SCRIPT_HALTED Sendnotificationwhenscriptishalted(370).
SEND_SCRIPT_SCHEDULED Sendnotificationwhenascriptisscheduled(410).
SEND_LR_WAIT_WINDOW SendnotificationwhenaLiveReorgiswaitingforwindow(620).
SEND_LR_IN_WINDOW SendnotificationwhenaLiveReorgisinthewindow(621).
SEND_LR_WAIT_APPROVAL SendnotificationwhenaLiveReorgiswaitingforapproval(630).
SEND_LR_APPROVED SendnotificationwhenaLiveReorgisapproved(631).
SEND_LR_START SendnotificationwhenaLiveReorgstarts(710).
SEND_LR_RESTART SendnotificationwhenaLiveReorgrestarts(715).
SEND_LR_COPY_START SendnotificationwhenaLiveReorgtablecopystarts(720).
SEND_LR_COPY_COMPLETE SendnotificationwhenaLiveReorgtablecopycompletes(730).
SEND_LR_SWITCH_START SendnotificationwhenaLiveReorgstartstoswitch(740).
SEND_LR_SWITCH_ SendnotificationwhenaLiveReorgswitchcompletes(750).
COMPLETE
SEND_LR_COMPLETE SendnotificationwhenaLiveReorgcompletes(760).
Settingthisparametersendsanemailwithoutaresultsreport.To
includearesultsreport,useoneoftheSEND_LR_COMPLETE
parameterslistedbelow.
SEND_LR_COMPLETE Options
UsethefollowingparameterstospecifythetypeofresultsreporttoincludewhenusingtheSEND_LR_
COMPLETEparameter.
Parameter Description
LOCKS_ SelectYEStoenablelocksreporting.
REPORTING Default: NO
Note:Whenyoudisablelocksreporting,thevaluesselectedfortheother
parametershavenoeffect.
LOCKS_ SelectYEStoenablereportingoflocksforcanceledjobs.
CANCELED_JOBS Default: YES
Note:SpaceManagerreportslocksheldbyOraclesessionsforcanceled
jobstotheqexecd.logfilebeforecancelingthejob.
LOCKS_SCRIPT_ SelectYEStoenablereportingoflockswhenatablelockoraT-Lockfailswitha
LOG resourcebusyerror(ORA-0054).
Default: YES
Note:SpaceManagerreportstheselockstothescriptexecutionlogthatyou
canviewusingtheScript/JobMonitor.
LOCKS_SYSTEM_ SelectYEStoenablereportingoflockstoasystemfile.
FILE_LOGS Default: NO
LOCKS_SYSTEM_ SelectYEStoappendthesystemfilecreatedforlocksreporting.
FILE_APPEND Default: YES
Note:Ifyoudisablethisparameter,thesystemfileonlycontainsinformation
forthemostrecentlockreported.
LOCKS_MAXIMUM_ Enteravalueforthenumberoftimestoreportlocksforaspecifictable.
REPORTS Range: 1 to 999
Default: 3
Tip:Asinglelockmayberetiredthousandsoftimesduringasingle
reorganization.Usethedefaultvaluetominimizechangestothesystemfile.
Note:SpaceManagercreatessystemfilesintheQSAlogfiledirectorywiththefollowingnaming
convention:<owner>.<folder>.<script>.<jobnumber>.lok
Oracle Upgrade
IfyouplantoupgradefromoneversionofOracleDatabasetoanother,uninstallQSAfirst.AfterthenewOracle
databaseisinstalled,reinstalltheserverandtheQSAagent.
ServercomponentsmustbeuninstalledbytheDBAthatinstalledthem.Theymustberemovedindividuallyfrom
eachdatabaseinwhichtheyareinstalled.
Normally,demonstrationdataisautomaticallyremovedalongwithservercomponents.However,thedataisnot
removedwhendemonstrationtablespacescontainobjectsthatarenotownedbythedemonstrationuser.To
ensurethatdemonstrationdataisremoved,relocatenon-demonstrationobjectsbeforeyouuninstalltheserver
components.
Afterdemonstrationdataisuninstalled,manuallydeletethedemonstrationdatafiles,SPCDEMO01_nn.dbfand
SPCDEMO02_nn.dbf.
3. IftheuninstallprogramdetectsscriptsthatarebeingexecutedbyQSA,youmustcanceltheuninstall.
Youcanfinishtheuninstallafterscriptexecutioniscomplete.
4. Iftheuninstallprogramdeterminesthatoneormorescriptsarescheduledtorun,amessagedisplays
thedateandtimeforthefirstscriptandasksifyouwanttocontinuetheuninstall:
l Ifyouwanttocontinueandaresurethattheuninstallprocesswillfinishbeforethefirstscript
runs,clickYes.
l Ifyouwanttocanceltheuninstall,clickNo.
5. Onceverificationsarecomplete,aconfirmationmessageexplainsthatallSpaceManagerobjectswillbe
removedfromtheserver.ClickYes.TheSQLExecdialogdisplaystheuninstallprogressandstatus.
6. Afterservercomponentsareuninstalled,theQSAInstallerdisplayssothatyoucanremovetheagent.
SeeUninstalltheServerAgentonpage34formoreinformation.
TomanuallyuninstalltheServerAgentfromWindows,see"ManuallyUninstallServerAgentfromWindows"in
theSpace Manager Installation Guide.
4. ThisremovesallSpaceManagerfiles,folders,andregistrykeysfromyoursystem.
Caution: Before you manually install QSA, set the SQL*Plus PAUSE command to OFF (the default
setting). If another setting is used, such as ON or PAGE, manual installation fails. After installation is
complete, you can set the PAUSE command to any value.
4. ToextractagentinstallationfilesfromtheServerAgentTARfile,usethefollowingcommand(filenameis
9. Ifthisisafirst-timeinstallation,specifythetablespaceforagenttables(thetablespaceusedforSpace
Managerobjectsisrecommended):
l Tousethetablespaceselectedbydefault,pressEnterattheTablespaceprompt.
l Touseadifferenttablespace,enterthenameattheTablespaceprompt.ThenpressEnter.
10. Specifyanaccountunderwhichtheagentshouldrun(runningaccount):
l Touseoracle,thedefaultrunningaccount,pressEnterattheUser to run asprompt.
l Touseanotheraccount,entertheaccountloginnameattheUser to run asprompt.Then
pressEnter.
11. Afteryoulogintotheoperatingsystem,oneoftwomessagesmightappear:
l Environment not supported/cannot proceedBothyourOracleversionandoperatingsystem
versionarenotsupportedTheagentcannotbeinstalled.Youmustupgradetoasupported
Oracleversionandasupportedoperatingsystem.SeeSystemRequirements"intheSpace
Manager Release Notes.
l Environment not supported/can proceedEitheryourOracleversionoroperatingsystem
versionisnotsupported.Inmostcases,asupportedversionofOracleisbeingrunonan
unsupportedoperatingsystemversion.Althoughyoucanproceedwiththeinstallation,youmay
haveproblems.
12. Ifthisisafirst-timeinstallation,specifythebaseinstalldirectory:
l Tousethedefaultbaseinstalldirectory,pressEnterattheInstallation directoryprompt.The
defaultis$ORACLE_HOME.
l Touseadifferentbaseinstalldirectory,enterthedirectorynameandpathattheInstallation
directoryprompt.ThenpressEnter.
Note:Afteryouspecifythebaseinstalldirectory,/Quest/QSA/$ORACLE_SIDisaddedtothe
directorypath.
13. Tobegintheagentinstallationorupgrade,enterYattheProceedprompt.
14. FromtheQuestServerAgentParameterswindow,specifyagentparametervaluesforthetarget
database.YoumustentervaluesforWORKDIR(usedforFastCopy)andLW_TABLESPACE(usedfor
livereorganizations;requiredevenifLiveReorgisnotlicensed).Respondtopromptsasfollows:
a. AttheDo you wish to modify any of these parametersprompt,enterY.
b. AtthePlease enter the ID number of the parameterprompt,entertheIDnumberofthe
parameteryouwanttomodify.
c. Attheparameterprompt,enterormodifytheparametervalue.
d. Repeatstepsathroughcforeachparameteryouwanttoset.
4. Runtheexecutableandextractthesefilestoatemporarydirectory.
Note:Makesurethetemporarydirectoryisemptybeforeyouextractthefiles.
5. Edittheqsaparms.batfile.Seetheexampleinthefollowingsection,Sampleqsaparms.batfile."
Note:Theqsaparms.batfilecontainsbriefinstructionsonwhatyoushouldchange.
6. ExecuteInstall.bat.
Note:Forbestresults,usethecommandwindowtoexecutethisfile.Thiswillallowyoutosee
progressanderrormessages.
7. AfteryouinstalltheQSAserverandverifythatitisworking,completelyremovetheinstallationfilesfrom
thetemporarydirectory.
Parametersthatrequireeditingareinbold.
rem *******************************************
rem qsaparms.bat: QSA manual installation
rem script parameter file
rem
rem *******************************************
rem *******************************************
rem START USER CONFIGURABLE SECTION
rem *******************************************
rem *******************************************
rem *******************************************
rem set the values for the following variables
rem any default values have been pre-assigned
rem *******************************************
rem
rem QSA_GUI when set to YES will cause the
rem installer to not pause
rem
set QSA_GUI=NO
rem
rem NOTE: Setting qsagetparms to NO,
rem will cause this script to ignore
rem parms contained in the database
rem and will use what is defined here
rem for upgrades and uninstalls.
rem
rem set qsagetparms=NO
rem *********************
set qsagetparms=YES
rem *********************
rem
rem ***********************
rem ***********************
rem Set qsaparms value to
rem YES after you have
rem finished editing this
rem script.
rem ***********************
rem ***********************
rem
set qsaparms=NO
rem
rem ***********************
rem ***********************
rem Set qsaforce value to
rem YES if the install
rem fails because the platform
rem is not correct. qsaforce
rem will prevent the platform
rem validation from executing.
rem ***************************
rem ***************************
rem
# /tmp/root_uninstall.sh $ORACLE_SID
2. Rununinstall.bat.
Contact Quest
Forsalesorotherinquiries,visitwww.quest.com/company/contact-us.aspxorcall1-949-754-8000.