ADRCI - ADR Command Interpreter

(//docs.oracle.
com/en/)
SignIn(http://www.oracle.com/webapps/redirect/signon?nexturl=http://docs.oracle.com/cd/B28359_01/server.111/b28319/adrci.htm)
Home(https://docs.oracle.com/)/Database(https://docs.oracle.com/en/database/)/OracleDatabaseOnlineDocumentation
11gRelease1(11.1)(../../index.htm)/DataWarehousingandBusinessIntelligence(../../nav/portal_6.htm)
DatabaseUtilities
()
()
15()ADRCI:ADRCommand
Interpreter
TheADRCommandInterpreter(ADRCI)isacommandlinetoolthatyouuse
tomanageOracleDatabasediagnosticdata.
Thischaptercontainsthefollowingsections:
AbouttheADRCommandInterpreter(ADRCI)
Definitions
StartingADRCIandGettingHelp
SettingtheADRCIHomepathBeforeUsingADRCICommands
ViewingtheAlertLog
FindingTraceFiles
ViewingIncidents
PackagingIncidents
ADRCICommandReference
TroubleshootingADRCI
SeeAlso:
OracleDatabaseAdministrator'sGuide
(../../server.111/b28310/diag.htm#ADMIN11007)formoreinformationon
managingdiagnosticdata.
()
AbouttheADRCommand
Interpreter(ADRCI)
ADRCIisacommandlinetoolthatispartofthefaultdiagnosability
infrastructureintroducedinOracleDatabaseRelease11g.ADRCIenables
youto:
ViewdiagnosticdatawithintheAutomaticDiagnosticRepository(ADR).
ViewHealthMonitorreports.
Packageincidentandprobleminformationintoazipfilefortransmissionto
OracleSupport.
Diagnosticdataincludesincidentandproblemdescriptions,tracefiles,
dumps,healthmonitorreports,alertlogentries,andmore.
ADRCIhasarichcommandset,andcanbeusedininteractivemodeor
withinscripts.Inaddition,ADRCIcanexecutescriptsofADRCIcommandsin
thesamewaythatSQL*PlusexecutesscriptsofSQLandPL/SQL
commands.
ADRdataissecuredbyoperatingsystempermissionsontheADR
directories,hencethereisnoneedtologintoADRCI.
Note:
Theeasiestandrecommendedwaytomanagediagnosticdatais
withOracleEnterpriseManagerSupportWorkbench.ADRCI
providesacommandlinealternativetomostofthefunctionalityof
SupportWorkbench,andaddscapabilitiessuchaslistingand
queryingtracefiles.
SeeOracleDatabaseAdministrator'sGuide
(../../server.111/b28310/diag.htm#ADMIN11007)forcompleteinformation
abouttheSupportWorkbench.
()
Definitions
ThefollowingaredefinitionsoftermsusedinthecontextofADRCIandthe
OracleDatabasefaultdiagnosabilityinfrastructure:
()AutomaticDiagnosticRepository(ADR)
()TheADRisafilebasedrepositoryfordatabasediagnosticdatasuchas
traces,dumps,thealertlog,healthmonitorreports,andmore.Ithasaunified
directorystructureacrossmultipleinstancesandmultipleproducts.
BeginningwithRelease11g,thedatabase,AutomaticStorageManagement
(ASM),andotherOracleproductsorcomponentsstorealldiagnosticdatain
theADR.Eachinstanceofeachproductstoresdiagnosticdataunderneath
itsownADRhomedirectory(see"ADRHome").Forexample,inanOracle
RealApplicationClustersenvironmentwithsharedstorageandASM,each
databaseinstanceandeachASMinstancehasahomedirectorywithinthe
ADR.TheADR'sunifieddirectorystructureenablescustomersandOracle
Supporttocorrelateandanalyzediagnosticdataacrossmultipleinstances
andmultipleproducts.
()Problem
()Aproblemisacriticalerrorinthedatabase.Criticalerrorsincludeinternal
errorssuchas ORA00600 andothersevereerrorssuchas ORA07445

(operatingsystemexception)or ORA04031 (outofmemoryintheshared
pool).ProblemsaretrackedintheADR.Eachproblemhasaproblemkey
andauniqueproblemID.(See"ProblemKey".)
()Incident
()Anincidentisasingleoccurrenceofaproblem.Whenaproblemoccurs
multipletimes,anincidentiscreatedforeachoccurrence.Incidentsare
trackedintheADR.EachincidentisidentifiedbyanumericincidentID,
whichisuniquewithintheADR.Whenanincidentoccurs,thedatabase
makesanentryinthealertlog,sendsanincidentalerttoOracleEnterprise
Manager,gathersdiagnosticdataabouttheincidentintheformofdumpfiles
(incidentdumps),tagstheincidentdumpswiththeincidentID,andstoresthe
incidentdumpsinanADRsubdirectorycreatedforthatincident.
Diagnosisandresolutionofacriticalerrorusuallystartswithanincidentalert.
YoucanobtainalistofallincidentsintheADRwithanADRCIcommand.
Eachincidentismappedtoasingleproblemonly.
Incidentsarefloodcontrolledsothatasingleproblemdoesnotgeneratetoo
manyincidentsandincidentdumps.SeeOracleDatabaseAdministrator's
Guide(../../server.111/b28310/diag001.htm#ADMIN11259)formoreinformationon
incidentfloodcontrol.
()ProblemKey
()Everyproblemhasaproblemkey,whichisatextstringthatincludesan
errorcode(suchas ORA 600 )andinsomecases,oneormoreerror

parameters.Twoincidentsareconsideredtohavethesamerootcauseif
theirproblemkeysmatch.
()IncidentPackage
()Anincidentpackage(package)isacollectionofdataaboutincidentsfor
oneormoreproblems.BeforesendingincidentdatatoOracleSupportit
mustbecollectedintoapackageusingtheIncidentPackagingService(IPS).
Afterapackageiscreated,youcanaddexternalfilestothepackage,
removeselectedfilesfromthepackage,orscrub(edit)selectedfilesinthe
packagetoremovesensitivedata.
Apackageisalogicalconstructonly,untilyoucreateaphysicalfilefromthe
packagecontents.Thatis,anincidentpackagestartsoutasacollectionof
metadataintheAutomaticDiagnosticRepository(ADR).Asyouaddand
removepackagecontents,onlythemetadataismodified.Whenyouare
readytouploadthedatatoOracleSupport,youcreateaphysicalpackage
usingADRCI,whichsavesthedataintoazipfile.
()Finalizing
()BeforeADRCIcangenerateaphysicalpackagefromalogicalpackage,the
packagemustbefinalized.Thismeansthatothercomponentsarecalledto
addanycorrelateddiagnosticdatafilestotheincidentsalreadyinthis
package.Finalizingalsoaddsrecenttracefiles,alertlogentries,Health
Monitorreports,SQLtestcases,andconfigurationinformation.Thisstepis
runautomaticallywhenaphysicalpackageisgenerated,andcanalsoberun
manuallyusingtheADRCIutility.Aftermanuallyfinalizingapackage,youcan
reviewthefilesthatwereaddedandthenremoveoreditanythatcontain
sensitiveinformation.
SeeAlso:
(../../server.111/b28310/diag010.htm#ADMIN12304)formoreinformation
aboutcorrelateddiagnosticdata
()ADRHome
()()AnADRhomeistherootdirectoryforalldiagnosticdatatraces,dumps,
alertlog,andsoonforaparticularinstanceofaparticularOracleproduct
orcomponent.Forexample,inaRealApplicationClustersenvironmentwith
ASM,eachdatabaseinstanceandeachASMinstancehasanADRhome.All
ADRhomessharethesamehierarchicaldirectorystructure.Someofthe
standardsubdirectoriesineachADRhomeincludealert(forthealertlog),
trace(fortracefiles),andincident(forincidentinformation).AllADRhomes
arelocatedwithintheADRbasedirectory.(See"ADRBase".)
SomeADRCIcommandscanworkwithmultipleADRhomessimultaneously.
ThecurrentADRCIhomepathdeterminestheADRhomesthataresearched
fordiagnosticdatawhenanADRCIcommandisissued.See"Homepath"for
moreinformation.
()ADRBase
()()TopermitcorrelationofdiagnosticdataacrossmultipleADRhomes,ADR
homesaregroupedtogetherunderthesamerootdirectorycalledtheADR
base.Forexample,inanOracleRealApplicationClusters(RAC)
environment,theADRbasecouldbeonashareddisk,andtheADRhome
foreachOracleRACinstancecouldbelocatedunderthisADRbase.
ThelocationoftheADRbaseforadatabaseinstanceissetbythe
DIAGNOSTIC_DEST initializationparameter.Ifthisparameterisomittedoris
null,thedatabasesetsittoadefaultvalue.SeeOracleDatabase
Administrator'sGuide(../../server.111/b28310/diag001.htm#ADMIN11008)fordetails.
WhenmultipledatabaseinstancesshareanOraclehome,whethertheyare
multiplesingleinstancesortheinstancesofanOracleRealApplication
Clustersdatabase,andwhenoneormoreoftheseinstancessetADRbase
indifferentlocations,thelastinstancetostartupdeterminesthedefaultADR
baseforADRCI.
()Homepath
()()AllADRCIcommandsoperateondiagnosticdatainthe"current"ADR
homes.MorethanoneADRhomecanbecurrentatanyonetime.Some
ADRCIcommands(suchas SHOW INCIDENT )searchforanddisplay
diagnosticdatafromallcurrentADRhomes,whileothercommandsrequire
thatonlyoneADRhomebecurrent,anddisplayanerrormessageifmore
thanoneiscurrent.
TheADRCIhomepathdeterminestheADRhomesthatarecurrent.Itdoes
sobypointingtoadirectorywithintheADRbasehierarchy.Ifitpointstoa
singleADRhomedirectory,thatADRhomeistheonlycurrentADRhome.If
thehomepathpointstoadirectorythatisabovetheADRhomedirectory
levelinthehierarchy,allADRhomesthatarebelowthedirectorythatis
pointedtobecomecurrent.
ThehomepathisnullbydefaultwhenADRCIstarts.ThismeansthatallADR
homesunderADRbasearecurrent.
The SHOW HOME and SHOW HOMEPATH commandsdisplayalistoftheADR
homesthatarecurrent,andthe SET HOMEPATH commandsetsthe
homepath.
SeeAlso:
(../../server.111/b28310/diag001.htm#ADMIN11008)formoreinformationon
thestructureandlocationoftheADRanditsdirectories.
"SettingtheADRCIHomepathBeforeUsingADRCICommands"
"SETHOMEPATH"
"SHOWHOMES"
()
StartingADRCIandGettingHelp
()()YoucanuseADRCIininteractivemodeorbatchmode.Detailsare
providedinthefollowingsections:
UsingADRCIinInteractiveMode
GettingHelp
UsingADRCIinBatchMode
()
UsingADRCIinInteractiveMode
Interactivemodepromptsyoutoenterindividualcommandsoneatatime.
Eachenteredcommandisfollowedbyitsoutput.
()TouseADRCIininteractivemode:
1. Ensurethatthe ORACLE_HOME and PATH environmentvariablesareset

properly.
OntheWindowsplatform,theseenvironmentvariablesaresetinthe
Windowsregistryautomaticallyuponinstallation.Onotherplatforms,you
mustsetandcheckenvironmentvariableswithoperatingsystem
commands.
The PATH environmentvariablemustincludeORACLE_HOME/bin.
2. Enterthefollowingcommandattheoperatingsystemcommandprompt:
ADRCI
Theutilitystartsanddisplaysthefollowingprompt:
adrci>
3. EnterADRCIcommands,followingeachwiththeEnterkey.
4. EnteroneofthefollowingcommandstoexitADRCI:
EXIT
QUIT
()
GettingHelp
WiththeADRCIhelpsystem,youcan:
ViewalistofADRcommands.
Viewhelpforanindividualcommand.
ViewalistofADRCIcommandlineoptions.
ToviewalistofADRCIcommands:
1. StartADRCIininteractivemode.
See"UsingADRCIinInteractiveMode"forinstructions.
2. AttheADRCIprompt,enterthefollowingcommand:
HELP
TogethelpforaspecificADRCIcommand:
See"UsingADRCIinInteractiveMode"forinstructions.
HELPcommand
Forexample,togethelponthe SHOW TRACEFILE command,enterthe

following:
HELPSHOWTRACEFILE
Toviewalistofcommandlineoptions:
Enterthefollowingcommandattheoperatingsystemcommandprompt:
ADRCIHELP
Theutilitydisplaysoutputsimilartothefollowing:
Syntax:
adrci[help][script=script_filename][exec="command[comma
OptionsDescription(Default)
scriptscriptfilename(None)
helphelponthecommandoptions(None)
execexecasetofcommands(None)
()
UsingADRCIinBatchMode
()BatchmodeenablesyoutorunaseriesofADRCIcommandsatonce,
withoutbeingpromptedforinput.Tousebatchmode,youaddacommand
lineparametertothe ADRCI commandwhenyoustartADRCI.Batchmode
enablesyoutoincludeADRCIcommandsinshellscriptsorWindowsbatch
files.Likeinteractivemode,the ORACLE_HOME and PATH environment
variablesmustbesetbeforestartingADRCI.
Thefollowingcommandlineparametersareavailableforbatchoperation:
()()Table151ADRCICommandLineParametersforBatchOperation
Parameter
Description
EXEC
Enablesyoutosubmit
oneormoreADRCI
commandsonthe
operatingsystem
commandlinethat
startsADRCI.
Commandsare
separatedby
semicolons().
SCRIPT
Enablesyoutoruna
scriptcontaining
ADRCIcommands.
TosubmitADRCIcommandsonthecommandline:
ADRCIEXEC="COMMAND[COMMAND]..."
Forexample,torunthe SHOW HOMES commandinbatchmode,enterthe

followingcommandattheoperatingsystemcommandprompt:
ADRCIEXEC="SHOWHOMES"
Torunthe SHOW HOMES commandfollowedbythe SHOW INCIDENT

command,enterthefollowing:
ADRCIEXEC="SHOWHOMESSHOWINCIDENT"
TorunADRCIscripts:
ADRCISCRIPT=SCRIPT_FILE_NAME
Forexample,torunascriptfilenamed adrci_script.txt ,enterthe

followingcommandattheoperatingsystemcommandprompt:
ADRCISCRIPT=adrci_script.txt
Ascriptfilecontainsaseriesofcommandsseparatedbysemicolons()or
linebreaks,suchas:
SETHOMEPATHdiag/rdbms/orcl/orclSHOWALERTterm
()
SettingtheADRCIHomepath
BeforeUsingADRCICommands
Whendiagnosingaproblem,youmaywanttoworkwithdiagnosticdatafrom
multipledatabaseinstancesorcomponents,oryoumaywanttofocuson
diagnosticdatafromoneinstanceorcomponent.Toworkwithdiagnostic
datafrommultipleinstancesorcomponents,youmustensurethattheADR
homesforalloftheseinstancesorcomponentsare"current."Toworkwith
diagnosticdatafromonlyoneinstanceorcomponent,youmustensurethat
onlytheADRhomeforthatinstanceorcomponentiscurrent.Youcontrolthe
ADRhomesthatarecurrentbysettingtheADRCIhomepath.
Ifmultiplehomesarecurrent,thismeansthatthehomepathpointstoa
directoryintheADRdirectorystructurethatcontainsmultipleADRhome
directoriesunderneathit.TofocusonasingleADRhome,youmustsetthe
homepathtopointlowerinthedirectoryhierarchy,toasingleADRhome
directory.
Forexample,iftheOracleRealApplicationClusters(RAC)databasewith
databasename orclbi hastwoinstances,wheretheinstanceshaveSIDs
orclbi1 and orclbi2 ,thefollowingtwoADRhomesexist:
/diag/rdbms/orclbi/orclbi1/
/diag/rdbms/orclbi/orclbi2/
NotethatinallADRCIcommandsandoutput,ADRhomedirectorypaths
(ADRhomes)arealwaysexpressedrelativetoADRbase.SoifADRbaseis
currently/u01/app/oracle,theabsolutepathsofthesetwoADRhomesare
thefollowing:
/u01/app/oracle/diag/rdbms/orclbi/orclbi1/
/u01/app/oracle/diag/rdbms/orclbi/orclbi2/
Youusethe SET HOMEPATH commandtosetoneormoreADRhomestobe

current.IfADRbaseis/u01/app/oracleandyouwanttosetthehomepathto
/u01/app/oracle/diag/rdbms/orclbi/orclbi2/,youusethiscommand:
adrci>sethomepathdiag/rdbms/orclbi/orclbi2
WhenADRCIstarts,thehomepathisnullbydefault,whichmeansthatall
ADRhomesunderADRbasearecurrent.Inthepreviouslycitedexample,
therefore,theADRhomesforbothOracleRACinstanceswouldbecurrent:
adrci>showhomes
ADRHomes:
diag/rdbms/orclbi/orclbi1
Inthiscase,anyADRCIcommandthatyourun,assumingthatthecommand
supportsmorethanonecurrentADRhome,workswithdiagnosticdatafrom
bothADRhomes.Ifyouweretosetthehomepathto
/diag/rdbms/orclbi/orclbi2,onlytheADRhomefortheinstancewithSID
orclbi2 wouldbecurrent:
adrci>sethomepathdiag/rdbms/orclbi/orclbi2
adrci>showhomes
ADRHomes:
Inthiscase,anyADRCIcommandthatyourunwouldworkwithdiagnostic
datafromthissingleADRhomeonly.
SeeAlso:
thestructureofADRhomes
"ADRBase"
"ADRHome"
"Homepath"
"SETHOMEPATH"
"SHOWHOMES"
()
ViewingtheAlertLog
BeginningwithRelease11gofOracleDatabase,thealertlogiswrittenas
bothanXMLformattedfileandasatextfile.Youcanvieweitherformatof
thefilewithanytexteditor,oryoucanrunanADRCIcommandtoviewthe
XMLformattedalertlogwiththeXMLtagsstripped.Bydefault,ADRCI
displaysthealertloginyourdefaulteditor.Youcanusethe SET EDITOR
commandtochangeyourdefaulteditor.
ToviewthealertlogwithADRCI:
See"StartingADRCIandGettingHelp"forinstructions.
2. (Optional)Usethe SET HOMEPATH commandtoselect(makecurrent)a
singleADRhome.
Youcanusethe SHOW HOMES commandfirsttoseealistofcurrentADR
homes.See"Homepath"and"SettingtheADRCIHomepathBeforeUsing
ADRCICommands"formoreinformation.
SHOWALERT
IfmorethanoneADRhomeiscurrent,youarepromptedtoselectasingle
ADRhomefromalist.Thealertlogisdisplayed,withXMLtagsstripped,in
yourdefaulteditor.
4. ExittheeditortoreturntotheADRCIcommandprompt.
Thefollowingarevariationsonthe SHOW ALERT command:

SHOWALERTTAIL
Thisdisplaysthelastportionofthealertlog(thelast10entries)inyour
terminalsession.
SHOWALERTTAIL50
Thisdisplaysthelast50entriesinthealertloginyourterminalsession.
SHOWALERTTAILF
Thisdisplaysthelast10entriesinthealertlog,andthenwaitsformore
messagestoarriveinthealertlog.Aseachmessagearrives,itisappended
tothedisplay.Thiscommandenablesyoutoperform"livemonitoring"ofthe
alertlog.Press CTRLC tostopwaitingandreturntotheADRCIprompt.
SPOOL/home/steve/MYALERT.LOG
SHOWALERTTERM
SPOOLOFF
Thisoutputsthealertlog,withoutXMLtags,tothefile
/home/steve/MYALERT.LOG .
SHOWALERTP"MESSAGE_TEXTLIKE'%ORA600%'"
Thisdisplaysonlyalertlogmessagesthatcontainthestring'ORA600'.The
outputlookssomethinglikethis:
ADRHome=/u01/app/oracle/product/11.1.0/db_1/log/diag/rdbms/orcl
******************************************************************
01SEP0609.17.44.849000000PM07:00
AlertMsg1:ORA600dbgris01,addr=0xa9876541
SeeAlso:
"SHOWALERT"
"SETEDITOR"
(../../server.111/b28310/diag005.htm#ADMIN11267)forinstructionsfor
viewingthealertlogwithOracleEnterpriseManagerorwithatext
editor
()
FindingTraceFiles
()()ADRCIenablesyoutoviewthenamesoftracefilesthatarecurrentlyin
theautomaticdiagnosticrepository(ADR).Youcanviewthenamesofall
tracefilesintheADR,oryoucanapplyfilterstoviewasubsetofnames.For
example,ADRCIhascommandsthatenableyouto:
Obtainalistoftracefileswhosefilenamematchesasearchstring.
Obtainalistoftracefilesinaparticulardirectory.
Obtainalistoftracefilesthatpertaintoaparticularincident.
Youcancombinefilteringfunctionsbyusingthepropercommandline
parameters.
The SHOW TRACEFILE commanddisplaysalistofthetracefilesthatare
presentinthetracedirectoryandinallincidentdirectoriesunderthecurrent
ADRhome.WhenmultipleADRhomesarecurrent,thetracesfilelistsfrom
allADRhomesareoutputoneafteranother.
ThefollowingstatementliststhenamesofalltracefilesinthecurrentADR
homes,withoutanyfiltering:
SHOWTRACEFILE
Thefollowingstatementliststhenameofeverytracefilethathasthestring
'mmon'initsfilename.Thepercentsign(%)isusedasawildcardcharacter,
andthesearchstringiscasesensitive.
SHOWTRACEFILE%mmon%
Thisstatementliststhenameofeverytracefilethatislocatedinthe
/home/steve/temp directoryandthathasthestring'mmon'initsfilename:
SHOWTRACEFILE%mmon%PATH/home/steve/temp
Thisstatementliststhenamesoftracefilesinreverseorderoflastmodified
time.Thatis,themostrecentlymodifiedtracefilesarelistedfirst.
SHOWTRACEFILERT
Thisstatementliststhenamesofalltracefilesrelatedtoincidentnumber
1681:
SHOWTRACEFILEI1681
SeeAlso:
"SHOWTRACEFILE"
(../../server.111/b28310/diag001.htm#ADMIN11008)forinformationabout
thedirectorystructureoftheADR
()
ViewingIncidents
TheADRCI SHOW INCIDENT commanddisplaysinformationaboutopen
incidents.Foreachincident,theincidentID,problemkey,andincident
creationtimeareshown.IftheADRCIhomepathissetsothatthereare
multiplecurrentADRhomes,thereportincludesincidentsfromallofthem.
Toviewareportofallopenincidents:
1. StartADRCIininteractivemode,andensurethatthehomepathpointsto
thecorrectdirectorywithintheADRbasedirectoryhierarchy.
See"StartingADRCIandGettingHelp"and"Homepath"fordetails.
SHOWINCIDENT
ADRCIgeneratesoutputsimilartothefollowing:
ADRHome=/u01/app/oracle/product/11.1.0/db_1/log/diag/rdbms/orcl
******************************************************************
INCIDENT_IDPROBLEM_KEYCREATE_TIME
3808ORA6032007061821:35:49.32
3807ORA600[4137]2007061821:35:47.86
3805ORA600[4136]2007061821:35:25.01
3804ORA15782007061821:35:08.48
4rowsfetched
Thefollowingarevariationsonthe SHOW INCIDENT command:

SHOWINCIDENTMODEBRIEF
SHOWINCIDENTMODEDETAIL
Thesecommandsproducemoredetailedversionsoftheincidentreport.
SHOWINCIDENTMODEDETAILP"INCIDENT_ID=1681"
Thisshowsadetailedincidentreportforincident1681only.
SeeAlso:
"ADRCICommandReference"
()
PackagingIncidents
()YoucanuseADRCIcommandstopackageoneormoreincidentsfor
transmissiontoOracleSupportforanalysis.Backgroundinformationand
instructionsarepresentedinthefollowingtopics:
AboutPackagingIncidents
CreatingIncidentPackages
()
AboutPackagingIncidents
Packagingincidentsisathreestepprocess:
()Step1Createalogicalincidentpackage.
Theincidentpackage(package)isdenotedaslogicalbecauseitexistsonly
asmetadataintheautomaticdiagnosticrepository(ADR).Ithasnocontent
untilyougenerateaphysicalpackagefromthelogicalpackage.Thelogical
packageisassignedapackagenumber,andyourefertoitbythatnumberin
subsequentcommands.
Youcancreatethelogicalpackageasanemptypackage,orasapackage
basedonanincidentnumber,aproblemnumber,aproblemkey,oratime
interval.Ifyoucreatethepackageasanemptypackage,youcanadd
diagnosticinformationtoitinstep2.
Creatingapackagebasedonanincidentmeansincludingdiagnosticdata
dumps,healthmonitorreports,andsoonforthatincident.Creatinga
packagebasedonaproblemnumberorproblemkeymeansincludinginthe
packagediagnosticdataforincidentsthatreferencethatproblemnumberor
problemkey.Creatingapackagebasedonatimeintervalmeansincluding
diagnosticdataonincidentsthatoccurredinthetimeinterval.
()Step2Adddiagnosticinformationtotheincidentpackage
Ifyoucreatedalogicalpackagebasedonanincidentnumber,aproblem
number,aproblemkey,oratimeinterval,thisstepisoptional.Youcanadd
additionalincidentstothepackageoryoucanaddanyfilewithintheADRto
thepackage.Ifyoucreatedanemptypackage,youmustuseADRCI
commandstoaddincidentsorfilestothepackage.
()Step3Generatethephysicalincidentpackage
Whenyousubmitthecommandtogeneratethephysicalpackage,ADRCI
gathersallrequireddiagnosticfilesandaddsthemtoazipfileina
designateddirectory.Youcangenerateacompletezipfileoranincremental
zipfile.Anincrementalfilecontainsallthediagnosticfilesthatwereaddedor
changedsincethelastzipfilewascreatedforthesamelogicalpackage.You
cancreateincrementalfilesonlyafteryoucreateacompletefile,andyou
cancreateasmanyincrementalfilesasyouwant.Eachzipfileisassigneda
sequencenumbersothatthefilescanbeanalyzedinthecorrectorder.
Zipfilesarenamedaccordingtothefollowingscheme:
packageName_mode_sequence.zip
where:
packageName consistsofaportionoftheproblemkeyfollowedbya
timestamp
mode iseither'COM'or'INC',forcompleteorincremental
sequence isaninteger
Forexample,ifyougenerateacompletezipfileforalogicalpackagethat
wascreatedonSeptember6,2006at4:53p.m.,andthengeneratean
incrementalzipfileforthesamelogicalpackage,youwouldcreatefileswith
namessimilartothefollowing:
ORA603_20060906165316_COM_1.zip
ORA603_20060906165316_INC_2.zip
()
CreatingIncidentPackages
()()ThefollowingsectionspresenttheADRCIcommandsthatyouuseto
createalogicalincidentpackage(package)andgenerateaphysical
package:
CreatingaLogicalIncidentPackage
AddingDiagnosticInformationtoaLogicalIncidentPackage
GeneratingaPhysicalIncidentPackage
SeeAlso:
"AboutPackagingIncidents"
()
CreatingaLogicalIncidentPackage
Youusevariantsofthe IPS CREATE PACKAGE commandtocreatealogical
package(package).
Tocreateapackagebasedonanincident:
IPSCREATEPACKAGEINCIDENTincident_number
Forexample,thefollowingcommandcreatesapackagebasedonincident
3:
IPSCREATEPACKAGEINCIDENT3
ADRCIgeneratesoutputsimilartothefollowing:
Createdpackage10basedonincidentid3,correlationleveltyp
Thepackagenumberassignedtothislogicalpackageis10.
Thefollowingarevariationsonthe IPS CREATE PACKAGE command:

IPSCREATEPACKAGE
Thiscreatesanemptypackage.Youmustusethe IPS ADD INCIDENT or

IPS ADD FILE commandstoadddiagnosticdatatothepackagebefore
generatingit.
IPSCREATEPACKAGEPROBLEMproblem_ID
Thiscreatesapackageandincludesdiagnosticinformationforincidentsthat
referencethespecifiedproblemID.(ProblemIDsareintegers.)Youcan
obtaintheproblemIDforanincidentfromthereportdisplayedbythe SHOW
INCIDENT MODE BRIEF command.Becausetherecanbemanyincidents
withthesameproblemID,ADRCIaddstothepackagethediagnostic
informationforthefirstthreeincidents("earlyincidents")thatoccurredand
lastthreeincidents("lateincidents")thatoccurredwiththisproblemID,
excludinganyincidentsthatareolderthan90days.
Note:
Thenumberofearlyandlateincidents,andthe90dayagelimit
aredefaultsthatcanbechanged.See"IPSSET
CONFIGURATION".
ADRCImayalsoaddotherincidentsthatcorrelatecloselyintimeorinother
criteriawiththealreadyaddedincidents.
IPSCREATEPACKAGEPROBLEMKEY"problem_key"
Thiscreatesapackageandincludesdiagnosticinformationforincidentsthat
referencethespecifiedproblemkey.Youcanobtainproblemkeysfromthe
reportdisplayedbythe SHOW INCIDENT command.Becausetherecanbe
manyincidentswiththesameproblemkey,ADRCIaddstothepackageonly
thediagnosticinformationforthefirstthreeearlyincidentsandlastthreelate
incidentswiththisproblemkey,excludingincidentsthatareolderthan90
days.
Note:
Thenumberofearlyandlateincidents,andthe90dayagelimit
aredefaultsthatcanbechanged.See"IPSSET
CONFIGURATION".
ADRCImayalsoaddotherincidentsthatcorrelatecloselyintimeorinother
criteriawiththealreadyaddedincidents.
Theproblemkeymustbeenclosedinsinglequotes(')ordoublequotes(")if
itcontainsspacesorquotes.
IPSCREATEPACKAGESECONDSsec
Thiscreatesapackageandincludesdiagnosticinformationforallincidents
thatoccurredfrom sec secondsagountilnow. sec mustbeaninteger.
IPSCREATEPACKAGETIME'start_time'TO'end_time'
Thiscreatesapackageandincludesdiagnosticinformationforallincidents
thatoccurredwithinthespecifiedtimerange. start_time and end_time
mustbeintheformat' YYYYMMDDHH24:MI:SS.FFTZR '.Thisisavalid
formatstringforthe NLS_TIMESTAMP_TZ_FORMAT initializationparameter.
Thefraction( FF )portionofthetimeisoptional,andthe HH24:MI:SS
delimiterscanbecolonsorperiods.
Forexample,thefollowingcommandcreatesapackagewithincidentsthat
occurredbetweenJuly24thandJuly30thof2007:
IPSCREATEPACKAGETIME'2007072400:00:0007:00'to'2007073
SeeAlso:
"IPSCREATEPACKAGE"
()
AddingDiagnosticInformationtoaLogicalIncident
Package
Youcanaddthefollowingdiagnosticinformationtoanexistinglogical
package(package):
Alldiagnosticinformationforaparticularincident
AnamedfilewithintheADR
Toaddanincidenttoanexistingpackage:
IPSADDINCIDENTincident_numberPACKAGEpackage_number
ToaddafileintheADRtoanexistingpackage:
AttheADRCIprompt,enterthefollowingcommand:
IPSADDFILEfilespecPACKAGEpackage_number
filespec mustbeafullyqualifiedfilename(withpath).Onlyfilesthatare
withintheADRbasedirectoryhierarchymaybeadded.
SeeAlso:
()
GeneratingaPhysicalIncidentPackage
Whenyougenerateapackage,youcreateaphysicalpackage(azipfile)for
anexistinglogicalpackage.
Togenerateaphysicalincidentpackage:
IPSGENERATEPACKAGEpackage_numberINpath
Thisgeneratesacompletephysicalpackage(zipfile)inthedesignated
path.Forexample,thefollowingcommandcreatesacompletephysical
packageinthedirectory/home/steve/diagnosticsfromlogicalpackage
number2:
IPSGENERATEPACKAGE2IN/home/steve/diagnostics
Youcanalsogenerateanincrementalpackagecontainingonlytheincidents
thathaveoccurredsincethelastpackagegeneration.
Togenerateanincrementalphysicalincidentpackage:
AttheADRCIprompt,enterthefollowingcommand:
IPSGENERATEPACKAGEpackage_numberINpathINCREMENTAL
SeeAlso:
"AboutPackagingIncidents"
()
ADRCICommandReference
TherearefourcommandtypesinADRCI:
CommandsthatworkwithoneormorecurrentADRhomes
CommandsthatworkwithonlyonecurrentADRhome,andthatissuean
errormessageifthereismorethanonecurrentADRhome
CommandsthatpromptyoutoselectanADRhomewhenthereare
multiplecurrentADRhomes
CommandsthatdonotneedacurrentADRhome
AllADRCIcommandssupportthecasewherethereisasinglecurrentADR
home.
Table152liststhesetofADRCIcommands.
()()Table152ListofADRCIcommands
Command
Description
CREATEREPORT
Createsareportfor
thespecifiedreport
typeandID.
ECHO
Echoestheinput
string.
EXIT
Exitsthecurrent
ADRCIsession.
HOST
Executesoperating
systemcommands
fromADRCI.
IPS
InvokestheIPSutility.
SeeTable153forthe
IPScommands
availablewithin
ADRCI.
QUIT
Exitsthecurrent
ADRCIsession.
RUN
RunsanADRCI
script.
SETBASE
SetstheADRbase
forthecurrentADRCI
session.
SETBROWSER
Reservedforfuture
use.
SETCONTROL
Setpurgingpolicies
forADRcontents.
SETECHO
Togglescommand
output.
SETEDITOR
Setsthedefaulteditor
fordisplayingtrace
andalertlogcontents.
SETHOMEPATH
Makescurrentoneor
moreADRhomes.
SETTERMOUT
Togglesterminal
output.
SHOWALERT
Showsalertlog
messages.
SHOWBASE
Showsthecurrent
ADRbase.
SHOWCONTROL
ShowsADR
information,including
thecurrentpurging
policy.
SHOWHM_RUN
ShowsHealthMonitor
runinformation.
SHOWHOMEPATH
Showsthecurrent
homepath.
SHOWHOMES
ListsthecurrentADR
homes.
SHOWINCDIR
Liststhetracefiles
createdforthe
specifiedincidents.
SHOWINCIDENT
Outputsalistof
incidents.
SHOWPROBLEM
Outputsalistof
problems.
SHOWREPORT
Showsareportforthe
specifiedreporttype
andID.
SHOWTRACEFILE
Listsqualifiedtrace
filenames.
SPOOL
Directsoutputtoa
file.
Note:
Unlessotherwisespecified,thecommandslistedbelowworkwith
multiplecurrentADRhomes.
()
CREATEREPORT
()Purpose
CreatesareportforthespecifiedreporttypeandrunIDandstoresthereport
intheADR.Currently,onlythe hm_run (HealthMonitor)reporttypeis
supported.
Note:
ResultsofHealthMonitorrunsarestoredintheADRinaninternal
format.Toviewtheseresults,youmustcreateaHealthMonitor
reportfromthemandthenviewthereport.Youneedcreatethe
reportonlyonce.Youcanthenviewitmultipletimes.
()SyntaxandDescription
createreport report_type run_name

report_type mustbe hm_run . run_name isaHealthMonitorrunname.
ObtainrunnameswiththeSHOWHM_RUNcommand.
Ifthereportalreadyexistsitisoverwritten.UsetheSHOWREPORT
commandtoviewthereport.
()Example
ThisexamplecreatesareportfortheHealthMonitorrunwithrunname
hm_run_1421 :
createreporthm_runhm_run_1421
Note:
CREATE REPORT doesnotworkwhenmultipleADRhomesare
set.ForinformationonsettingasingleADRhome,see"Setting
theADRCIHomepathBeforeUsingADRCICommands"
()
ECHO
()Purpose
Printstheinputstring.Youcanusethiscommandtoprintcustomtextfrom
ADRCIscripts.
echo quoted_string
Thestringmustbeenclosedinsingleordoublequotes.
ThiscommanddoesnotrequireanADRhometobesetbeforeyoucanuse
it.
()Example
Theseexamplesprintthestring"Hello,world!":
echo"Hello,world!"
echo'Hello,world!'
()
EXIT
()Purpose
ExitstheADRCIutility.
exit
EXIT isasynonymforthe QUIT command.
it.
()
HOST
()Purpose
ExecuteoperatingsystemcommandswithoutleavingADRCI.
host[" host_command_string "]
Use host byitselftoenteranoperatingsystemshell,whichallowsyouto

entermultipleoperatingsystemcommands.Enter EXIT toleavetheshell
andreturntoADRCI.
Youcanalsospecifythecommandonthesameline
( host_command_string )enclosedindoublequotes.
it.
()Examples
host
host"lsl*.pl"
()
IPS
()Purpose
InvokestheIncidentPackagingService(IPS)commandset.TheIPS
commandprovidesoptionsforcreatinglogicalincidentpackages(packages),
addingdiagnosticdatatopackages,andgeneratingphysicalpackagesfor
transmissiontoOracleSupport.
SeeAlso:
"PackagingIncidents"formoreinformationonpackaging.
TheIPScommandsetcontainsthefollowingcommands:
()()Table153IPSCommandSet
Command
Description
IPSADD
Addsanincident,
problem,orproblem
keytoapackage.
IPSADDFILE
Addsafiletoa
package.
IPSADDNEWINCIDENTS
Findsandaddsnew
incidentsforthe
problemsinthe
specifiedpackage.
IPSCOPYINFILE
Copiesfilesintothe
ADRfromthe
externalfilesystem.
IPSCOPYOUTFILE
Copiesfilesoutofthe
ADRtotheexternal
filesystem.
IPSCREATEPACKAGE
Createsanew
(logical)package.
IPSDELETEPACKAGE
Deletesapackage
anditscontentsfrom
theADR.
IPSFINALIZE
Finalizesapackage
beforeuploading.
IPSGENERATEPACKAGE
GeneratesaZIPfile
ofthespecified
packagecontentsin
thetargetdirectory.
IPSGETMANIFEST
Retrievesand
displaysthemanifest
fromapackageZIP
file.
IPSGETMETADATA
Extractsmetadata
fromapackageZIP
fileanddisplaysit.
IPSPACK
Createsaphysical
package(ZIPfile)
directlyfrom
incidents,problems,
orproblemkeys.
IPSREMOVE
Removesincidents
fromanexisting
package.
IPSREMOVEFILE
Removeafilefroman
existingpackage.
IPSSETCONFIGURATION
Changesthevalueof
anIPSconfiguration
parameter.
IPSSHOWCONFIGURATION
Displaysthevaluesof
IPSconfiguration
parameters.
IPSSHOWFILES
Liststhefilesina
package.
IPSSHOWINCIDENTS
Liststheincidentsina
package.
IPSUNPACKFILE
Unpackagesa
packageZIPfileinto
aspecifiedpath.
Note:
IPScommandsdonotworkwhenmultipleADRhomesareset.For
informationonsettingasingleADRhome,see"SettingtheADRCI
HomepathBeforeUsingADRCICommands"
()
Usingthe<ADR_HOME>and<ADR_BASE>Variablesin
IPSCommands
TheIPScommandsetprovidesshortcutsforreferencingthecurrentADR
homeandADRbasedirectories.ToaccessthecurrentADRhomedirectory,
usethe <ADR_HOME> variableasfollows:
ipsaddfile<ADR_HOME>/trace/orcl_ora_13579.trcpackage12
Usethe <ADR_BASE> variabletoaccesstheADRbasedirectoryasfollows:
ipsaddfile<ADR_BASE>/diag/rdbms/orcl/orcl/trace/orcl_ora_13579.
()
IPSADD
()Purpose
Addsincidentstoapackage.
ipsadd {incident inc_id |problem prob_id |problemkey

pr_key |seconds secs | time start_time to end_time }
package pkg_id
Table154describestheargumentsofIPSADD.
()()Table154ArgumentsofIPSADDcommand
Argument
Description
incident inc_id
AddsanincidentwithID inc_id to
thepackage
problem prob_id
AddsincidentswithproblemID
prob_id tothepackage.Addsonly
thefirstthreeearlyincidentsandlast
threelateincidentsfortheproblem,
excludinganyolderthan90days.
(Note:Theselimitsaredefaultsand
canbechanged.See"IPSSET
CONFIGURATION".)
problemkey pr_key
Addsincidentswithproblemkey
pr_key tothepackage.Addsonly
threelateincidentsfortheproblem
key,excludinganyolderthan90
days.(Note:Theselimitsaredefaults
andcanbechanged.)
seconds secs
Addsallincidentsthathaveoccurred
within secs secondsofthepresent
time
time start_time to
end_time
Addsallincidentsbetween
start_time and end_time tothe
package.Timeformatis
' YYYYMMYYHH24:MI:SS.FFTZR '.
Fractionalpart( FF )isoptional.
package pkg_id
()Example
Specifiesthepackagetowhichto
addincidents.
Thisexampleaddsincident22topackage12:
ipsaddincident22package12
Thisexampleaddsthefirstthreeearlyincidentsandthelastthreelate
incidentswithproblemID6topackage2,exudinganyincidentsolderthan
90days:
ipsaddproblem6package2
Thisexampleaddsallincidentstakingplaceduringthelastminuteto
package5:
ipsaddseconds60package5
Thisexampleaddsallincidentstakingplacebetween10:00a.m.and11:00
p.m.onMay1,2007:
ipsaddtime'2007050110:00:00.0007:00'to'2007050123:00
()
IPSADDFILE
()Purpose
Addsafiletoanexistingpackage.
ips add file file_name package pkg_id

file_name isthefullpathnameofthefile.Youcanusethe <ADR_HOME>
and <ADR_BASE> variablesifdesired.ThefilemustbeunderthesameADR

baseasthepackage.
pkg_id isthepackageID.
()Example
Thisexampleaddsatracefiletopackage12:
ipsaddfile<ADR_HOME>/trace/orcl_ora_13579.trcpackage12
SeeAlso:
See"Usingthe<ADR_HOME>and<ADR_BASE>VariablesinIPS
Commands"forinformationonthe <ADR_HOME> directorysyntax
()
IPSADDNEWINCIDENTS
()Purpose
Findandaddnewincidentsforalloftheproblemsinthespecifiedpackage.
ips add new incidentspackage package_id

package_id isthepackagetoupdate.Onlynewincidentsoftheproblemsin
thepackageareadded.
()Example
Thisexampleaddsuptothreeofthenewlateincidentsfortheproblemsin
package12:
ipsaddnewincidentspackage12
Note:
Thenumberoflateincidentsaddedisadefaultthatcanbe
changed.See"IPSSETCONFIGURATION"
()
IPSCOPYINFILE
()Purpose
CopiesafileintotheADRfromtheexternalfilesystem.
Toeditafileinapackage,youmustcopythefileouttoadesignated
directory,editthefile,andcopyitbackintothepackage.Youmaywanttodo
thistodeletesensitivedatainthefilebeforesendingthepackagetoOracle
Support.
ips copy in file filename [to new_name ][overwrite] package

pkgid [incident incid ]
Copiesanexternalfile, filename (specifiedwithfullpathname)intothe

ADR,associatingitwithanexistingpackage, pkgid ,andoptionallyan
incident, incid .Usethe to new_name optiontogivethecopiedfileanew
filenamewithintheADR.Usethe overwrite optiontooverwriteafilethat
existsalready.
()Example
ThisexamplecopiesatracefilefromthefilesystemintotheADR,
associatingitwithpackage2andincident4:
ipscopyinfile/home/nick/trace/orcl_ora_13579.trcto<ADR_HOME>
SeeAlso:
"Usingthe<ADR_HOME>and<ADR_BASE>VariablesinIPS
Commands"forinformationonthe <ADR_HOME> variable
"IPSSHOWFILES"forinformationonlistingfilesinapackage
()
IPSCOPYOUTFILE
()Purpose
CopiesafilefromtheADRtotheexternalfilesystem.
Toeditafileinapackage,youmustcopythefileouttoadesignated
directory,editthefile,andcopyitbackintothepackage.Youmaywanttodo
thistodeletesensitivedatainthefilebeforesendingthepackagetoOracle
Support.
ips copy out file source to target [overwrite]
Copiesafile, source ,toalocationoutsidetheADR, target (specifiedwith

fullpathname).Usethe overwrite optiontooverwritethefilethatexists
already.
()Example
ThisexamplecopiesafileintheADRhomecalled /trace/ora_26201 toa

localfolder.
ipscopyoutfile<ADR_HOME>/trace/orcl_ora_13579.trcto/home/nic
SeeAlso:
Commands"forinformationonthe <ADR_HOME> directorysyntax
"IPSSHOWFILES"forinformationonlistingfilesinapackage
()
IPSCREATEPACKAGE
()Purpose
Createsanewpackage.ADRCIautomaticallyassignsthepackagenumber
forthenewpackage.
ips create package {incident inc_id | problem prob_id |

problemkey prob_key | seconds secs | time start_time to
end_time }[correlate basic | typical | all ]
Optionally,youcanaddincidentstothenewpackageusingtheprovided
options.
Table155describestheargumentsfor IPS CREATE PACKAGE .
()()Table155ArgumentsofIPSCREATEcommand
Argument
Description
incident inc_id
AddsanincidentwithID inc_id to
thepackage
problem prob_id
AddsallincidentswithproblemID
CONFIGURATION".)
problemkey pr_key
Addsallincidentswithproblemkey
andcanbechanged.)
seconds secs
time
time start_time to
end_time
Addsallincidentstakingplace
between start_time and
end_time tothepackage.Time
formatis
correlate[ basic
| typical | all ]
Selectsamethodofincluding
correlatedincidentsinthepackage.
Therearethreeoptionsforthis
argument:
correlate basic includes
incidentdumpsandincident
processtracefiles.
correlate typical includes
incidentdumpsandanytracefiles
thatweremodifiedwithinfive
minutesofeachincident.Youcan
alterthetimeintervalbymodifying
the INCIDENT_TIME_WINDOW
configurationparameter.
correlate all includesthe
incidentdumps,andalltracefiles
thatweremodifiedbetweenthe
timeofthefirstselectedincident
andthelastselectedincident.
Thedefaultvalueis correlate
typical .
package pkg_id
Addsincidentstothepackagewith
ID pkg_id .
()Examples
Thisexamplecreatesapackagewithnoincidents:
ipscreatepackage
Output:
Createdpackage5withoutanycontents,correlationleveltypical
Thisexamplecreatesapackagecontainingallincidentsbetween10AMand
11PMonthegivenday:
ipscreatepackagetime'2007050110:00:00.0007:00'to'20070
Output:
Createdpackage6basedontimerange2007050110:00:00.0007:0
Thisexamplecreatesapackageandaddsthefirstthreeearlyincidentsand
thelastthreelateincidentswithproblemID3,excludingincidentsthatare
olderthan90days:
ipscreatepackageproblem3
Output:
Createdpackage7basedonproblemid3,correlationleveltypical
Note:
Thenumberofearlyandlateincidentsadded,andthe90dayage
limitaredefaultsthatcanbechanged.See"IPSSET
CONFIGURATION".
SeeAlso:
"CreatingIncidentPackages"
()
IPSDELETEPACKAGE
()Purpose
DropsapackageanditscontentsfromtheADR.
ips delete package pkg_id

pkg_id isthepackagetodelete.
()Example
ipsdeletepackage12
()
IPSFINALIZE
()Purpose
Finalizesapackagebeforeuploading.
ips finalize package pkg_id

pkg_id isthepackageIDtofinalize.
()Example
ipsfinalizepackage12
SeeAlso:
finalizingpackages
()
IPSGENERATEPACKAGE
()Purpose
Createsaphysicalpackage(aZIPfile)intargetdirectory.
ips generate package package_id [in path ] [complete |

incremental]
package_id istheIDofthepackagetogenerate.Optionally,youcansave
thefileinthedirectory path .Otherwise,thepackageisgeneratedinthe

currentworkingdirectory.
The complete optionmeansthepackageforcesADRCItoincludeall
packagefiles.Thisisthedefaultbehavior.
The incremental optionincludesonlyfilesthathavebeenaddedor
changedsincethelasttimethatthispackagewasgenerated.Withthe
incremental option,thecommandfinishesmorequickly.
()Example
Thisexamplegeneratesaphysicalpackagefileinpath /home/steve :
ipsgeneratepackage12in/home/steve
Thisexamplegeneratesaphysicalpackagefromfilesaddedorchanged
sincethelastgeneration:
ipsgeneratepackage14incremental
SeeAlso:
"GeneratingaPhysicalIncidentPackage"
()
IPSGETMANIFEST
()Purpose
ExtractsthemanifestfromapackageZIPfileanddisplaysit.
ips get manifest from file filename

filename isapackageZIPfile.ThemanifestisanXMLformattedsetof
metadataforthepackagefile,includinginformationonADRconfiguration,
correlatedfiles,incidents,andhowthepackagewasgenerated.
it.
()Example
ipsgetmanifestfromfile/home/steve/ORA603_20060906165316_COM_1
()
IPSGETMETADATA
()Purpose
ExtractsADRrelatedmetadatafromapackagefileanddisplaysit.
ips get metadata {from file filename | from adr }

filename isapackageZIPfile.Themetadatainapackagefile(storedin
thefile metadata.xml )containsinformationabouttheADRhome,ADR

base,andproduct.
Usethe from adr optiontogetthemetadatafromapackageZIPfilethat
hasbeenunpackedintoanADRhomeusing IPS UNPACK .
The from adr optionrequiresanADRhometobeset.
()Example
Thisexampledisplaysmetadatafromapackagefile:
ipsgetmetadatafromfile/home/steve/ORA603_20060906165316_COM_1
Thisnextexampledisplaysmetadatafromapackagefilethatwasunpacked
intothedirectory/scratch/oracle/package1:
setbase/scratch/oracle/package1
ipsgetmetadatafromadr
Inthispreviousexample,uponreceivingthe SET BASE command,ADRCI

automaticallyaddstothehomepaththeADRhomethatwascreatedin
/scratch/oracle/package1bythe IPS UNPACK FILE command.
SeeAlso:
"IPSUNPACKFILE"formoreinformationonunpackingpackage
files
()
IPSPACK
()Purpose
Createsapackageandgeneratesthephysicalpackageimmediately.
ips pack [incident inc_id | problem prob_id | problemkey

prob_key | seconds secs | time start_time to
end_time ][correlate {basic | typical | all} ] [in
path ]
ADRCIautomaticallygeneratesthepackagenumberforthenewpackage.
IPSPACKcreatesanemptypackageifnopackagecontentsarespecified.
Table156describestheargumentsfor IPS PACK .
()()Table156ArgumentsofIPSPACKcommand
Argument
Description
incident inc_id
AddsincidentwithID inc_id tothe

package
problem prob_id
AddsincidentswithproblemID
CONFIGURATION".)
problemkey pr_key
Addsincidentswithproblemkey
andcanbechanged.)
seconds secs
time
TableofContents
(toc.htm) OracleDatabase (toc.htm)
Preface(preface.htm)
time start_time to
end_time
What'sNewinDatabaseUtilities?
(whatsnew.htm#SUTIL000)
OverviewofOracleDataPump
(dp_overview.htm#g1015896)
DataPumpExport(dp_export.htm#g1022624)
Addsallincidentstakingplace
between start_time and
end_time tothepackage.Time
formatis
DataPumpImport(dp_import.htm#g1025464)
DataPumpPerformance(dp_perf.htm#g1008057)
correlate[ basic
TheDataPumpAPI(dp_api.htm#g1011860)
| typical | all ]
SQL*LoaderConcepts(ldr_concepts.htm#g1013706)
SQL*LoaderCommandLineReference
(ldr_params.htm#g1014550)
Selectsamethodofincluding
correlatedincidentsinthepackage.
Therearethreeoptionsforthis
argument:
SQL*LoaderControlFileReference
(ldr_control_file.htm#i1006645)
SQL*LoaderFieldListReference
(ldr_field_list.htm#g1044967)
LoadingObjects,LOBs,andCollections
(ldr_loading.htm#g1026656)
ConventionalandDirectPathLoads
(ldr_modes.htm#g1023818)
ExternalTablesConcepts(et_concepts.htm#g1017623)
TheORACLE_LOADERAccessDriver
(et_params.htm#g1031955)
TheORACLE_DATAPUMPAccessDriver
correlate basic includes
incidentdumpsandincident
processtracefiles.
correlate typical includes
incidentdumpsandanytracefiles
thatweremodifiedwithinfive
minutesofeachincident.Youcan
alterthetimeintervalbymodifying
the INCIDENT_TIME_WINDOW
configurationparameter.
(et_dp_driver.htm#g1017944)
ADRCI:ADRCommandInterpreter
correlate all includesthe
(adrci.htm#BABBHGFC)
DBVERIFY:OfflineDatabaseVerificationUtility
(dbverify.htm#g1010035)
DBNEWIDUtility(dbnewid.htm#g1010179)
UsingLogMinertoAnalyzeRedoLogFiles
incidentdumps,andalltracefiles
thatweremodifiedbetweenthe
timeofthefirstselectedincident
andthelastselectedincident.
(logminer.htm#i1005553)
UsingtheMetadataAPI(metadata_api.htm#i1007135)
OriginalExportandImport(exp_imp.htm#g1070082)
EnterpriseManagerConfigurationAssistant
(EMCA)(emca.htm#CIABECII)
SQL*LoaderSyntaxDiagrams
(app_ldr_syntax.htm#g632912)
[in path ]
Thedefaultvalueis correlate
typical .
Savesthephysicalpackageto
directory path .
Download
Categories
Home(../../index.htm)
BookList(../../nav/portal_booklist.htm)
DataDictionary(../../nav/catalog_views.htm)
SQLKeywords(../../nav/sql_keywords.htm)
()Example
Acronyms(../../nav/acronym_list.htm)
Thisexamplecreatesanemptypackage:
ipspack
Thisexamplecreatesaphysicalpackagecontainingallinformationfor
incident861:
ipspackincident861
Thisexamplecreatesaphysicalpackageforallincidentsinthelastminute,
fullycorrelated:
ipspackseconds60correlateall
SeeAlso:
"IPSSETCONFIGURATION"formoreinformationonsetting
configurationparameters.
()
IPSREMOVE
()Purpose
Removesincidentsfromanexistingpackage.
ips remove {incident inc_id | problem prob_id | problemkey

prob_key } package pkg_id
Afterremovingincidentsfromapackage,theincidentscontinuetobetracked
withinthepackagemetadatatopreventADRCIfromautomaticallyincluding
themlater(suchaswithADDNEWINCIDENTS).
Table157describestheargumentsofIPSREMOVE.
()()Table157ArgumentsofIPSREMOVEcommand
Argument
Description
incident inc_id
Removestheincident
withID inc_id from
thepackage
problem prob_id
Removesallincidents
withproblemID
prob_id fromthe
package
problemkey pr_key
Removesallincidents
withproblemkey
pr_key fromthe
package
package pkg_id
Removesincidents
fromthepackagewith
ID pkg_id .
()Example
Thisexampleremovesincident22frompackage12:
ipsremoveincident22package12
SeeAlso:
"IPSGETMANIFEST"forinformationonpackagemetadata.
()
IPSREMOVEFILE
()Purpose
Removesafilefromanexistingpackage.
ips remove file file_name package pkg_id
file_name isthefiletoremovefrompackage pkg_id .Thecompletepath
ofthefilemustbespecified.(Youcanusethe <ADR_HOME> and

<ADR_BASE> variablesifdesired.)
Afterremoval,thefilecontinuestobetrackedwithinthepackagemetadatato
preventADRCIfromautomaticallyincludingitlater(suchaswith ADD NEW
INCIDENTS ).Removingafile,therefore,onlysetsthe EXCLUDE flagforthe
fileto1.
()Example
Thisexampleremovesatracefilefrompackage12:
ipsremovefile<ADR_HOME>/trace/orcl_ora_13579.trcpackage12
Removedfile<ADR_HOME>/trace/orcl_ora_13579.trcfrompackage12
ipsshowfilespackage12
.
.
.
**********************************************************
FILERECORD
**********************************************************
FILEINFORMATION:
FILE_LOCATION<ADR_HOME>/trace
FILE_NAMEorcl_ora_13579.trc
LAST_SEQUENCE0
EXCLUDE1
.
.
.
SeeAlso:
"IPSGETMANIFEST"forinformationonpackagemetadata.
Commands"forinformationonthe <ADR_BASE> directorysyntax
"IPSSHOWFILES"
()
IPSSETCONFIGURATION
()Purpose
ChangesthevalueofanIPSconfigurationparameter.
ips set configuration parameter_id value

parameter_id istheparameterIDtochange,and value isthenewvalue.
ForalistoftheconfigurationparametersandtheirIDs,use"IPSSHOW
CONFIGURATION".
()Example
ipssetconfiguration310
()
IPSSHOWCONFIGURATION
()Purpose
DisplaysalistofIPSconfigurationparametersandtheirvalues.These
parameterscontrolvariousthresholdsforIPSdata,suchastimeoutsand
incidentinclusionintervals.
ips show configuration [ parameter_id ]
IPSSHOWCONFIGURATIONliststhefollowinginformationforeach
configurationparameter:
ParameterID
Name
Description
Unitusedbyparameter(suchasdaysorhours)
Value
Defaultvalue
Optionally,youcangetinformationaboutaspecificparameterbysupplyinga
parameter_id .
()Example
ThiscommanddescribesallIPSconfigurationparameters:
ipsshowconfiguration
Output:
IPSCONFIGURATIONPARAMETER
**********************************************************
PARAMETERINFORMATION:
PARAMETER_ID1
NAMECUTOFF_TIME
DESCRIPTIONMaximumageforanincidenttobeconsideredf
UNITDays
VALUE90
DEFAULT_VALUE90
**********************************************************
**********************************************************
PARAMETER_ID2
NAMENUM_EARLY_INCIDENTS
DESCRIPTIONHowmanyincidentstogetintheearlyparto
UNITNumber
VALUE3
DEFAULT_VALUE3
**********************************************************
**********************************************************
PARAMETER_ID3
NAMENUM_LATE_INCIDENTS
DESCRIPTIONHowmanyincidentstogetinthelatepartof
UNITNumber
VALUE3
DEFAULT_VALUE3
**********************************************************
**********************************************************
PARAMETER_ID4
NAMEINCIDENT_TIME_WINDOW
DESCRIPTIONIncidentsthisclosetoeachotherareconsid
UNITMinutes
VALUE5
DEFAULT_VALUE5
**********************************************************
**********************************************************
PARAMETER_ID5
NAMEPACKAGE_TIME_WINDOW
DESCRIPTIONTimewindowforcontentinclusionisfromxho
UNITHours
VALUE24
DEFAULT_VALUE24
**********************************************************
**********************************************************
PARAMETER_ID6
NAMEDEFAULT_CORRELATION_LEVEL
DESCRIPTIONDefaultcorrelationlevelforpackages
UNITNumber
VALUE2
DEFAULT_VALUE2
()Example
Thiscommanddescribesconfigurationparameter3:
ipsshowconfiguration3
()ConfigurationParameterDescriptions
Table158describestheIPSconfigurationparametersindetail.
()()Table158IPSConfigurationParameters
Parameter
ID
Description
CUTOFF_TIME
Maximumage,indays,for
anincidenttobeconsidered
forinclusion
NUM_EARLY_INCIDENTS
Numberofincidentsto
includeintheearlypartof
therangewhencreatinga
packagebasedona
problem.Bydefault,ADRCI
addsthethreeearliest
incidentsandthreemost
recentincidentstothe
package.
NUM_LATE_INCIDENTS
Numberofincidentsto
includeinthelatepartofthe
rangewhencreatinga
packagebasedona
problem.Bydefault,ADRCI
addsthethreeearliest
incidentsandthreemost
recentincidentstothe
package.
INCIDENT_TIME_WINDOW
Numberofminutesbetween
twoincidentsinorderfor
themtobeconsidered
correlated.
PACKAGE_TIME_WINDOW
Numberofhourstouseas
atimewindowforincluding
incidentsinapackage.For
example,avalueof5
includesincidentsfivehours
beforetheearliestincident
inthepackage,andfive
hoursafterthemostrecent
incidentinthepackage.
DEFAULT_CORRELATION_LEVEL
Thedefaultcorrelationlevel
touseforcorrelating
incidentsinapackage.The
correlationlevelsare:
1("basic"correlation):
includesincidentdumps
andincidentprocess
tracefiles.
2("typical"correlation):
includesincidentdumps
andanytracefilesthat
weremodifiedwithinthe
timewindowspecifiedby
INCIDENT_TIME_WINDOW
(seeabove).
4("all"):includesthe
incidentdumps,andall
tracefilesthatwere
modifiedbetweenthefirst
selectedincidentandthe
lastselectedincident.
Additionalincidentscan
beincludedautomatically
iftheyoccurredinthe
sametimerange.
SeeAlso:
"IPSSETCONFIGURATION"
()
IPSSHOWFILES
()Purpose
Listsfilesincludedinthespecifiedpackage.
ips show files package pkg_id

pkg_id isthepackageIDtodisplay.
()Example
Thisexampleshowsallfilesassociatedwithpackage3:
ipsshowfilespackage3
Output:
**********************************************************
FILERECORD
**********************************************************
FILEINFORMATION:
FILE_LOCATION<ADR_HOME>/incident/incdir_4!/nick/oracle
FILE_NAMEorcl_ora_13579_i4_2.trc
LAST_SEQUENCE0
EXCLUDE0
**********************************************************
FILERECORD
**********************************************************
FILEINFORMATION:
FILE_NAMEorcl_ora_13579_i4.trc
LAST_SEQUENCE0
EXCLUDE0
**********************************************************
FILERECORD
**********************************************************
FILEINFORMATION:
FILE_NAMEorcl_ora_13579_i4_sql_2.trc
LAST_SEQUENCE0
EXCLUDE0
()
IPSSHOWINCIDENTS
()Purpose
Listsincidentsincludedinthespecifiedpackage.
ips show incidents package pkg_id

pkg_id isthepackageIDtodisplay.
()Example
Thisexampleliststheincidentsinpackage3:
ipsshowincidentspackage3
Output:
**********************************************************
MainINCIDENTS
**********************************************************
**********************************************************
INCIDENTRECORD
**********************************************************
INCIDENTINFORMATION:
INCIDENT_ID3827
PROBLEM_ID3
EXCLUDE0
**********************************************************
CorrelatedINCIDENTS
**********************************************************
**********************************************************
INCIDENTRECORD
**********************************************************
INCIDENT_ID3633
PROBLEM_ID2
EXCLUDE0
**********************************************************
INCIDENTRECORD
**********************************************************
INCIDENT_ID3634
PROBLEM_ID3
EXCLUDE0
()
IPSUNPACKFILE
()Purpose
Unpackagesaphysicalpackagefileintothespecifiedpath.
ips unpack file file_name [into path ]

file_name isthefullpathnameofthephysicalpackage(zipfile)tounpack.
Optionally,youcanunpackthefileintodirectory path ,whichmustexistand

bewritable.Ifyouomitthepath,thecurrentworkingdirectoryisused.The
destinationdirectoryistreatedasanADRbase,andtheentireADRbase
directoryhierarchyiscreated,includingavalidADRhome.
it.
()Example
ipsunpackfile/tmp/ORA603_20060906165316_COM_1.zipinto/tmp/new
()
PURGE
()Purpose
PurgesdiagnosticdatainthecurrentADRhome,accordingtocurrent
purgingpolicies.OnlyADRcontentsthatareduetobepurgedarepurged.
DiagnosticdataintheADRhasadefaultlifecycle.Forexample,information
aboutincidentsandproblemsissubjecttopurgingafteroneyear,whereas
theassociateddumpfiles(dumps)aresubjecttopurgingafteronly30days.
SomeOracleproducts,suchOracleDatabase,automaticallypurge
diagnosticdataattheendofitslifecycle.Otherproductsandcomponents
requireyoutopurgediagnosticdatamanuallywiththiscommand.Youcan
alsousethiscommandtopurgedatathatisduetobeautomaticallypurged.
TheSHOWCONTROLcommanddisplaysthedefaultpurgingpoliciesfor
shortlivedADRcontentsandlonglivedADRcontents.
purge [[i { id | start_id end_id }] | [age mins [type

{ALERT | INCIDENT | TRACE | CDUMP|HM }]] ]
Table159describestheflagsfor PURGE .
()()Table159FlagsforthePURGEcommand
Flag
Description
[[i { id1 | start_id end_id }]
Purgeseithera
specificincidentID
( id )orarangeof
incidentIDs
( start_id and
end_id )
[age mins ]
Purgesonlydata
olderthan mins
minutes.
[type
Specifiesthetypeof
diagnosticdatato
purge(alertlog
messages,incident
data,tracefiles
(includingdumps),
corefiles,orHealth
Monitorrundataand
reports).
{ALERT | INCIDENT | TRACE | CDUMP|HM }]
()Examples
ThisexamplepurgesalldiagnosticdatainthecurrentADRhomebasedon
thedefaultpurgingpolicies:
purge
Thisexamplepurgesalldiagnosticdataforallincidentsbetween123and
456:
purgei123456
Thisexamplepurgesallincidentdatafromthelasthour:
purgeage60typeincident
Note:
PURGE doesnotworkwhenmultipleADRhomesareset.For
informationonsettingasingleADRhome,see"SettingtheADRCI
HomepathBeforeUsingADRCICommands"
()
QUIT
See"EXIT"
()
RUN
()Purpose
RunsanADRCIscript.
run script_name
@ script_name
@@ script_name
script_name isthefilecontainingtheADRCIcommandstoexecute.ADRCI
looksforthescriptinthecurrentdirectoryunlessafullpathnameissupplied.
Ifthefilenameisgivenwithoutafileextension,ADRCIusesthedefault
extension".adi".
The run and @ commandsaresynonyms.The @@ commandissimilarto
runand @ exceptthatwhenusedinsideascript, @@ usesthepathofthe
callingscripttolocate script_name ,ratherthanthecurrentdirectory.
it.
()Example
runmy_script
@my_script
()
SETBASE
()Purpose
SetstheADRbasetouseinthecurrentADRCIsession.
setbase base_str
base_str isafullpathtoadirectory.Theformatfor base_str dependson
theoperatingsystem.IftherearevalidADRhomesunderthebasedirectory,
thesehomesareaddedtothehomepathofthecurrentADRCIsession.
it.
()Example
setbase/net/sttttd1/scratch/steve/view_storage/steve_v1/log
SeeAlso:
"ADRBase"
()
SETBROWSER
()Purpose
Setsthedefaultbrowserfordisplayingreports.
Note:
Thiscommandisreservedforfutureuse.AtthistimeADRCIdoes
notsupportHTMLformattedreportsinabrowser.
setbrowser browser_program
browser_program isthebrowserprogramname(itisassumedthebrowser
canbestartedfromthecurrentADRworkingdirectory).Ifnobrowserisset,
ADRCIwilldisplayreportstotheterminalorspoolfile.
it.
()Example
setbrowsermozilla
SeeAlso:
"SHOWREPORT"formoreinformationonshowingreports
"SPOOL"formoreinformationonspooling
()
SETCONTROL
()Purpose
SetspurgingpoliciesforADRcontents.
set control ( purge_policy = value , ... )

purge_policy iseither SHORTP_POLICY or LONGP_POLICY .See"SHOW
CONTROL"formoreinformation.
value isthenumberofhoursafterwhichtheADRcontentsbecomeeligible
forpurging.
ThiscommandworkswithasingleADRhomeonly.
()Example
setcontrol(SHORTP_POLICY=360)
()
SETECHO
()Purpose
Turnscommandoutputonoroff.Thiscommandonlyaffectsoutputbeing
displayedinascriptorusingthespoolmode.
set echo on|off
it.
()Example
setechooff
SeeAlso:
"SPOOL"formoreinformationonspooling
()
SETEDITOR
()Purpose
Setstheeditorfordisplayingthealertlogandthecontentsoftracefiles.
set editor editor_program

editor_program istheeditorprogramname.Ifnoeditorisset,ADRCIuses
theeditorspecifiedbytheoperatingsystemenvironmentvariable $EDITOR .
If $EDITOR isnotset,ADRCIuses vi asthedefaulteditor.
it.
()Example
seteditorxemacs
SeeAlso:
"SHOWREPORT"
()
SETHOMEPATH
()Purpose
MakesoneormoreADRhomescurrent.ManyADRcommandsworkwith
thecurrentADRhomesonly.
set homepath homepath_str1 homepath_str2 ...
The homepath_str n stringsarethepathsoftheADRhomesrelativetothe

currentADRbase.The"diag"inthedirectorynamecanbeomitted.Ifthe
specifiedpathcontainsmultipleADRhomes,allofthehomesareaddedto
thehomepath.
IfadesirednewADRhomeisnotwithinthecurrentADRbase,use SET
BASE tosetanewADRbaseandthenuse SET HOMEPATH .
it.
()Example
sethomepathdiag/rdbms/aime3/aime3diag/rdbms/aime3/aime32
SeeAlso:
"Homepath"
()
SETTERMOUT
()Purpose
Turnsoutputtotheterminalonoroff.
set termout on|off
Thissettingisindependentofspooling.Thatis,theoutputcanbedirectedto
bothterminalandafileatthesametime.
it.
SeeAlso:
"SPOOL"formoreinformationonspooling.
()Example
settermouton
()
SHOWALERT
()Purpose
Showsthecontentsofthealertloginthedefaulteditor.
showalert[p predicate_string ][tail[ num ][f]][term]

[file alert_file_name ]
Exceptwhenusingthe term flag,thiscommandworkswithonlyasingle

currentADRhome.IfmorethanoneADRhomeisset,ADRCIpromptsyou
tochoosetheADRhometouse.
()()Table1510FlagsfortheSHOWALERTcommand
Flag
Description
UsesaSQLlikepredicatestringtoshowonlythe
alertlogentriesforwhichthepredicateistrue.
Thepredicatestringmustbeenclosedindouble
quotes.
predicate_string
Table1511liststhefieldsthatcanbeusedinthe
predicatestring.
tail[ num ]
Displaysthemostrecententriesinthealertlog.
[f]
Usethe num optiontodisplaythelast num

entriesinthealertlog.Ifnumisomitted,thelast
10entriesaredisplayed.
Ifthe f optionisgiven,afterdisplayingthe
requestedmessages,thecommanddoesnot
return.Instead,itremainsactiveandcontinuously
displaysnewalertlogentriestotheterminalas
theyarriveinthealertlog.Youcanusethis
commandtoperformlivemonitoringofthealert
log.Toterminatethecommand,pressCTRLC.
term
Directsresultstotheterminal.Outputstheentire
alertlogsfromallcurrentADRhomes,oneafter
another.Ifthisoptionisnotgiven,theresultsare
displayedinthedefaulteditor.
file
Enablesyoutospecifyanalertfileoutsidethe
ADR. alert_file_name mustbespecifiedwith
afullpathname.Notethatthisoptioncannotbe
usedwiththe tail option.
alert_file_name
()()Table1511AlertFieldsforSHOWALERT
Field
Type
ORIGINATING_TIMESTAMP
timestamp
NORMALIZED_TIMESTAMP
timestamp
ORGANIZATION_ID
text(65)
COMPONENT_ID
text(65)
HOST_ID
text(65)
HOST_ADDRESS
text(17)
MESSAGE_TYPE
number
MESSAGE_LEVEL
number
MESSAGE_ID
text(65)
MESSAGE_GROUP
text(65)
CLIENT_ID
text(65)
MODULE_ID
text(65)
PROCESS_ID
text(33)
THREAD_ID
text(65)
USER_ID
text(65)
INSTANCE_ID
text(65)
DETAILED_LOCATION
text(161)
UPSTREAM_COMP_ID
text(101)
DOWNSTREAM_COMP_ID
text(101)
EXECUTION_CONTEXT_ID
text(101)
EXECUTION_CONTEXT_SEQUENCE
number
ERROR_INSTANCE_ID
number
ERROR_INSTANCE_SEQUENCE
number
MESSAGE_TEXT
text(2049)
MESSAGE_ARGUMENTS
text(129)
SUPPLEMENTAL_ATTRIBUTES
text(129)
SUPPLEMENTAL_DETAILS
text(129)
PROBLEM_KEY
text(65)
()Example
ThisexampleshowsallalertmessagesforthecurrentADRhomeinthe
defaulteditor:
showalert
ThisexampleshowsallalertmessagesforthecurrentADRhomeanddirects
theoutputtotheterminalinsteadofthedefaulteditor:
showalertterm
ThisexampleshowsallalertmessagesforthecurrentADRhomewith
messagetextdescribinganincident:
showalertp"message_textlike'%incident%'"
Thisexampleshowsthelasttwentyalertmessages,andthenkeepsthealert
logopen,displayingnewalertlogentriesastheyarrive:
showalerttail20f
ThisexampleshowsallalertmessagesforasingleADRhomeinthedefault
editorwhenmultipleADRhomeshavebeenset:
showalert
Choosethealertlogfromthefollowinghomestoview:
1:diag/rdbms/
2:diag/tnslsnr/sta00339/listener
Q:toquit
Pleaseselectoption:
1
SeeAlso:
"SETEDITOR"
()
SHOWBASE
()Purpose
ShowsthecurrentADRbase.
showbase [product product_name ]
Optionally,youcanshowtheproduct'sADRbaselocationforaspecific
product.Theproductscurrentlysupportedare"CLIENT"and"ADRCI".
it.
()Example
ThisexampleshowsthecurrentADRbase:
showbase
Output:
ADRbaseis"/scratch/nick/rdbms/log"
ThisexampleshowsthecurrentADRbaseforOracleDatabaseclients:
showbaseproductclient
()
SHOWCONTROL
()Purpose
DisplaysinformationabouttheAutomaticDiagnosticRepository(ADR),
includingthepurgingpolicy.
showcontrol
DisplaysvariousattributesoftheADR,includingthefollowingpurgingpolicy
attributes:
AttributeName
Description
SHORTP_POLICY
NumberofhoursafterwhichtopurgeADRcontents
thathaveashortlife.Defaultis720(30days).
LONGP_POLICY
NumberofhoursafterwhichtopurgeADRcontents
thathavealonglife.Defaultis8760(365days).
()
SHOWHM_RUN
()Purpose
ShowsallinformationforHealthMonitorruns.
showhm_run [ ppredicate_string ]
[ ppredicate_string ] isaSQLlikepredicatespecifyingthefield
namestoselect.Table1512displaysthelistoffieldnamesyoucanuse.
()()Table1512FieldsforHealthMonitorRuns
Field
Type
RUN_ID
number
RUN_NAME
text(31)
CHECK_NAME
text(31)
NAME_ID
number
MODE
number
START_TIME
timestamp
RESUME_TIME
timestamp
END_TIME
timestamp
MODIFIED_TIME
timestamp
TIMEOUT
number
FLAGS
number
STATUS
number
SRC_INCIDENT_ID
number
NUM_INCIDENTS
number
ERR_NUMBER
number
REPORT_FILE
bfile
()Example
ThisexampledisplaysdataforallHealthMonitorruns:
showhm_run
ThisexampledisplaysdatafortheHealthMonitorrunwithID123:
showhm_runp"run_id=123"
SeeAlso:
HealthMonitor
()
SHOWHOMEPATH
()Purpose
Identicaltothe SHOW HOMES command.
showhomepath|showhomes|showhome
it.
()Example
showhomepath
Output:
ADRHomes:
diag/diagtool/user_nick/host_3075434791_11
diag/rdbms/db1/db1
diag/rdbms/db2/db2
SeeAlso:
"SETHOMEPATH"forinformationonhowtosetthehomepath
()
SHOWHOMES
()Purpose
ShowtheADRhomesinthecurrentADRCIsession.
showhomes|showhome|showhomepath
it.
()Example
showhomes
Output:
ADRHomes:
diag/diagtool/user_nick/host_3075434791_11
diag/rdbms/db1/db1
diag/rdbms/db2/db2
()
SHOWINCDIR
()Purpose
Showstracefilesforthespecifiedincident.
showincdir[ id | id_low id_high ]
YoucanprovideasingleincidentID( id )orarangeofincidents( id_low to

id_high ).IfnoincidentIDisgiven,tracefilesforallincidentsarelisted.
()Example
Thisexampleshowsalltracefilesforallincidents:
showincdir
Output:
ADRHome=/ade/sfogel_emdb/oracle/log/diag/rdbms/emdb/emdb:
******************************************************************
diag/rdbms/emdb/emdb/incident/incdir_3801/emdb_ora_23604_i3801.trc
diag/rdbms/emdb/emdb/incident/incdir_3801/emdb_m000_23649_i3801_a.
diag/rdbms/emdb/emdb/incident/incdir_3633/emdb_pmon_28970_i3633.tr
diag/rdbms/emdb/emdb/incident/incdir_3713/emdb_smon_28994_i3713.tr
Thisexampleshowsalltracefilesforincident3713
showincdir3713
Output:
******************************************************************
diag/rdbms/emdb/emdb/incident/incdir_3713/emdb_smon_28994_i3713.tr
Thisexampleshowsalltracefilesforincidentsbetween3801and3804:
showincdir38013804
Output:
******************************************************************
()
SHOWINCIDENT
()Purpose
ListsalloftheincidentsassociatedwiththecurrentADRhome.Includesboth
openandclosedincidents.
showincident[ p
predicate_string ][mode{ BASIC | BRIEF | DETAIL }]
[orderby field1 , field2 ,...][ ASC | DSC ]
Table1513describestheflagsfor SHOW INCIDENT .

()()Table1513FlagsforSHOWINCIDENTcommand
Flag
Description
p predicate_string
Useapredicatestring
toshowonlythe
incidentsforwhich
thepredicateistrue.
Thepredicatestring
mustbeenclosedin
doublequotes.
Table1514liststhe
fieldsthatcanbe
usedinthepredicate
string.
[mode{ BASIC | BRIEF | DETAIL }]
Chooseanoutput
modeforincidents.
BASIC isthedefault.
BASIC displays
onlybasicincident
information(the
INCIDENT_ID ,
PROBLEM_ID ,and
CREATE_TIME
fields).Itdoesnot
displayflood
controlled
incidents.
BRIEF displaysall
informationrelated
totheincidents,as
givenbythefields
inTable1514.It
includesflood
controlled
incidents.
DETAIL displays
allinformationfor
theincidents(as
with BRIEF mode)
aswellas
informationabout
incidentdumps.It
includesflood
controlled
incidents.
[orderby field1 , field2 ,...]
[ ASC | DSC ]
Showresultssorted
byfieldinthegiven
order,aswellasin
ascending( ASC )and
descendingorder
( DSC ).Bydefault,
resultsareshownin
ascendingorder.
()()Table1514IncidentFieldsforSHOWINCIDENT
Field
Type
INCIDENT_ID
number
PROBLEM_KEY
text(550)
PROBLEM_ID
number
CREATE_TIME
timestamp
CLOSE_TIME
timestamp
STATUS
number
FLAGS
number
FLOOD_CONTROLLED
number (decodedto
atextstatusby
ADRCI)
ERROR_FACILITY
text(10)
ERROR_NUMBER
number
ERROR_ARG1
text(64)
ERROR_ARG2
text(64)
ERROR_ARG3
text(64)
ERROR_ARG4
text(64)
ERROR_ARG5
text(64)
ERROR_ARG6
text(64)
ERROR_ARG7
text(64)
ERROR_ARG8
text(64)
SIGNALLING_COMPONENT
text(64)
SIGNALLING_SUBCOMPONENT
text(64)
SUSPECT_COMPONENT
text(64)
SUSPECT_SUBCOMPONENT
text(64)
ECID
text(64)
IMPACT
number
()Examples
ThisexampleshowsallincidentsforthisADRhome:
showincident
Output:
******************************************************************
INCIDENT_IDPROBLEM_KEY
3808ORA603
3807ORA600[4137]
3806ORA603
3805ORA600[4136]
3804ORA1578
3713ORA600[4136]
3633ORA600[4136]
7rowsfetched
Thisexampleshowsthedetailviewforincident3805:
adrci>showincidentmodeDETAILp"incident_id=3805"
Output:
******************************************************************
**********************************************************
INCIDENTINFORECORD1
**********************************************************
INCIDENT_ID3805
STATUSclosed
CREATE_TIME2007061821:35:25.01257907:00
PROBLEM_ID2
CLOSE_TIME2007061822:26:54.14353707:00
FLOOD_CONTROLLEDnone
ERROR_FACILITYORA
ERROR_NUMBER600
ERROR_ARG14136
ERROR_ARG22
ERROR_ARG318.0.628
ERROR_ARG4<NULL>
ERROR_ARG5<NULL>
ERROR_ARG6<NULL>
ERROR_ARG7<NULL>
ERROR_ARG8<NULL>
SIGNALLING_COMPONENT<NULL>
SIGNALLING_SUBCOMPONENT<NULL>
SUSPECT_COMPONENT<NULL>
SUSPECT_SUBCOMPONENT<NULL>
ECID<NULL>
IMPACTS0
PROBLEM_KEYORA600[4136]
FIRST_INCIDENT3805
FIRSTINC_TIME2007061821:35:25.01257907:00
LAST_INCIDENT3713
LASTINC_TIME2007061821:35:44.75444207:00
IMPACT10
IMPACT20
IMPACT30
IMPACT40
KEY_NAMEClientProcId
KEY_VALUEoracle@stadh43(TNSV1V3).23716_
KEY_NAMESID
KEY_VALUE127.52237
KEY_NAMEProcId
KEY_VALUE23.90
KEY_NAMEPQ
KEY_VALUE(0,1182227717)
OWNER_ID1
INCIDENT_FILE/.../emdb/emdb/incident/incdir_38
OWNER_ID1
INCIDENT_FILE/.../emdb/emdb/trace/emdb_ora_237
OWNER_ID1
INCIDENT_FILE/.../emdb/emdb/incident/incdir_38
1rowsfetched
()
SHOWPROBLEM
()Purpose
ShowprobleminformationforthecurrentADRhome.
show problem [p predicate_string ]

[last num | all]
[orderby field1 , field2 , ...] [ASC|DSC] ]
Table1515describestheflagsfor SHOW PROBLEM .

()()Table1515FlagsforSHOWPROBLEMcommand
Flag
Description
[p predicate_string ]
UseaSQLlike
predicatestringto
showonlythe
incidentsforwhich
thepredicateistrue.
Thepredicatestring
mustbeenclosedin
doublequotes.
Table1516liststhe
fieldsthatcanbe
usedinthepredicate
string.
[last num | all]
Showsthelast num
problems( last ),or
listalltheproblems
( all ).Bydefault,
SHOWPROBLEM
liststhemostrecent
50problems.
[orderby field1 , field2 , ...]

[ASC | DSC]
Showresultssorted
byfieldinthegiven
order( field1 ,
field2 ,...),aswell
asinascending( ASC )
anddescendingorder
( DSC ).Bydefault,
resultsareshownin
ascendingorder.
()()Table1516ProblemFieldsforSHOWPROBLEM
Field
Type
PROBLEM_ID
number
PROBLEM_KEY
text(550)
FIRST_INCIDENT
number
FIRSTINC_TIME
timestamp
LAST_INCIDENT
number
LASTINC_TIME
timestamp
IMPACT1
number
IMPACT2
number
IMPACT3
number
IMPACT4
number
SERVICE_REQUEST
text(64)
BUG_NUMBER
text(64)
()Example
ThisexamplelistsalltheproblemsinthecurrentADRhome:
show problemall
ThisexampleshowstheproblemwithID4:
show problem p "problem_id=4"
()
SHOWREPORT
()Purpose
Showareportforthespecifiedreporttypeandrunname.Currently,onlythe
hm_run (HealthMonitor)reporttypeissupported,andonlyinXML
formatting.ToviewHTMLformattedHealthMonitorreports,useEnterprise
Managerorthe DBMS_HM PL/SQLpackage.SeeOracleDatabase
Administrator'sGuide(../../server.111/b28310/diag007.htm#ADMIN11276)formore
information.
SHOW REPORT report_type run_name

report_type mustbe hm_run . run_name istheHealthMonitorrunname
fromwhichyoucreatedthereport.Youmustfirstcreatethereportusingthe
CREATEREPORTcommand.
it.
()Example
showreporthm_runhm_run_1421
SeeAlso:
"CREATEREPORT"
"SHOWHM_RUN"
()
SHOWTRACEFILE
()Purpose
Listtracefiles.
showtracefile[ file1 file2 ...][rt|t]

[i inc1 inc2 ...][path path1 path2 ...]
Thiscommandsearchesforoneormorefilesunderthetracedirectoryand
allincidentdirectoriesofthecurrentADRhomes,unlessthe i or path
flagsaregiven.
ThiscommanddoesnotrequireanADRhometobesetunlessusingthe i
option.
Table1518describestheargumentsof SHOW TRACEFILE .
()()Table1517ArgumentsforSHOWTRACEFILECommand
Argument
Description
file1 file2
Filterresultsbyfile
name.The%symbol
isawildcard
character.
()()Table1518FlagsforSHOWTRACEFILECommand
Flag
Description
rt | t
Orderthetrace
filenamesby
timestamp. t sorts
thefilenamesin
ascendingorderby
timestamp,and rt
sortstheminreverse
order.Notethat
filenamesareonly
orderedrelativeto
theirdirectory.Listing
multipledirectoriesof
tracefilesappliesa
separateorderingto
eachdirectory.
Timestampsarelisted
nexttoeachfilename
whenusingthis
option.
[i inc1 inc2 ...]
Selectonlythetrace
filesproducedforthe
givenincidentIDs.
path path1 path2
Queryonlythetrace
filesunderthegiven
pathnames.
()Example
ThisexampleshowsallthetracefilesunderthecurrentADRhome:
showtracefile
ThisexampleshowsalltheMMONtracefiles,sortedbytimestampin
reverseorder:
showtracefile%mmon%rt
Thisexampleshowsalltracefilesforincidents1and4,underthepath
/home/steve/temp :
showtracefilei14path/home/steve/temp
()
SPOOL
()Purpose
DirectsADRCIoutputtoafile.
SPOOL filename [[APPEND]|[OFF]]

filename isthefilenamewheretheoutputistobedirected.Ifafull
pathnameisnotgiven,thefileiscreatedinthecurrentADRCIworking
directory.Ifnofileextensionisgiven,thedefaultextension".ado"isused.
APPEND causestheoutputtobeappendedtotheendofthefile.Otherwise,
thefileisoverwritten.Use OFF toturnoffspooling.
it.
()Example
spoolmyfile
spoolmyfile.adoappend
spooloff
spool
()
Troubles()hootingADRCI
ThefollowingaresomecommonADRCIerrormessages,withtheirpossible
causesandremedies:
()NoADRbaseisset
Cause:YoumayhavestartedADRCIwithanullorinvalidvalueforthe
ORACLE_HOME environmentvariable.
Action:Exit ADRCI ,setthe ORACLE_HOME environmentvariable,andrestart
ADRCI.See"ADRBase"formoreinformation.
()DIA48323:Specifiedpathnamestringmustbeinsidecurrent
ADRhome
Cause:AfileoutsideoftheADRhomeisnotallowedasanincidentfilefor
thiscommand.
Action:RetryusinganincidentfileinsidetheADRhome
()DIA48400:ADRCIinitializationfailed
Cause:TheADRBasedirectorydoesnotexist
Action:Checkthevalueofthe DIAGNOSTIC_DEST initializationparameter,
andensurethatitpointstoanADRbasedirectorythatcontainsatleastone
ADRhome.If DIAGNOSTIC_DEST ismissingornull,checkforavalidADR
basedirectoryhierarchyinORACLE_HOME/log.
()DIA48431:MustspecifyatleastoneADRhomepath
Cause:ThecommandrequiresatleastoneADRhometobecurrent
Action:Usethe SET HOMEPATH commandtomakeoneormoreADRhomes
current.
()DIA48432:TheADRhomepathstringisnotvalid
Cause:ThesuppliedADRhomeisnotvalid,possiblybecausethepathdoes
notexist.
Action:CheckifthesuppliedADRhomepathexists
()DIA48447:Theinputpath[path]doesnotcontainanyADR
homes
Cause:Whenusing SET HOMEPATH tosetanADRhome,youmustsupplya
pathrelativetothecurrentADRbase.
Action:IfthenewdesiredADRhomeisnotwithinthecurrentADRbase,first
setADRbasewith SET BASE ,andthenuse SHOW HOMES tochecktheADR
homesunderthenewADRbase.Next,use SET HOMEPATH tosetanew
ADRhomeifnecessary.
()DIA48448:ThiscommanddoesnotsupportmultipleADR
homes
Cause:TherearemultiplecurrentADRhomesinthecurrentADRCIsession.
Action:Usethe SET HOMEPATH commandtomakeasingleADRhome
current.
(http://www.oracle.com/us/legal/index.html)
ContactUs (http://www.oracle.com/us/corporate/contact/index.html)
TermsofUse(http://www.oracle.com/us/legal/terms/index.html)
LegalNotices
YourPrivacyRights
AboutOracle(http://www.oracle.com/corporate/index.html)
(http://www.oracle.com/us/legal/privacy/index.html)
Copyright2015,Oracleand/oritsaffiliates.Allrightsreserved.

ADRCI - ADR Command Interpreter

Transféré par

Informations du document

Titre original

Copyright

Formats disponibles

Partager ce document

Partager ou intégrer le document

Options de partage

Avez-vous trouvé ce document utile ?

Ce contenu est-il inapproprié ?

Droits d'auteur :

Formats disponibles

ADRCI - ADR Command Interpreter

Transféré par

Droits d'auteur :

Formats disponibles

(//docs.oracle.

errorssuchas ORA00600 andothersevereerrorssuchas ORA07445

errorcode(suchas ORA 600 )andinsomecases,oneormoreerror

1. Ensurethatthe ORACLE_HOME and PATH environmentvariablesareset

Forexample,togethelponthe SHOW TRACEFILE command,enterthe

Forexample,torunthe SHOW HOMES commandinbatchmode,enterthe

Torunthe SHOW HOMES commandfollowedbythe SHOW INCIDENT

Forexample,torunascriptfilenamed adrci_script.txt ,enterthe

Youusethe SET HOMEPATH commandtosetoneormoreADRhomestobe

Thefollowingarevariationsonthe SHOW ALERT command:

Thefollowingarevariationsonthe SHOW INCIDENT command:

Thefollowingarevariationsonthe IPS CREATE PACKAGE command:

Thiscreatesanemptypackage.Youmustusethe IPS ADD INCIDENT or

createreport report_type run_name

host[" host_command_string "]

Use host byitselftoenteranoperatingsystemshell,whichallowsyouto

Usethe <ADR_BASE> variabletoaccesstheADRbasedirectoryasfollows:

ipsadd {incident inc_id |problem prob_id |problemkey

ips add file file_name package pkg_id

and <ADR_BASE> variablesifdesired.ThefilemustbeunderthesameADR

Commands"forinformationonthe <ADR_HOME> directorysyntax

ips add new incidentspackage package_id

ips copy in file filename [to new_name ][overwrite] package

Copiesanexternalfile, filename (specifiedwithfullpathname)intothe

ips copy out file source to target [overwrite]

Copiesafile, source ,toalocationoutsidetheADR, target (specifiedwith

ThisexamplecopiesafileintheADRhomecalled /trace/ora_26201 toa

ips create package {incident inc_id | problem prob_id |

correlate basic includes

ips delete package pkg_id

ips finalize package pkg_id

ips generate package package_id [in path ] [complete |

thefileinthedirectory path .Otherwise,thepackageisgeneratedinthe

ips get manifest from file filename

ips get metadata {from file filename | from adr }

thefile metadata.xml )containsinformationabouttheADRhome,ADR

Inthispreviousexample,uponreceivingthe SET BASE command,ADRCI

ips pack [incident inc_id | problem prob_id | problemkey

AddsincidentwithID inc_id tothe

correlate basic includes

correlate all includesthe

ips remove {incident inc_id | problem prob_id | problemkey

ips remove file file_name package pkg_id

file_name isthefiletoremovefrompackage pkg_id .Thecompletepath

ofthefilemustbespecified.(Youcanusethe <ADR_HOME> and

ips set configuration parameter_id value

ips show configuration [ parameter_id ]

ips show files package pkg_id

ips show incidents package pkg_id

ips unpack file file_name [into path ]

Optionally,youcanunpackthefileintodirectory path ,whichmustexistand

purge [[i { id | start_id end_id }] | [age mins [type

[[i { id1 | start_id end_id }]

{ALERT | INCIDENT | TRACE | CDUMP|HM }]

set control ( purge_policy = value , ... )

set echo on|off

set editor editor_program

set homepath homepath_str1 homepath_str2 ...

The homepath_str n stringsarethepathsoftheADRhomesrelativetothe

set termout on|off

showalert[p predicate_string ][tail[ num ][f]][term]

Exceptwhenusingthe term flag,thiscommandworkswithonlyasingle

Usethe num optiontodisplaythelast num