ADRCI_ ADR Command Interpreter

Home(https://docs.oracle.com/)/Database(https://docs.oracle.com/en/database/)/OracleDatabaseOnlineDocumentation11gRelease1(11.1)(../../index.htm)/DataWarehousingandBusinessIntelligence(../../nav/portal_6.htm)

DatabaseUtilities

()

()

15()ADRCI:ADRCommandInterpreterTheADRCommandInterpreter(ADRCI)isacommandlinetoolthatyouusetomanageOracleDatabasediagnosticdata.

Thischaptercontainsthefollowingsections:

AbouttheADRCommandInterpreter(ADRCI)

Definitions

StartingADRCIandGettingHelp

SettingtheADRCIHomepathBeforeUsingADRCICommands

ViewingtheAlertLog

FindingTraceFiles

ViewingIncidents

PackagingIncidents

ADRCICommandReference

TroubleshootingADRCI

SeeAlso:OracleDatabaseAdministrator'sGuide(../../server.111/b28310/diag.htm#ADMIN11007)formoreinformationon

(//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)

managingdiagnosticdata.

()

AbouttheADRCommandInterpreter(ADRCI)ADRCIisacommandlinetoolthatispartofthefaultdiagnosabilityinfrastructureintroducedinOracleDatabaseRelease11g.ADRCIenablesyouto:

ViewdiagnosticdatawithintheAutomaticDiagnosticRepository(ADR).

ViewHealthMonitorreports.

PackageincidentandprobleminformationintoazipfilefortransmissiontoOracleSupport.

Diagnosticdataincludesincidentandproblemdescriptions,tracefiles,dumps,healthmonitorreports,alertlogentries,andmore.

ADRCIhasarichcommandset,andcanbeusedininteractivemodeorwithinscripts.Inaddition,ADRCIcanexecutescriptsofADRCIcommandsinthesamewaythatSQL*PlusexecutesscriptsofSQLandPL/SQLcommands.

ADRdataissecuredbyoperatingsystempermissionsontheADRdirectories,hencethereisnoneedtologintoADRCI.

Note:TheeasiestandrecommendedwaytomanagediagnosticdataiswithOracleEnterpriseManagerSupportWorkbench.ADRCIprovidesacommandlinealternativetomostofthefunctionalityofSupportWorkbench,andaddscapabilitiessuchaslistingandqueryingtracefiles.SeeOracleDatabaseAdministrator'sGuide(../../server.111/b28310/diag.htm#ADMIN11007)forcompleteinformationabouttheSupportWorkbench.

()

Definitions

ThefollowingaredefinitionsoftermsusedinthecontextofADRCIandtheOracleDatabasefaultdiagnosabilityinfrastructure:

()AutomaticDiagnosticRepository(ADR)

()TheADRisafilebasedrepositoryfordatabasediagnosticdatasuchastraces,dumps,thealertlog,healthmonitorreports,andmore.Ithasaunifieddirectorystructureacrossmultipleinstancesandmultipleproducts.BeginningwithRelease11g,thedatabase,AutomaticStorageManagement(ASM),andotherOracleproductsorcomponentsstorealldiagnosticdataintheADR.EachinstanceofeachproductstoresdiagnosticdataunderneathitsownADRhomedirectory(see"ADRHome").Forexample,inanOracleRealApplicationClustersenvironmentwithsharedstorageandASM,eachdatabaseinstanceandeachASMinstancehasahomedirectorywithintheADR.TheADR'sunifieddirectorystructureenablescustomersandOracleSupporttocorrelateandanalyzediagnosticdataacrossmultipleinstancesandmultipleproducts.

()Problem

()Aproblemisacriticalerrorinthedatabase.CriticalerrorsincludeinternalerrorssuchasORA00600 andothersevereerrorssuchasORA07445(operatingsystemexception)orORA04031 (outofmemoryinthesharedpool).ProblemsaretrackedintheADR.EachproblemhasaproblemkeyandauniqueproblemID.(See"ProblemKey".)

()Incident

()Anincidentisasingleoccurrenceofaproblem.Whenaproblemoccursmultipletimes,anincidentiscreatedforeachoccurrence.IncidentsaretrackedintheADR.EachincidentisidentifiedbyanumericincidentID,whichisuniquewithintheADR.Whenanincidentoccurs,thedatabasemakesanentryinthealertlog,sendsanincidentalerttoOracleEnterpriseManager,gathersdiagnosticdataabouttheincidentintheformofdumpfiles(incidentdumps),tagstheincidentdumpswiththeincidentID,andstorestheincidentdumpsinanADRsubdirectorycreatedforthatincident.

Diagnosisandresolutionofacriticalerrorusuallystartswithanincidentalert.YoucanobtainalistofallincidentsintheADRwithanADRCIcommand.Eachincidentismappedtoasingleproblemonly.

Incidentsarefloodcontrolledsothatasingleproblemdoesnotgeneratetoomanyincidentsandincidentdumps.SeeOracleDatabaseAdministrator'sGuide(../../server.111/b28310/diag001.htm#ADMIN11259)formoreinformationonincidentfloodcontrol.

()ProblemKey

()Everyproblemhasaproblemkey,whichisatextstringthatincludesanerrorcode(suchasORA 600 )andinsomecases,oneormoreerrorparameters.Twoincidentsareconsideredtohavethesamerootcauseiftheirproblemkeysmatch.

()IncidentPackage

()Anincidentpackage(package)isacollectionofdataaboutincidentsforoneormoreproblems.BeforesendingincidentdatatoOracleSupportitmustbecollectedintoapackageusingtheIncidentPackagingService(IPS).Afterapackageiscreated,youcanaddexternalfilestothepackage,removeselectedfilesfromthepackage,orscrub(edit)selectedfilesinthepackagetoremovesensitivedata.

Apackageisalogicalconstructonly,untilyoucreateaphysicalfilefromthepackagecontents.Thatis,anincidentpackagestartsoutasacollectionofmetadataintheAutomaticDiagnosticRepository(ADR).Asyouaddandremovepackagecontents,onlythemetadataismodified.WhenyouarereadytouploadthedatatoOracleSupport,youcreateaphysicalpackageusingADRCI,whichsavesthedataintoazipfile.

()Finalizing

()BeforeADRCIcangenerateaphysicalpackagefromalogicalpackage,thepackagemustbefinalized.Thismeansthatothercomponentsarecalledtoaddanycorrelateddiagnosticdatafilestotheincidentsalreadyinthispackage.Finalizingalsoaddsrecenttracefiles,alertlogentries,HealthMonitorreports,SQLtestcases,andconfigurationinformation.Thisstepisrunautomaticallywhenaphysicalpackageisgenerated,andcanalsoberunmanuallyusingtheADRCIutility.Aftermanuallyfinalizingapackage,youcanreviewthefilesthatwereaddedandthenremoveoreditanythatcontainsensitiveinformation.

SeeAlso:OracleDatabaseAdministrator'sGuide(../../server.111/b28310/diag010.htm#ADMIN12304)formoreinformationaboutcorrelateddiagnosticdata

()ADRHome

()()AnADRhomeistherootdirectoryforalldiagnosticdatatraces,dumps,alertlog,andsoonforaparticularinstanceofaparticularOracleproductorcomponent.Forexample,inaRealApplicationClustersenvironmentwithASM,eachdatabaseinstanceandeachASMinstancehasanADRhome.AllADRhomessharethesamehierarchicaldirectorystructure.SomeofthestandardsubdirectoriesineachADRhomeincludealert(forthealertlog),trace(fortracefiles),andincident(forincidentinformation).AllADRhomesarelocatedwithintheADRbasedirectory.(See"ADRBase".)

SomeADRCIcommandscanworkwithmultipleADRhomessimultaneously.ThecurrentADRCIhomepathdeterminestheADRhomesthataresearchedfordiagnosticdatawhenanADRCIcommandisissued.See"Homepath"formoreinformation.

()ADRBase

()()TopermitcorrelationofdiagnosticdataacrossmultipleADRhomes,ADRhomesaregroupedtogetherunderthesamerootdirectorycalledtheADRbase.Forexample,inanOracleRealApplicationClusters(RAC)environment,theADRbasecouldbeonashareddisk,andtheADRhomeforeachOracleRACinstancecouldbelocatedunderthisADRbase.

ThelocationoftheADRbaseforadatabaseinstanceissetbytheDIAGNOSTIC_DEST initializationparameter.Ifthisparameterisomittedorisnull,thedatabasesetsittoadefaultvalue.SeeOracleDatabaseAdministrator'sGuide(../../server.111/b28310/diag001.htm#ADMIN11008)fordetails.

WhenmultipledatabaseinstancesshareanOraclehome,whethertheyaremultiplesingleinstancesortheinstancesofanOracleRealApplicationClustersdatabase,andwhenoneormoreoftheseinstancessetADRbaseindifferentlocations,thelastinstancetostartupdeterminesthedefaultADRbaseforADRCI.

()Homepath

()()AllADRCIcommandsoperateondiagnosticdatainthe"current"ADRhomes.MorethanoneADRhomecanbecurrentatanyonetime.SomeADRCIcommands(suchasSHOW INCIDENT )searchforanddisplaydiagnosticdatafromallcurrentADRhomes,whileothercommandsrequirethatonlyoneADRhomebecurrent,anddisplayanerrormessageifmorethanoneiscurrent.

TheADRCIhomepathdeterminestheADRhomesthatarecurrent.ItdoessobypointingtoadirectorywithintheADRbasehierarchy.IfitpointstoasingleADRhomedirectory,thatADRhomeistheonlycurrentADRhome.IfthehomepathpointstoadirectorythatisabovetheADRhomedirectorylevelinthehierarchy,allADRhomesthatarebelowthedirectorythatispointedtobecomecurrent.

ThehomepathisnullbydefaultwhenADRCIstarts.ThismeansthatallADRhomesunderADRbasearecurrent.

TheSHOW HOME andSHOW HOMEPATH commandsdisplayalistoftheADRhomesthatarecurrent,andtheSET HOMEPATH commandsetsthehomepath.

SeeAlso:

OracleDatabaseAdministrator'sGuide(../../server.111/b28310/diag001.htm#ADMIN11008)formoreinformationonthestructureandlocationoftheADRanditsdirectories.

"SettingtheADRCIHomepathBeforeUsingADRCICommands"

"SETHOMEPATH"

"SHOWHOMES"

()

StartingADRCIandGettingHelp()()YoucanuseADRCIininteractivemodeorbatchmode.Detailsareprovidedinthefollowingsections:

UsingADRCIinInteractiveMode

GettingHelp

UsingADRCIinBatchMode

()

UsingADRCIinInteractiveModeInteractivemodepromptsyoutoenterindividualcommandsoneatatime.Eachenteredcommandisfollowedbyitsoutput.

()TouseADRCIininteractivemode:

1. EnsurethattheORACLE_HOME andPATH environmentvariablesaresetproperly.

OntheWindowsplatform,theseenvironmentvariablesaresetintheWindowsregistryautomaticallyuponinstallation.Onotherplatforms,youmustsetandcheckenvironmentvariableswithoperatingsystemcommands.

ThePATH environmentvariablemustincludeORACLE_HOME/bin.

2. Enterthefollowingcommandattheoperatingsystemcommandprompt:

ADRCI

Theutilitystartsanddisplaysthefollowingprompt:

adrci>

3. EnterADRCIcommands,followingeachwiththeEnterkey.

4. EnteroneofthefollowingcommandstoexitADRCI:

EXIT

QUIT

()

GettingHelpWiththeADRCIhelpsystem,youcan:

ViewalistofADRcommands.

Viewhelpforanindividualcommand.

ViewalistofADRCIcommandlineoptions.

ToviewalistofADRCIcommands:

1. StartADRCIininteractivemode.

See"UsingADRCIinInteractiveMode"forinstructions.

2. AttheADRCIprompt,enterthefollowingcommand:

HELP

TogethelpforaspecificADRCIcommand:


See"UsingADRCIinInteractiveMode"forinstructions.


HELPcommand

Forexample,togethelpontheSHOW TRACEFILE command,enterthefollowing:

HELPSHOWTRACEFILE

Toviewalistofcommandlineoptions:

Enterthefollowingcommandattheoperatingsystemcommandprompt:

ADRCIHELP

Theutilitydisplaysoutputsimilartothefollowing:

Syntax:

adrci[help][script=script_filename][exec="command[command...]"]

OptionsDescription(Default)

scriptscriptfilename(None)

helphelponthecommandoptions(None)

execexecasetofcommands(None)

()

UsingADRCIinBatchMode()BatchmodeenablesyoutorunaseriesofADRCIcommandsatonce,withoutbeingpromptedforinput.Tousebatchmode,youaddacommandlineparametertotheADRCI commandwhenyoustartADRCI.BatchmodeenablesyoutoincludeADRCIcommandsinshellscriptsorWindowsbatchfiles.Likeinteractivemode,theORACLE_HOME andPATH environmentvariablesmustbesetbeforestartingADRCI.

Thefollowingcommandlineparametersareavailableforbatchoperation:

()()Table151ADRCICommandLineParametersforBatchOperation

Parameter Description

EXEC EnablesyoutosubmitoneormoreADRCIcommandsontheoperatingsystemcommandlinethatstartsADRCI.

Commandsareseparatedbysemicolons().

SCRIPT EnablesyoutorunascriptcontainingADRCIcommands.

TosubmitADRCIcommandsonthecommandline:


ADRCIEXEC="COMMAND[COMMAND]..."

Forexample,toruntheSHOW HOMES commandinbatchmode,enterthefollowingcommandattheoperatingsystemcommandprompt:

ADRCIEXEC="SHOWHOMES"

ToruntheSHOW HOMES commandfollowedbytheSHOW INCIDENTcommand,enterthefollowing:

ADRCIEXEC="SHOWHOMESSHOWINCIDENT"

TorunADRCIscripts:


ADRCISCRIPT=SCRIPT_FILE_NAME

Forexample,torunascriptfilenamedadrci_script.txt ,enterthefollowingcommandattheoperatingsystemcommandprompt:

ADRCISCRIPT=adrci_script.txt

Ascriptfilecontainsaseriesofcommandsseparatedbysemicolons()orlinebreaks,suchas:

SETHOMEPATHdiag/rdbms/orcl/orclSHOWALERTterm

()

SettingtheADRCIHomepathBeforeUsingADRCICommandsWhendiagnosingaproblem,youmaywanttoworkwithdiagnosticdatafrommultipledatabaseinstancesorcomponents,oryoumaywanttofocusondiagnosticdatafromoneinstanceorcomponent.Toworkwithdiagnosticdatafrommultipleinstancesorcomponents,youmustensurethattheADRhomesforalloftheseinstancesorcomponentsare"current."Toworkwithdiagnosticdatafromonlyoneinstanceorcomponent,youmustensurethatonlytheADRhomeforthatinstanceorcomponentiscurrent.YoucontroltheADRhomesthatarecurrentbysettingtheADRCIhomepath.

Ifmultiplehomesarecurrent,thismeansthatthehomepathpointstoadirectoryintheADRdirectorystructurethatcontainsmultipleADRhomedirectoriesunderneathit.TofocusonasingleADRhome,youmustsetthehomepathtopointlowerinthedirectoryhierarchy,toasingleADRhomedirectory.

Forexample,iftheOracleRealApplicationClusters(RAC)databasewithdatabasenameorclbi hastwoinstances,wheretheinstanceshaveSIDsorclbi1 andorclbi2 ,thefollowingtwoADRhomesexist:

/diag/rdbms/orclbi/orclbi1/

/diag/rdbms/orclbi/orclbi2/

NotethatinallADRCIcommandsandoutput,ADRhomedirectorypaths(ADRhomes)arealwaysexpressedrelativetoADRbase.SoifADRbaseiscurrently/u01/app/oracle,theabsolutepathsofthesetwoADRhomesarethefollowing:

/u01/app/oracle/diag/rdbms/orclbi/orclbi1/

/u01/app/oracle/diag/rdbms/orclbi/orclbi2/

YouusetheSET HOMEPATH commandtosetoneormoreADRhomestobecurrent.IfADRbaseis/u01/app/oracleandyouwanttosetthehomepathto/u01/app/oracle/diag/rdbms/orclbi/orclbi2/,youusethiscommand:

adrci>sethomepathdiag/rdbms/orclbi/orclbi2

WhenADRCIstarts,thehomepathisnullbydefault,whichmeansthatallADRhomesunderADRbasearecurrent.Inthepreviouslycitedexample,therefore,theADRhomesforbothOracleRACinstanceswouldbecurrent:

adrci>showhomes

ADRHomes:

diag/rdbms/orclbi/orclbi1


Inthiscase,anyADRCIcommandthatyourun,assumingthatthecommandsupportsmorethanonecurrentADRhome,workswithdiagnosticdatafrombothADRhomes.Ifyouweretosetthehomepathto/diag/rdbms/orclbi/orclbi2,onlytheADRhomefortheinstancewithSIDorclbi2 wouldbecurrent:

adrci>sethomepathdiag/rdbms/orclbi/orclbi2

adrci>showhomes

ADRHomes:


Inthiscase,anyADRCIcommandthatyourunwouldworkwithdiagnosticdatafromthissingleADRhomeonly.

SeeAlso:

OracleDatabaseAdministrator'sGuide(../../server.111/b28310/diag001.htm#ADMIN11008)formoreinformationonthestructureofADRhomes

"ADRBase"

"ADRHome"

"Homepath"

"SETHOMEPATH"

"SHOWHOMES"

()

ViewingtheAlertLogBeginningwithRelease11gofOracleDatabase,thealertlogiswrittenasbothanXMLformattedfileandasatextfile.Youcanvieweitherformatofthefilewithanytexteditor,oryoucanrunanADRCIcommandtoviewtheXMLformattedalertlogwiththeXMLtagsstripped.Bydefault,ADRCIdisplaysthealertloginyourdefaulteditor.YoucanusetheSET EDITORcommandtochangeyourdefaulteditor.

ToviewthealertlogwithADRCI:


See"StartingADRCIandGettingHelp"forinstructions.

2. (Optional)UsetheSET HOMEPATH commandtoselect(makecurrent)asingleADRhome.

YoucanusetheSHOW HOMES commandfirsttoseealistofcurrentADRhomes.See"Homepath"and"SettingtheADRCIHomepathBeforeUsingADRCICommands"formoreinformation.


SHOWALERT

IfmorethanoneADRhomeiscurrent,youarepromptedtoselectasingleADRhomefromalist.Thealertlogisdisplayed,withXMLtagsstripped,inyourdefaulteditor.

4. ExittheeditortoreturntotheADRCIcommandprompt.

ThefollowingarevariationsontheSHOW ALERT command:

SHOWALERTTAIL

Thisdisplaysthelastportionofthealertlog(thelast10entries)inyourterminalsession.

SHOWALERTTAIL50

Thisdisplaysthelast50entriesinthealertloginyourterminalsession.

SHOWALERTTAILF

Thisdisplaysthelast10entriesinthealertlog,andthenwaitsformoremessagestoarriveinthealertlog.Aseachmessagearrives,itisappendedtothedisplay.Thiscommandenablesyoutoperform"livemonitoring"ofthealertlog.PressCTRLC tostopwaitingandreturntotheADRCIprompt.

SPOOL/home/steve/MYALERT.LOG

SHOWALERTTERM

SPOOLOFF

Thisoutputsthealertlog,withoutXMLtags,tothefile/home/steve/MYALERT.LOG .

SHOWALERTP"MESSAGE_TEXTLIKE'%ORA600%'"

Thisdisplaysonlyalertlogmessagesthatcontainthestring'ORA600'.Theoutputlookssomethinglikethis:

ADRHome=/u01/app/oracle/product/11.1.0/db_1/log/diag/rdbms/orclbi/orclbi:

******************************************************************************

01SEP0609.17.44.849000000PM07:00

AlertMsg1:ORA600dbgris01,addr=0xa9876541

SeeAlso:

"SHOWALERT"

"SETEDITOR"

OracleDatabaseAdministrator'sGuide(../../server.111/b28310/diag005.htm#ADMIN11267)forinstructionsforviewingthealertlogwithOracleEnterpriseManagerorwithatexteditor

()

FindingTraceFiles()()ADRCIenablesyoutoviewthenamesoftracefilesthatarecurrentlyintheautomaticdiagnosticrepository(ADR).YoucanviewthenamesofalltracefilesintheADR,oryoucanapplyfilterstoviewasubsetofnames.Forexample,ADRCIhascommandsthatenableyouto:

Obtainalistoftracefileswhosefilenamematchesasearchstring.

Obtainalistoftracefilesinaparticulardirectory.

Obtainalistoftracefilesthatpertaintoaparticularincident.

Youcancombinefilteringfunctionsbyusingthepropercommandlineparameters.

TheSHOW TRACEFILE commanddisplaysalistofthetracefilesthatarepresentinthetracedirectoryandinallincidentdirectoriesunderthecurrentADRhome.WhenmultipleADRhomesarecurrent,thetracesfilelistsfromallADRhomesareoutputoneafteranother.

ThefollowingstatementliststhenamesofalltracefilesinthecurrentADRhomes,withoutanyfiltering:

SHOWTRACEFILE

Thefollowingstatementliststhenameofeverytracefilethathasthestring'mmon'initsfilename.Thepercentsign(%)isusedasawildcardcharacter,andthesearchstringiscasesensitive.

SHOWTRACEFILE%mmon%

Thisstatementliststhenameofeverytracefilethatislocatedinthe/home/steve/temp directoryandthathasthestring'mmon'initsfilename:

SHOWTRACEFILE%mmon%PATH/home/steve/temp

Thisstatementliststhenamesoftracefilesinreverseorderoflastmodifiedtime.Thatis,themostrecentlymodifiedtracefilesarelistedfirst.

SHOWTRACEFILERT

Thisstatementliststhenamesofalltracefilesrelatedtoincidentnumber1681:

SHOWTRACEFILEI1681

SeeAlso:

"SHOWTRACEFILE"

OracleDatabaseAdministrator'sGuide(../../server.111/b28310/diag001.htm#ADMIN11008)forinformationaboutthedirectorystructureoftheADR

()

ViewingIncidentsTheADRCISHOW INCIDENT commanddisplaysinformationaboutopenincidents.Foreachincident,theincidentID,problemkey,andincidentcreationtimeareshown.IftheADRCIhomepathissetsothattherearemultiplecurrentADRhomes,thereportincludesincidentsfromallofthem.

Toviewareportofallopenincidents:

1. StartADRCIininteractivemode,andensurethatthehomepathpointstothecorrectdirectorywithintheADRbasedirectoryhierarchy.

See"StartingADRCIandGettingHelp"and"Homepath"fordetails.


SHOWINCIDENT

ADRCIgeneratesoutputsimilartothefollowing:

ADRHome=/u01/app/oracle/product/11.1.0/db_1/log/diag/rdbms/orclbi/orclbi:

*****************************************************************************

INCIDENT_IDPROBLEM_KEYCREATE_TIME

3808ORA6032007061821:35:49.32216107:00

3807ORA600[4137]2007061821:35:47.86211407:00

3805ORA600[4136]2007061821:35:25.01257907:00

3804ORA15782007061821:35:08.48315607:00

4rowsfetched

ThefollowingarevariationsontheSHOW INCIDENT command:

SHOWINCIDENTMODEBRIEF

SHOWINCIDENTMODEDETAIL

Thesecommandsproducemoredetailedversionsoftheincidentreport.

SHOWINCIDENTMODEDETAILP"INCIDENT_ID=1681"

Thisshowsadetailedincidentreportforincident1681only.

SeeAlso:"ADRCICommandReference"

()

PackagingIncidents()YoucanuseADRCIcommandstopackageoneormoreincidentsfortransmissiontoOracleSupportforanalysis.Backgroundinformationandinstructionsarepresentedinthefollowingtopics:

AboutPackagingIncidents

CreatingIncidentPackages

()

AboutPackagingIncidentsPackagingincidentsisathreestepprocess:

()Step1Createalogicalincidentpackage.

Theincidentpackage(package)isdenotedaslogicalbecauseitexistsonlyasmetadataintheautomaticdiagnosticrepository(ADR).Ithasnocontentuntilyougenerateaphysicalpackagefromthelogicalpackage.Thelogicalpackageisassignedapackagenumber,andyourefertoitbythatnumberinsubsequentcommands.

Youcancreatethelogicalpackageasanemptypackage,orasapackagebasedonanincidentnumber,aproblemnumber,aproblemkey,oratimeinterval.Ifyoucreatethepackageasanemptypackage,youcanadddiagnosticinformationtoitinstep2.

Creatingapackagebasedonanincidentmeansincludingdiagnosticdatadumps,healthmonitorreports,andsoonforthatincident.Creatingapackagebasedonaproblemnumberorproblemkeymeansincludinginthepackagediagnosticdataforincidentsthatreferencethatproblemnumberorproblemkey.Creatingapackagebasedonatimeintervalmeansincludingdiagnosticdataonincidentsthatoccurredinthetimeinterval.

()Step2Adddiagnosticinformationtotheincidentpackage

Ifyoucreatedalogicalpackagebasedonanincidentnumber,aproblemnumber,aproblemkey,oratimeinterval,thisstepisoptional.YoucanaddadditionalincidentstothepackageoryoucanaddanyfilewithintheADRtothepackage.Ifyoucreatedanemptypackage,youmustuseADRCIcommandstoaddincidentsorfilestothepackage.

()Step3Generatethephysicalincidentpackage

Whenyousubmitthecommandtogeneratethephysicalpackage,ADRCIgathersallrequireddiagnosticfilesandaddsthemtoazipfileinadesignateddirectory.Youcangenerateacompletezipfileoranincrementalzipfile.Anincrementalfilecontainsallthediagnosticfilesthatwereaddedorchangedsincethelastzipfilewascreatedforthesamelogicalpackage.Youcancreateincrementalfilesonlyafteryoucreateacompletefile,andyoucancreateasmanyincrementalfilesasyouwant.Eachzipfileisassignedasequencenumbersothatthefilescanbeanalyzedinthecorrectorder.

Zipfilesarenamedaccordingtothefollowingscheme:

packageName_mode_sequence.zip

where:

packageName consistsofaportionoftheproblemkeyfollowedbyatimestamp

mode iseither'COM'or'INC',forcompleteorincremental

sequence isaninteger

Forexample,ifyougenerateacompletezipfileforalogicalpackagethatwascreatedonSeptember6,2006at4:53p.m.,andthengenerateanincrementalzipfileforthesamelogicalpackage,youwouldcreatefileswithnamessimilartothefollowing:

ORA603_20060906165316_COM_1.zip

ORA603_20060906165316_INC_2.zip

()

CreatingIncidentPackages()()ThefollowingsectionspresenttheADRCIcommandsthatyouusetocreatealogicalincidentpackage(package)andgenerateaphysicalpackage:

CreatingaLogicalIncidentPackage

AddingDiagnosticInformationtoaLogicalIncidentPackage

GeneratingaPhysicalIncidentPackage

SeeAlso:"AboutPackagingIncidents"

()

CreatingaLogicalIncidentPackageYouusevariantsoftheIPS CREATE PACKAGE commandtocreatealogicalpackage(package).

Tocreateapackagebasedonanincident:




IPSCREATEPACKAGEINCIDENTincident_number

Forexample,thefollowingcommandcreatesapackagebasedonincident3:

IPSCREATEPACKAGEINCIDENT3

ADRCIgeneratesoutputsimilartothefollowing:

Createdpackage10basedonincidentid3,correlationleveltypical

Thepackagenumberassignedtothislogicalpackageis10.

ThefollowingarevariationsontheIPS CREATE PACKAGE command:

IPSCREATEPACKAGE

Thiscreatesanemptypackage.YoumustusetheIPS ADD INCIDENT orIPS ADD FILE commandstoadddiagnosticdatatothepackagebeforegeneratingit.

IPSCREATEPACKAGEPROBLEMproblem_ID

ThiscreatesapackageandincludesdiagnosticinformationforincidentsthatreferencethespecifiedproblemID.(ProblemIDsareintegers.)YoucanobtaintheproblemIDforanincidentfromthereportdisplayedbytheSHOWINCIDENT MODE BRIEF command.BecausetherecanbemanyincidentswiththesameproblemID,ADRCIaddstothepackagethediagnosticinformationforthefirstthreeincidents("earlyincidents")thatoccurredandlastthreeincidents("lateincidents")thatoccurredwiththisproblemID,excludinganyincidentsthatareolderthan90days.

Note:Thenumberofearlyandlateincidents,andthe90dayagelimitaredefaultsthatcanbechanged.See"IPSSETCONFIGURATION".

ADRCImayalsoaddotherincidentsthatcorrelatecloselyintimeorinothercriteriawiththealreadyaddedincidents.

IPSCREATEPACKAGEPROBLEMKEY"problem_key"

Thiscreatesapackageandincludesdiagnosticinformationforincidentsthatreferencethespecifiedproblemkey.YoucanobtainproblemkeysfromthereportdisplayedbytheSHOW INCIDENT command.Becausetherecanbemanyincidentswiththesameproblemkey,ADRCIaddstothepackageonlythediagnosticinformationforthefirstthreeearlyincidentsandlastthreelateincidentswiththisproblemkey,excludingincidentsthatareolderthan90days.

Note:Thenumberofearlyandlateincidents,andthe90dayagelimitaredefaultsthatcanbechanged.See"IPSSETCONFIGURATION".

ADRCImayalsoaddotherincidentsthatcorrelatecloselyintimeorinothercriteriawiththealreadyaddedincidents.

Theproblemkeymustbeenclosedinsinglequotes(')ordoublequotes(")ifitcontainsspacesorquotes.

IPSCREATEPACKAGESECONDSsec

Thiscreatesapackageandincludesdiagnosticinformationforallincidentsthatoccurredfromsec secondsagountilnow.sec mustbeaninteger.

IPSCREATEPACKAGETIME'start_time'TO'end_time'

Thiscreatesapackageandincludesdiagnosticinformationforallincidentsthatoccurredwithinthespecifiedtimerange.start_time andend_timemustbeintheformat'YYYYMMDDHH24:MI:SS.FFTZR '.ThisisavalidformatstringfortheNLS_TIMESTAMP_TZ_FORMAT initializationparameter.Thefraction(FF )portionofthetimeisoptional,andtheHH24:MI:SSdelimiterscanbecolonsorperiods.

Forexample,thefollowingcommandcreatesapackagewithincidentsthatoccurredbetweenJuly24thandJuly30thof2007:

IPSCREATEPACKAGETIME'2007072400:00:0007:00'to'2007073023.59.5907:00'

SeeAlso:"IPSCREATEPACKAGE"

()

AddingDiagnosticInformationtoaLogicalIncidentPackageYoucanaddthefollowingdiagnosticinformationtoanexistinglogicalpackage(package):

Alldiagnosticinformationforaparticularincident

AnamedfilewithintheADR

Toaddanincidenttoanexistingpackage:




IPSADDINCIDENTincident_numberPACKAGEpackage_number

ToaddafileintheADRtoanexistingpackage:

AttheADRCIprompt,enterthefollowingcommand:

IPSADDFILEfilespecPACKAGEpackage_number

filespec mustbeafullyqualifiedfilename(withpath).OnlyfilesthatarewithintheADRbasedirectoryhierarchymaybeadded.

SeeAlso:"ADRCICommandReference"

()

GeneratingaPhysicalIncidentPackageWhenyougenerateapackage,youcreateaphysicalpackage(azipfile)foranexistinglogicalpackage.

Togenerateaphysicalincidentpackage:




IPSGENERATEPACKAGEpackage_numberINpath

Thisgeneratesacompletephysicalpackage(zipfile)inthedesignatedpath.Forexample,thefollowingcommandcreatesacompletephysicalpackageinthedirectory/home/steve/diagnosticsfromlogicalpackagenumber2:

IPSGENERATEPACKAGE2IN/home/steve/diagnostics

Youcanalsogenerateanincrementalpackagecontainingonlytheincidentsthathaveoccurredsincethelastpackagegeneration.

Togenerateanincrementalphysicalincidentpackage:

AttheADRCIprompt,enterthefollowingcommand:

IPSGENERATEPACKAGEpackage_numberINpathINCREMENTAL

SeeAlso:

"ADRCICommandReference"

"AboutPackagingIncidents"

()

ADRCICommandReferenceTherearefourcommandtypesinADRCI:

CommandsthatworkwithoneormorecurrentADRhomes

CommandsthatworkwithonlyonecurrentADRhome,andthatissueanerrormessageifthereismorethanonecurrentADRhome

CommandsthatpromptyoutoselectanADRhomewhentherearemultiplecurrentADRhomes

CommandsthatdonotneedacurrentADRhome

AllADRCIcommandssupportthecasewherethereisasinglecurrentADRhome.

Table152liststhesetofADRCIcommands.

()()Table152ListofADRCIcommands

Command Description

CREATEREPORT CreatesareportforthespecifiedreporttypeandID.

ECHO Echoestheinputstring.

EXIT ExitsthecurrentADRCIsession.

HOST ExecutesoperatingsystemcommandsfromADRCI.

IPS InvokestheIPSutility.SeeTable153fortheIPScommandsavailablewithinADRCI.

QUIT ExitsthecurrentADRCIsession.

RUN RunsanADRCIscript.

SETBASE

SetstheADRbaseforthecurrentADRCIsession.

SETBROWSER Reservedforfutureuse.

SETCONTROL SetpurgingpoliciesforADRcontents.

SETECHO Togglescommandoutput.

SETEDITOR Setsthedefaulteditorfordisplayingtraceandalertlogcontents.

SETHOMEPATH MakescurrentoneormoreADRhomes.

SETTERMOUT Togglesterminaloutput.

SHOWALERT Showsalertlogmessages.

SHOWBASE ShowsthecurrentADRbase.

SHOWCONTROL ShowsADRinformation,includingthecurrentpurgingpolicy.

SHOWHM_RUN ShowsHealthMonitorruninformation.

SHOWHOMEPATH Showsthecurrenthomepath.

SHOWHOMES

ListsthecurrentADRhomes.

SHOWINCDIR Liststhetracefilescreatedforthespecifiedincidents.

SHOWINCIDENT Outputsalistofincidents.

SHOWPROBLEM Outputsalistofproblems.

SHOWREPORT ShowsareportforthespecifiedreporttypeandID.

SHOWTRACEFILE Listsqualifiedtracefilenames.

SPOOL Directsoutputtoafile.

Note:Unlessotherwisespecified,thecommandslistedbelowworkwithmultiplecurrentADRhomes.

()

CREATEREPORT

()Purpose

CreatesareportforthespecifiedreporttypeandrunIDandstoresthereportintheADR.Currently,onlythehm_run (HealthMonitor)reporttypeissupported.

Note:ResultsofHealthMonitorrunsarestoredintheADRinaninternalformat.Toviewtheseresults,youmustcreateaHealthMonitor

reportfromthemandthenviewthereport.Youneedcreatethereportonlyonce.Youcanthenviewitmultipletimes.

()SyntaxandDescription

createreport report_type run_name

report_type mustbehm_run .run_name isaHealthMonitorrunname.ObtainrunnameswiththeSHOWHM_RUNcommand.

Ifthereportalreadyexistsitisoverwritten.UsetheSHOWREPORTcommandtoviewthereport.

()Example

ThisexamplecreatesareportfortheHealthMonitorrunwithrunnamehm_run_1421 :

createreporthm_runhm_run_1421

Note:CREATE REPORT doesnotworkwhenmultipleADRhomesareset.ForinformationonsettingasingleADRhome,see"SettingtheADRCIHomepathBeforeUsingADRCICommands"

()

ECHO

()Purpose

Printstheinputstring.YoucanusethiscommandtoprintcustomtextfromADRCIscripts.


echo quoted_string

Thestringmustbeenclosedinsingleordoublequotes.

ThiscommanddoesnotrequireanADRhometobesetbeforeyoucanuseit.

()Example

Theseexamplesprintthestring"Hello,world!":

echo"Hello,world!"

echo'Hello,world!'

()

EXIT

()Purpose

ExitstheADRCIutility.


exit

EXIT isasynonymfortheQUIT command.


()

HOST

()Purpose

ExecuteoperatingsystemcommandswithoutleavingADRCI.


host[" host_command_string "]

Usehost byitselftoenteranoperatingsystemshell,whichallowsyoutoentermultipleoperatingsystemcommands.EnterEXIT toleavetheshellandreturntoADRCI.

Youcanalsospecifythecommandonthesameline(host_command_string )enclosedindoublequotes.


()Examples

host

host"lsl*.pl"

()

IPS

()Purpose

InvokestheIncidentPackagingService(IPS)commandset.TheIPScommandprovidesoptionsforcreatinglogicalincidentpackages(packages),addingdiagnosticdatatopackages,andgeneratingphysicalpackagesfortransmissiontoOracleSupport.

SeeAlso:"PackagingIncidents"formoreinformationonpackaging.

TheIPScommandsetcontainsthefollowingcommands:

()()Table153IPSCommandSet

Command Description

IPSADD Addsanincident,problem,orproblemkeytoapackage.

IPSADDFILE Addsafiletoapackage.

IPSADDNEWINCIDENTS Findsandaddsnewincidentsfortheproblemsinthespecifiedpackage.

IPSCOPYINFILE CopiesfilesintotheADRfromtheexternalfilesystem.

IPSCOPYOUTFILE CopiesfilesoutoftheADRtotheexternalfilesystem.

IPSCREATEPACKAGE Createsanew(logical)package.

IPSDELETEPACKAGE DeletesapackageanditscontentsfromtheADR.

IPSFINALIZE Finalizesapackagebeforeuploading.

IPSGENERATEPACKAGE GeneratesaZIPfileofthespecifiedpackagecontentsinthetargetdirectory.

IPSGETMANIFEST RetrievesanddisplaysthemanifestfromapackageZIPfile.

IPSGETMETADATA ExtractsmetadatafromapackageZIPfileanddisplaysit.

IPSPACK Createsaphysicalpackage(ZIPfile)directlyfromincidents,problems,orproblemkeys.

IPSREMOVE Removesincidentsfromanexistingpackage.

IPSREMOVEFILE Removeafilefromanexistingpackage.

IPSSETCONFIGURATION ChangesthevalueofanIPSconfigurationparameter.

IPSSHOWCONFIGURATION DisplaysthevaluesofIPSconfigurationparameters.

IPSSHOWFILES Liststhefilesinapackage.

IPSSHOWINCIDENTS Liststheincidentsinapackage.

IPSUNPACKFILE UnpackagesapackageZIPfileintoaspecifiedpath.

Note:IPScommandsdonotworkwhenmultipleADRhomesareset.ForinformationonsettingasingleADRhome,see"SettingtheADRCIHomepathBeforeUsingADRCICommands"

()

UsingtheandVariablesinIPSCommandsTheIPScommandsetprovidesshortcutsforreferencingthecurrentADRhomeandADRbasedirectories.ToaccessthecurrentADRhomedirectory,usethe variableasfollows:

ipsaddfile/trace/orcl_ora_13579.trcpackage12

Usethe variabletoaccesstheADRbasedirectoryasfollows:

ipsaddfile/diag/rdbms/orcl/orcl/trace/orcl_ora_13579.trcpackage12

()

IPSADD

()Purpose

Addsincidentstoapackage.


ipsadd {incident inc_id |problem prob_id |problemkeypr_key |seconds secs |time start_time to end_time }package pkg_id

Table154describestheargumentsofIPSADD.

()()Table154ArgumentsofIPSADDcommand

Argument Description

incident inc_id AddsanincidentwithIDinc_id tothepackage

problem prob_id AddsincidentswithproblemIDprob_id tothepackage.Addsonlythefirstthreeearlyincidentsandlastthreelateincidentsfortheproblem,excludinganyolderthan90days.(Note:Theselimitsaredefaultsandcanbechanged.See"IPSSETCONFIGURATION".)

problemkey pr_key Addsincidentswithproblemkeypr_key tothepackage.Addsonlythefirstthreeearlyincidentsandlastthreelateincidentsfortheproblemkey,excludinganyolderthan90days.(Note:Theselimitsaredefaultsandcanbechanged.)

seconds secs Addsallincidentsthathaveoccurredwithinsecs secondsofthepresenttime

time start_time toend_time

Addsallincidentsbetweenstart_time andend_time tothepackage.Timeformatis'YYYYMMYYHH24:MI:SS.FFTZR '.Fractionalpart(FF )isoptional.

package pkg_id Specifiesthepackagetowhichtoaddincidents.

()Example

Thisexampleaddsincident22topackage12:

ipsaddincident22package12

ThisexampleaddsthefirstthreeearlyincidentsandthelastthreelateincidentswithproblemID6topackage2,exudinganyincidentsolderthan90days:

ipsaddproblem6package2

Thisexampleaddsallincidentstakingplaceduringthelastminutetopackage5:

ipsaddseconds60package5

Thisexampleaddsallincidentstakingplacebetween10:00a.m.and11:00p.m.onMay1,2007:

ipsaddtime'2007050110:00:00.0007:00'to'2007050123:00:00.0007:00'

()

IPSADDFILE

()Purpose

Addsafiletoanexistingpackage.


ips add file file_name package pkg_id

file_name isthefullpathnameofthefile.Youcanusetheand variablesifdesired.ThefilemustbeunderthesameADRbaseasthepackage.

pkg_id isthepackageID.

()Example

Thisexampleaddsatracefiletopackage12:

ipsaddfile/trace/orcl_ora_13579.trcpackage12

SeeAlso:See"UsingtheandVariablesinIPS

Commands"forinformationonthe directorysyntax

()

IPSADDNEWINCIDENTS

()Purpose

Findandaddnewincidentsforalloftheproblemsinthespecifiedpackage.


ips add new incidentspackage package_id

package_id isthepackagetoupdate.Onlynewincidentsoftheproblemsinthepackageareadded.

()Example

Thisexampleaddsuptothreeofthenewlateincidentsfortheproblemsinpackage12:

ipsaddnewincidentspackage12

Note:Thenumberoflateincidentsaddedisadefaultthatcanbechanged.See"IPSSETCONFIGURATION"

()

IPSCOPYINFILE

()Purpose

CopiesafileintotheADRfromtheexternalfilesystem.

Toeditafileinapackage,youmustcopythefileouttoadesignateddirectory,editthefile,andcopyitbackintothepackage.YoumaywanttodothistodeletesensitivedatainthefilebeforesendingthepackagetoOracleSupport.


ips copy in file filename [to new_name ][overwrite] packagepkgid [incident incid ]

Copiesanexternalfile,filename (specifiedwithfullpathname)intotheADR,associatingitwithanexistingpackage,pkgid ,andoptionallyanincident,incid .Usetheto new_name optiontogivethecopiedfileanewfilenamewithintheADR.Usetheoverwrite optiontooverwriteafilethatexistsalready.

()Example

ThisexamplecopiesatracefilefromthefilesystemintotheADR,associatingitwithpackage2andincident4:

ipscopyinfile/home/nick/trace/orcl_ora_13579.trcto/trace/orcl_ora_13579.trcpackage2incident4

SeeAlso:

"UsingtheandVariablesinIPSCommands"forinformationonthe variable

"IPSSHOWFILES"forinformationonlistingfilesinapackage

()

IPSCOPYOUTFILE

()Purpose

CopiesafilefromtheADRtotheexternalfilesystem.

Toeditafileinapackage,youmustcopythefileouttoadesignateddirectory,editthefile,andcopyitbackintothepackage.YoumaywanttodothistodeletesensitivedatainthefilebeforesendingthepackagetoOracleSupport.


ips copy out file source to target [overwrite]

Copiesafile,source ,toalocationoutsidetheADR,target (specifiedwithfullpathname).Usetheoverwrite optiontooverwritethefilethatexistsalready.

()Example

ThisexamplecopiesafileintheADRhomecalled/trace/ora_26201 toalocalfolder.

ipscopyoutfile/trace/orcl_ora_13579.trcto/home/nick/trace/orcl_ora_13579.trc

SeeAlso:

"UsingtheandVariablesinIPSCommands"forinformationonthe directorysyntax

"IPSSHOWFILES"forinformationonlistingfilesinapackage

()

IPSCREATEPACKAGE

()Purpose

Createsanewpackage.ADRCIautomaticallyassignsthepackagenumberforthenewpackage.


ips create package {incident inc_id | problem prob_id |problemkey prob_key | seconds secs | time start_time toend_time }[correlate basic | typical | all ]

Optionally,youcanaddincidentstothenewpackageusingtheprovidedoptions.

Table155describestheargumentsforIPS CREATE PACKAGE .

()()Table155ArgumentsofIPSCREATEcommand


incident inc_id AddsanincidentwithIDinc_id tothepackage

problem prob_id AddsallincidentswithproblemIDprob_id tothepackage.Addsonlythefirstthreeearlyincidentsandlastthreelateincidentsfortheproblem,excludinganyolderthan90days.

(Note:Theselimitsaredefaultsandcanbechanged.See"IPSSETCONFIGURATION".)

problemkey pr_key Addsallincidentswithproblemkeypr_key tothepackage.Addsonlythefirstthreeearlyincidentsandlastthreelateincidentsfortheproblemkey,excludinganyolderthan90days.(Note:Theselimitsaredefaultsandcanbechanged.)



Addsallincidentstakingplacebetweenstart_time andend_time tothepackage.Timeformatis'YYYYMMYYHH24:MI:SS.FFTZR '.Fractionalpart(FF )isoptional.

correlate[ basic

| typical | all ]Selectsamethodofincludingcorrelatedincidentsinthepackage.Therearethreeoptionsforthisargument:

correlate basic includesincidentdumpsandincidentprocesstracefiles.

correlate typical includesincidentdumpsandanytracefilesthatweremodifiedwithinfiveminutesofeachincident.YoucanalterthetimeintervalbymodifyingtheINCIDENT_TIME_WINDOWconfigurationparameter.

correlate all includestheincidentdumps,andalltracefilesthatweremodifiedbetweenthetimeofthefirstselectedincidentandthelastselectedincident.

Thedefaultvalueiscorrelatetypical .

package pkg_id AddsincidentstothepackagewithIDpkg_id .

()Examples

Thisexamplecreatesapackagewithnoincidents:

ipscreatepackage

Output:

Createdpackage5withoutanycontents,correlationleveltypical

Thisexamplecreatesapackagecontainingallincidentsbetween10AMand11PMonthegivenday:

ipscreatepackagetime'2007050110:00:00.0007:00'to'2007050123:00:00.0007:00'

Output:

Createdpackage6basedontimerange2007050110:00:00.0007:00to2007050123:00:00.0007:00,correlationleveltypical

ThisexamplecreatesapackageandaddsthefirstthreeearlyincidentsandthelastthreelateincidentswithproblemID3,excludingincidentsthatareolderthan90days:

ipscreatepackageproblem3

Output:

Createdpackage7basedonproblemid3,correlationleveltypical

Note:Thenumberofearlyandlateincidentsadded,andthe90dayagelimitaredefaultsthatcanbechanged.See"IPSSETCONFIGURATION".

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:OracleDatabaseAdministrator'sGuide(../../server.111/b28310/diag010.htm#ADMIN12304)formoreinformationonfinalizingpackages

()

IPSGENERATEPACKAGE

()Purpose

Createsaphysicalpackage(aZIPfile)intargetdirectory.


ips generate package package_id [in path ] [complete |incremental]

package_id istheIDofthepackagetogenerate.Optionally,youcansavethefileinthedirectorypath .Otherwise,thepackageisgeneratedinthecurrentworkingdirectory.

Thecomplete optionmeansthepackageforcesADRCItoincludeallpackagefiles.Thisisthedefaultbehavior.

Theincremental optionincludesonlyfilesthathavebeenaddedorchangedsincethelasttimethatthispackagewasgenerated.Withtheincremental option,thecommandfinishesmorequickly.

()Example

Thisexamplegeneratesaphysicalpackagefileinpath/home/steve :

ipsgeneratepackage12in/home/steve

Thisexamplegeneratesaphysicalpackagefromfilesaddedorchangedsincethelastgeneration:

ipsgeneratepackage14incremental

SeeAlso:"GeneratingaPhysicalIncidentPackage"

()

IPSGETMANIFEST

()Purpose

ExtractsthemanifestfromapackageZIPfileanddisplaysit.


ips get manifest from file filename

filename isapackageZIPfile.ThemanifestisanXMLformattedsetofmetadataforthepackagefile,includinginformationonADRconfiguration,correlatedfiles,incidents,andhowthepackagewasgenerated.


()Example

ipsgetmanifestfromfile/home/steve/ORA603_20060906165316_COM_1.zip

()

IPSGETMETADATA

()Purpose

ExtractsADRrelatedmetadatafromapackagefileanddisplaysit.


ips get metadata {from file filename | from adr }

filename isapackageZIPfile.Themetadatainapackagefile(storedinthefilemetadata.xml )containsinformationabouttheADRhome,ADRbase,andproduct.

Usethefrom adr optiontogetthemetadatafromapackageZIPfilethathasbeenunpackedintoanADRhomeusingIPS UNPACK .

Thefrom adr optionrequiresanADRhometobeset.

()Example

Thisexampledisplaysmetadatafromapackagefile:

ipsgetmetadatafromfile/home/steve/ORA603_20060906165316_COM_1.zip

Thisnextexampledisplaysmetadatafromapackagefilethatwasunpackedintothedirectory/scratch/oracle/package1:

setbase/scratch/oracle/package1

ipsgetmetadatafromadr

Inthispreviousexample,uponreceivingtheSET BASE command,ADRCIautomaticallyaddstothehomepaththeADRhomethatwascreatedin/scratch/oracle/package1bytheIPS UNPACK FILE command.

SeeAlso:"IPSUNPACKFILE"formoreinformationonunpackingpackagefiles

()

IPSPACK

()Purpose

Createsapackageandgeneratesthephysicalpackageimmediately.


ips pack [incident inc_id | problem prob_id | problemkeyprob_key | seconds secs | time start_time toend_time ][correlate {basic | typical | all} ] [inpath ]

ADRCIautomaticallygeneratesthepackagenumberforthenewpackage.IPSPACKcreatesanemptypackageifnopackagecontentsarespecified.

Table156describestheargumentsforIPS PACK .

()()Table156ArgumentsofIPSPACKcommand


incident inc_id AddsincidentwithIDinc_id tothepackage

problem prob_id AddsincidentswithproblemIDprob_id tothepackage.Addsonlythefirstthreeearlyincidentsandlastthreelateincidentsfortheproblem,excludinganyolderthan90days.(Note:Theselimitsaredefaultsandcanbechanged.See"IPSSETCONFIGURATION".)

problemkey pr_key

TableofContents(toc.htm)OracleDatabase(toc.htm)

Preface(preface.htm)What'sNewinDatabaseUtilities?(whatsnew.htm#SUTIL000)

OverviewofOracleDataPump(dp_overview.htm#g1015896)

DataPumpExport(dp_export.htm#g1022624)DataPumpImport(dp_import.htm#g1025464)DataPumpPerformance(dp_perf.htm#g1008057)TheDataPumpAPI(dp_api.htm#g1011860)SQL*LoaderConcepts(ldr_concepts.htm#g1013706)SQL*LoaderCommandLineReference(ldr_params.htm#g1014550)

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(et_dp_driver.htm#g1017944)

ADRCI:ADRCommandInterpreter(adrci.htm#BABBHGFC)

DBVERIFY:OfflineDatabaseVerificationUtility(dbverify.htm#g1010035)

DBNEWIDUtility(dbnewid.htm#g1010179)UsingLogMinertoAnalyzeRedoLogFiles(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)

Addsincidentswithproblemkeypr_key tothepackage.Addsonlythefirstthreeearlyincidentsandlastthreelateincidentsfortheproblemkey,excludinganyolderthan90days.(Note:Theselimitsaredefaultsandcanbechanged.)



Addsallincidentstakingplacebetweenstart_time andend_time tothepackage.Timeformatis'YYYYMMYYHH24:MI:SS.FFTZR '.Fractionalpart(FF )isoptional.

correlate[ basic

| typical | all ]Selectsamethodofincludingcorrelatedincidentsinthepackage.Therearethreeoptionsforthisargument:

correlate basic includesincidentdumpsandincidentprocesstracefiles.

correlate typical includesincidentdumpsandanytracefilesthatweremodifiedwithinfiveminutesofeachincident.YoucanalterthetimeintervalbymodifyingtheINCIDENT_TIME_WINDOWconfigurationparameter.

correlate all includestheincidentdumps,andalltracefilesthatweremodifiedbetweenthetimeofthefirstselectedincidentandthelastselectedincident.

Thedefaultvalueiscorrelatetypical .

[in path ]

CategoriesHome(../../index.htm)BookList(../../nav/portal_booklist.htm)DataDictionary(../../nav/catalog_views.htm)SQLKeywords(../../nav/sql_keywords.htm)Acronyms(../../nav/acronym_list.htm)

DownloadSavesthephysicalpackagetodirectorypath .

()Example

Thisexamplecreatesanemptypackage:

ipspack

Thisexamplecreatesaphysicalpackagecontainingallinformationforincident861:

ipspackincident861

Thisexamplecreatesaphysicalpackageforallincidentsinthelastminute,fullycorrelated:

ipspackseconds60correlateall

SeeAlso:"IPSSETCONFIGURATION"formoreinformationonsettingconfigurationparameters.

()

IPSREMOVE

()Purpose

Removesincidentsfromanexistingpackage.


ips remove {incident inc_id | problem prob_id | problemkeyprob_key } package pkg_id

Afterremovingincidentsfromapackage,theincidentscontinuetobetrackedwithinthepackagemetadatatopreventADRCIfromautomaticallyincludingthemlater(suchaswithADDNEWINCIDENTS).

Table157describestheargumentsofIPSREMOVE.

()()Table157ArgumentsofIPSREMOVEcommand


incident inc_id RemovestheincidentwithIDinc_id fromthepackage

problem prob_id RemovesallincidentswithproblemIDprob_id fromthepackage

problemkey pr_key Removesallincidentswithproblemkeypr_key fromthepackage

package pkg_id RemovesincidentsfromthepackagewithIDpkg_id .

()Example

Thisexampleremovesincident22frompackage12:

ipsremoveincident22package12

SeeAlso:"IPSGETMANIFEST"forinformationonpackagemetadata.

()

IPSREMOVEFILE

()Purpose

Removesafilefromanexistingpackage.


ips remove file file_name package pkg_id

file_name isthefiletoremovefrompackagepkg_id .Thecompletepathofthefilemustbespecified.(Youcanusethe and variablesifdesired.)

Afterremoval,thefilecontinuestobetrackedwithinthepackagemetadatatopreventADRCIfromautomaticallyincludingitlater(suchaswithADD NEWINCIDENTS ).Removingafile,therefore,onlysetstheEXCLUDE flagforthefileto1.

()Example

Thisexampleremovesatracefilefrompackage12:

ipsremovefile/trace/orcl_ora_13579.trcpackage12

Removedfile/trace/orcl_ora_13579.trcfrompackage12

ipsshowfilespackage12

.

.

.

**********************************************************

FILERECORD

**********************************************************

FILEINFORMATION:

FILE_LOCATION/trace

FILE_NAMEorcl_ora_13579.trc

LAST_SEQUENCE0

EXCLUDE1

.

.

.

SeeAlso:

"IPSGETMANIFEST"forinformationonpackagemetadata.

"UsingtheandVariablesinIPSCommands"forinformationonthe directorysyntax

"IPSSHOWFILES"

()

IPSSETCONFIGURATION

()Purpose

ChangesthevalueofanIPSconfigurationparameter.


ips set configuration parameter_id value

parameter_id istheparameterIDtochange,andvalue isthenewvalue.ForalistoftheconfigurationparametersandtheirIDs,use"IPSSHOWCONFIGURATION".

()Example

ipssetconfiguration310

()

IPSSHOWCONFIGURATION

()Purpose

DisplaysalistofIPSconfigurationparametersandtheirvalues.TheseparameterscontrolvariousthresholdsforIPSdata,suchastimeoutsandincidentinclusionintervals.


ips show configuration [ parameter_id ]

IPSSHOWCONFIGURATIONliststhefollowinginformationforeachconfigurationparameter:

ParameterID

Name

Description

Unitusedbyparameter(suchasdaysorhours)

Value

Defaultvalue

Optionally,youcangetinformationaboutaspecificparameterbysupplyingaparameter_id .

()Example

ThiscommanddescribesallIPSconfigurationparameters:

ipsshowconfiguration

Output:

IPSCONFIGURATIONPARAMETER

**********************************************************

PARAMETERINFORMATION:

PARAMETER_ID1

NAMECUTOFF_TIME

DESCRIPTIONMaximumageforanincidenttobeconsideredforinclusion

UNITDays

VALUE90

DEFAULT_VALUE90

**********************************************************


**********************************************************


PARAMETER_ID2

NAMENUM_EARLY_INCIDENTS

DESCRIPTIONHowmanyincidentstogetintheearlypartoftherange

UNITNumber

VALUE3

DEFAULT_VALUE3

**********************************************************


**********************************************************


PARAMETER_ID3

NAMENUM_LATE_INCIDENTS

DESCRIPTIONHowmanyincidentstogetinthelatepartoftherange

UNITNumber

VALUE3

DEFAULT_VALUE3

**********************************************************


**********************************************************


PARAMETER_ID4

NAMEINCIDENT_TIME_WINDOW

DESCRIPTIONIncidentsthisclosetoeachotherareconsideredcorrelated

UNITMinutes

VALUE5

DEFAULT_VALUE5

**********************************************************


**********************************************************


PARAMETER_ID5

NAMEPACKAGE_TIME_WINDOW

DESCRIPTIONTimewindowforcontentinclusionisfromxhoursbeforefirstincludedincidenttoxhoursafterlastincident

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 1 Maximumage,indays,foranincidenttobeconsideredforinclusion

NUM_EARLY_INCIDENTS 2 Numberofincidentstoincludeintheearlypartoftherangewhencreatingapackagebasedonaproblem.Bydefault,ADRCIaddsthethreeearliestincidentsandthreemostrecentincidentstothepackage.

NUM_LATE_INCIDENTS 3 Numberofincidentstoincludeinthelatepartoftherangewhencreatingapackagebasedonaproblem.Bydefault,ADRCIaddsthethreeearliestincidentsandthreemostrecentincidentstothepackage.

INCIDENT_TIME_WINDOW 4 Numberofminutesbetweentwoincidentsinorderforthemtobeconsideredcorrelated.

PACKAGE_TIME_WINDOW 5 Numberofhourstouseasatimewindowforincludingincidentsinapackage.Forexample,avalueof5includesincidentsfivehoursbeforetheearliestincidentinthepackage,andfivehoursafterthemostrecentincidentinthepackage.

DEFAULT_CORRELATION_LEVEL 6 Thedefaultcorrelationleveltouseforcorrelatingincidentsinapackage.Thecorrelationlevelsare:

1("basic"correlation):includesincidentdumpsandincidentprocesstracefiles.

2("typical"correlation):includesincidentdumpsandanytracefilesthatweremodifiedwithinthetimewindowspecifiedbyINCIDENT_TIME_WINDOW

(seeabove).

4("all"):includestheincidentdumps,andalltracefilesthatweremodifiedbetweenthefirstselectedincidentandthelastselectedincident.Additionalincidentscanbeincludedautomaticallyiftheyoccurredinthesametimerange.

SeeAlso:"IPSSETCONFIGURATION"

()

IPSSHOWFILES

()Purpose

Listsfilesincludedinthespecifiedpackage.


ips show files package pkg_id

pkg_id isthepackageIDtodisplay.

()Example

Thisexampleshowsallfilesassociatedwithpackage3:

ipsshowfilespackage3

Output:

**********************************************************

FILERECORD

**********************************************************

FILEINFORMATION:

FILE_LOCATION/incident/incdir_4!/nick/oracle/log/diag/rdbms/

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,youcanunpackthefileintodirectorypath ,whichmustexistandbewritable.Ifyouomitthepath,thecurrentworkingdirectoryisused.ThedestinationdirectoryistreatedasanADRbase,andtheentireADRbasedirectoryhierarchyiscreated,includingavalidADRhome.


()Example

ipsunpackfile/tmp/ORA603_20060906165316_COM_1.zipinto/tmp/newadr

()

PURGE

()Purpose

PurgesdiagnosticdatainthecurrentADRhome,accordingtocurrentpurgingpolicies.OnlyADRcontentsthatareduetobepurgedarepurged.

DiagnosticdataintheADRhasadefaultlifecycle.Forexample,informationaboutincidentsandproblemsissubjecttopurgingafteroneyear,whereastheassociateddumpfiles(dumps)aresubjecttopurgingafteronly30days.

SomeOracleproducts,suchOracleDatabase,automaticallypurgediagnosticdataattheendofitslifecycle.Otherproductsandcomponentsrequireyoutopurgediagnosticdatamanuallywiththiscommand.Youcanalsousethiscommandtopurgedatathatisduetobeautomaticallypurged.

TheSHOWCONTROLcommanddisplaysthedefaultpurgingpoliciesforshortlivedADRcontentsandlonglivedADRcontents.


purge [[i { id |start_id end_id }] | [age mins [type{ALERT | INCIDENT | TRACE | CDUMP|HM }]] ]

Table159describestheflagsforPURGE .

()()Table159FlagsforthePURGEcommand

Flag Description

[[i { id1 |start_id end_id }] PurgeseitheraspecificincidentID(id )orarangeofincidentIDs(start_id andend_id )

[age mins ] Purgesonlydataolderthanminsminutes.

[type

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

Specifiesthetypeofdiagnosticdatatopurge(alertlogmessages,incidentdata,tracefiles(includingdumps),corefiles,orHealthMonitorrundataandreports).

()Examples

ThisexamplepurgesalldiagnosticdatainthecurrentADRhomebasedonthedefaultpurgingpolicies:

purge

Thisexamplepurgesalldiagnosticdataforallincidentsbetween123and456:

purgei123456

Thisexamplepurgesallincidentdatafromthelasthour:

purgeage60typeincident

Note:PURGE doesnotworkwhenmultipleADRhomesareset.ForinformationonsettingasingleADRhome,see"SettingtheADRCIHomepathBeforeUsingADRCICommands"

()

QUITSee"EXIT"

()

RUN

()Purpose

RunsanADRCIscript.


run script_name

@ script_name

@@ script_name

script_name isthefilecontainingtheADRCIcommandstoexecute.ADRCIlooksforthescriptinthecurrentdirectoryunlessafullpathnameissupplied.Ifthefilenameisgivenwithoutafileextension,ADRCIusesthedefaultextension".adi".

Therun and@ commandsaresynonyms.The@@ commandissimilartorunand@ exceptthatwhenusedinsideascript,@@ usesthepathofthecallingscripttolocatescript_name ,ratherthanthecurrentdirectory.


()Example

runmy_script

@my_script

()

SETBASE

()Purpose

SetstheADRbasetouseinthecurrentADRCIsession.


setbasebase_str

base_str isafullpathtoadirectory.Theformatforbase_str dependsontheoperatingsystem.IftherearevalidADRhomesunderthebasedirectory,thesehomesareaddedtothehomepathofthecurrentADRCIsession.


()Example

setbase/net/sttttd1/scratch/steve/view_storage/steve_v1/log

SeeAlso:"ADRBase"

()

SETBROWSER

()Purpose

Setsthedefaultbrowserfordisplayingreports.

Note:Thiscommandisreservedforfutureuse.AtthistimeADRCIdoesnotsupportHTMLformattedreportsinabrowser.


setbrowser browser_program

browser_program isthebrowserprogramname(itisassumedthebrowsercanbestartedfromthecurrentADRworkingdirectory).Ifnobrowserisset,ADRCIwilldisplayreportstotheterminalorspoolfile.


()Example

setbrowsermozilla

SeeAlso:

"SHOWREPORT"formoreinformationonshowingreports

"SPOOL"formoreinformationonspooling

()

SETCONTROL

()Purpose

SetspurgingpoliciesforADRcontents.


set control (purge_policy =value ,... )

purge_policy iseitherSHORTP_POLICY orLONGP_POLICY .See"SHOWCONTROL"formoreinformation.

value isthenumberofhoursafterwhichtheADRcontentsbecomeeligibleforpurging.

ThiscommandworkswithasingleADRhomeonly.

()Example

setcontrol(SHORTP_POLICY=360)

()

SETECHO

()Purpose

Turnscommandoutputonoroff.Thiscommandonlyaffectsoutputbeingdisplayedinascriptorusingthespoolmode.


set echo on|off


()Example

setechooff

SeeAlso:"SPOOL"formoreinformationonspooling

()

SETEDITOR

()Purpose

Setstheeditorfordisplayingthealertlogandthecontentsoftracefiles.


set editor editor_program

editor_program istheeditorprogramname.Ifnoeditorisset,ADRCIusestheeditorspecifiedbytheoperatingsystemenvironmentvariable$EDITOR .If$EDITOR isnotset,ADRCIusesvi asthedefaulteditor.


()Example

seteditorxemacs

SeeAlso:"SHOWREPORT"

()

SETHOMEPATH

()Purpose

MakesoneormoreADRhomescurrent.ManyADRcommandsworkwiththecurrentADRhomesonly.


set homepath homepath_str1 homepath_str2 ...

Thehomepath_str n stringsarethepathsoftheADRhomesrelativetothecurrentADRbase.The"diag"inthedirectorynamecanbeomitted.IfthespecifiedpathcontainsmultipleADRhomes,allofthehomesareaddedtothehomepath.

IfadesirednewADRhomeisnotwithinthecurrentADRbase,useSETBASE tosetanewADRbaseandthenuseSET HOMEPATH .


()Example

sethomepathdiag/rdbms/aime3/aime3diag/rdbms/aime3/aime32

SeeAlso:"Homepath"

()

SETTERMOUT

()Purpose

Turnsoutputtotheterminalonoroff.


set termout on|off

Thissettingisindependentofspooling.Thatis,theoutputcanbedirectedtobothterminalandafileatthesametime.


SeeAlso:

"SPOOL"formoreinformationonspooling.

()Example

settermouton

()

SHOWALERT

()Purpose

Showsthecontentsofthealertloginthedefaulteditor.


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

[file alert_file_name ]

Exceptwhenusingtheterm flag,thiscommandworkswithonlyasinglecurrentADRhome.IfmorethanoneADRhomeisset,ADRCIpromptsyoutochoosetheADRhometouse.

()()Table1510FlagsfortheSHOWALERTcommand

Flag Description

p

predicate_string

UsesaSQLlikepredicatestringtoshowonlythealertlogentriesforwhichthepredicateistrue.Thepredicatestringmustbeenclosedindoublequotes.

Table1511liststhefieldsthatcanbeusedinthepredicatestring.

tail[ num ]

[f]

Displaysthemostrecententriesinthealertlog.

Usethenum optiontodisplaythelastnumentriesinthealertlog.Ifnumisomitted,thelast10entriesaredisplayed.

Ifthef optionisgiven,afterdisplayingtherequestedmessages,thecommanddoesnotreturn.Instead,itremainsactiveandcontinuouslydisplaysnewalertlogentriestotheterminalas

theyarriveinthealertlog.Youcanusethiscommandtoperformlivemonitoringofthealertlog.Toterminatethecommand,pressCTRLC.

term Directsresultstotheterminal.OutputstheentirealertlogsfromallcurrentADRhomes,oneafteranother.Ifthisoptionisnotgiven,theresultsaredisplayedinthedefaulteditor.

file

alert_file_name

EnablesyoutospecifyanalertfileoutsidetheADR.alert_file_name mustbespecifiedwithafullpathname.Notethatthisoptioncannotbeusedwiththetail option.

()()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

ThisexampleshowsallalertmessagesforthecurrentADRhomeinthedefaulteditor:

showalert

ThisexampleshowsallalertmessagesforthecurrentADRhomeanddirectstheoutputtotheterminalinsteadofthedefaulteditor:

showalertterm

ThisexampleshowsallalertmessagesforthecurrentADRhomewithmessagetextdescribinganincident:

showalertp"message_textlike'%incident%'"

Thisexampleshowsthelasttwentyalertmessages,andthenkeepsthealertlogopen,displayingnewalertlogentriesastheyarrive:

showalerttail20f

ThisexampleshowsallalertmessagesforasingleADRhomeinthedefaulteditorwhenmultipleADRhomeshavebeenset:

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'sADRbaselocationforaspecificproduct.Theproductscurrentlysupportedare"CLIENT"and"ADRCI".


()Example

ThisexampleshowsthecurrentADRbase:

showbase

Output:

ADRbaseis"/scratch/nick/rdbms/log"

ThisexampleshowsthecurrentADRbaseforOracleDatabaseclients:

showbaseproductclient

()

SHOWCONTROL

()Purpose

DisplaysinformationabouttheAutomaticDiagnosticRepository(ADR),includingthepurgingpolicy.


showcontrol

DisplaysvariousattributesoftheADR,includingthefollowingpurgingpolicyattributes:

AttributeName Description

SHORTP_POLICY NumberofhoursafterwhichtopurgeADRcontentsthathaveashortlife.Defaultis720(30days).

LONGP_POLICY NumberofhoursafterwhichtopurgeADRcontentsthathavealonglife.Defaultis8760(365days).

()

SHOWHM_RUN

()Purpose

ShowsallinformationforHealthMonitorruns.


showhm_run [ ppredicate_string ]

[ ppredicate_string ] isaSQLlikepredicatespecifyingthefieldnamestoselect.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:OracleDatabaseAdministrator'sGuide(../../server.111/b28310/diag007.htm#ADMIN11270)formoreinformationonHealthMonitor

()

SHOWHOMEPATH

()Purpose

IdenticaltotheSHOW HOMES command.


showhomepath|showhomes|showhome


()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


()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 toid_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.trc







diag/rdbms/emdb/emdb/incident/incdir_3633/emdb_pmon_28970_i3633.trc


diag/rdbms/emdb/emdb/incident/incdir_3713/emdb_smon_28994_i3713.trc





Thisexampleshowsalltracefilesforincident3713

showincdir3713

Output:


*************************************************************************

diag/rdbms/emdb/emdb/incident/incdir_3713/emdb_smon_28994_i3713.trc


Thisexampleshowsalltracefilesforincidentsbetween3801and3804:

showincdir38013804

Output:


*************************************************************************






()

SHOWINCIDENT

()Purpose

ListsalloftheincidentsassociatedwiththecurrentADRhome.Includesbothopenandclosedincidents.


showincident[ p

predicate_string ][mode{ BASIC | BRIEF | DETAIL }]

[orderby field1 , field2 ,...][ ASC |DSC ]

Table1513describestheflagsforSHOW INCIDENT .

()()Table1513FlagsforSHOWINCIDENTcommand

Flag Description

p predicate_string Useapredicatestringtoshowonlytheincidentsforwhichthepredicateistrue.Thepredicatestringmustbeenclosedindoublequotes.


[mode{ BASIC | BRIEF | DETAIL }] Chooseanoutputmodeforincidents.BASIC isthedefault.

BASIC displaysonlybasicincidentinformation(theINCIDENT_ID ,PROBLEM_ID ,andCREATE_TIME

fields).Itdoesnotdisplayfloodcontrolledincidents.

BRIEF displaysallinformationrelatedtotheincidents,asgivenbythefieldsinTable1514.Itincludesfloodcontrolledincidents.

DETAIL displaysallinformationfortheincidents(aswithBRIEF mode)aswellasinformationaboutincidentdumps.Itincludesfloodcontrolledincidents.

[orderby field1 , field2 ,...][ASC | DSC ]

Showresultssortedbyfieldinthegivenorder,aswellasinascending(ASC )anddescendingorder(DSC ).Bydefault,resultsareshowninascendingorder.

()()Table1514IncidentFieldsforSHOWINCIDENT

Field Type

INCIDENT_ID number


PROBLEM_ID number

CREATE_TIME timestamp

CLOSE_TIME timestamp

STATUS number

FLAGS number

FLOOD_CONTROLLED number (decodedtoatextstatusbyADRCI)

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_KEYCREATE_TIME

3808ORA6032007061821:35:49.32216107:00

3807ORA600[4137]2007061821:35:47.86211407:00

3806ORA6032007061821:35:26.66648507:00

3805ORA600[4136]2007061821:35:25.01257907:00

3804ORA15782007061821:35:08.48315607:00

3713ORA600[4136]2007061821:35:44.75444207:00

3633ORA600[4136]2007061821:35:35.77615107:00

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

ERROR_ARG5

ERROR_ARG6

ERROR_ARG7

ERROR_ARG8

SIGNALLING_COMPONENT

SIGNALLING_SUBCOMPONENT

SUSPECT_COMPONENT

SUSPECT_SUBCOMPONENT

ECID

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_3083142848

KEY_NAMESID

KEY_VALUE127.52237

KEY_NAMEProcId

KEY_VALUE23.90

KEY_NAMEPQ

KEY_VALUE(0,1182227717)

OWNER_ID1

INCIDENT_FILE/.../emdb/emdb/incident/incdir_3805/emdb_ora_23716_i3805.trc

OWNER_ID1

INCIDENT_FILE/.../emdb/emdb/trace/emdb_ora_23716.trc

OWNER_ID1

INCIDENT_FILE/.../emdb/emdb/incident/incdir_3805/emdb_m000_23767_i3805_a.trc

1rowsfetched

()

SHOWPROBLEM

()Purpose

ShowprobleminformationforthecurrentADRhome.


show problem [p predicate_string ]

[last num | all]

[orderby field1 , field2 , ...] [ASC|DSC] ]

Table1515describestheflagsforSHOW PROBLEM .

()()Table1515FlagsforSHOWPROBLEMcommand

Flag Description

[p predicate_string ] UseaSQLlikepredicatestringtoshowonlytheincidentsforwhichthepredicateistrue.Thepredicatestringmustbeenclosedindoublequotes.


[last num | all] Showsthelastnumproblems(last ),orlistalltheproblems

(all ).Bydefault,SHOWPROBLEMliststhemostrecent50problems.

[orderby field1 , field2 , ...][ASC | DSC]

Showresultssortedbyfieldinthegivenorder(field1 ,field2 ,...),aswellasinascending(ASC )anddescendingorder(DSC ).Bydefault,resultsareshowninascendingorder.

()()Table1516ProblemFieldsforSHOWPROBLEM

Field Type

PROBLEM_ID number


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,onlythehm_run (HealthMonitor)reporttypeissupported,andonlyinXMLformatting.ToviewHTMLformattedHealthMonitorreports,useEnterpriseManagerortheDBMS_HM PL/SQLpackage.SeeOracleDatabaseAdministrator'sGuide(../../server.111/b28310/diag007.htm#ADMIN11276)formoreinformation.


SHOW REPORT report_type run_name

report_type mustbehm_run .run_name istheHealthMonitorrunnamefromwhichyoucreatedthereport.YoumustfirstcreatethereportusingtheCREATEREPORTcommand.


()Example

showreporthm_runhm_run_1421

SeeAlso:

"CREATEREPORT"

"SHOWHM_RUN"

()

SHOWTRACEFILE

()Purpose

Listtracefiles.


showtracefile[ file1 file2 ...][rt|t]

[i inc1 inc2 ...][path path1 path2 ...]

ThiscommandsearchesforoneormorefilesunderthetracedirectoryandallincidentdirectoriesofthecurrentADRhomes,unlessthei orpathflagsaregiven.

ThiscommanddoesnotrequireanADRhometobesetunlessusingtheioption.

Table1518describestheargumentsofSHOW TRACEFILE .

()()Table1517ArgumentsforSHOWTRACEFILECommand


file1 file2 Filterresultsbyfilename.The%symbolisawildcardcharacter.

()()Table1518FlagsforSHOWTRACEFILECommand

Flag Description

rt | t Orderthetracefilenamesbytimestamp.t sortsthefilenamesin

ascendingorderbytimestamp,andrtsortstheminreverseorder.Notethatfilenamesareonlyorderedrelativetotheirdirectory.Listingmultipledirectoriesoftracefilesappliesaseparateorderingtoeachdirectory.

Timestampsarelistednexttoeachfilenamewhenusingthisoption.

[i inc1 inc2 ...] SelectonlythetracefilesproducedforthegivenincidentIDs.

path path1 path2 Queryonlythetracefilesunderthegivenpathnames.

()Example

ThisexampleshowsallthetracefilesunderthecurrentADRhome:

showtracefile

ThisexampleshowsalltheMMONtracefiles,sortedbytimestampinreverseorder:

showtracefile%mmon%rt

Thisexampleshowsalltracefilesforincidents1and4,underthepath/home/steve/temp :

showtracefilei14path/home/steve/temp

()

SPOOL

()Purpose

DirectsADRCIoutputtoafile.


SPOOL filename [[APPEND]|[OFF]]

filename isthefilenamewheretheoutputistobedirected.Ifafullpathnameisnotgiven,thefileiscreatedinthecurrentADRCIworkingdirectory.Ifnofileextensionisgiven,thedefaultextension".ado"isused.APPEND causestheoutputtobeappendedtotheendofthefile.Otherwise,thefileisoverwritten.UseOFF toturnoffspooling.


()Example

spoolmyfile

spoolmyfile.adoappend

spooloff

spool

()

Troubles()hootingADRCIThefollowingaresomecommonADRCIerrormessages,withtheirpossiblecausesandremedies:

()NoADRbaseisset

Cause:YoumayhavestartedADRCIwithanullorinvalidvaluefortheORACLE_HOME environmentvariable.

Action:ExitADRCI ,settheORACLE_HOME environmentvariable,andrestartADRCI.See"ADRBase"formoreinformation.

()DIA48323:SpecifiedpathnamestringmustbeinsidecurrentADRhome

Cause:AfileoutsideoftheADRhomeisnotallowedasanincidentfileforthiscommand.

Action:RetryusinganincidentfileinsidetheADRhome

()DIA48400:ADRCIinitializationfailed

Cause:TheADRBasedirectorydoesnotexist

Action:CheckthevalueoftheDIAGNOSTIC_DEST initializationparameter,andensurethatitpointstoanADRbasedirectorythatcontainsatleastoneADRhome.IfDIAGNOSTIC_DEST ismissingornull,checkforavalidADRbasedirectoryhierarchyinORACLE_HOME/log.

()DIA48431:MustspecifyatleastoneADRhomepath

Cause:ThecommandrequiresatleastoneADRhometobecurrent

Action:UsetheSET HOMEPATH commandtomakeoneormoreADRhomescurrent.

()DIA48432:TheADRhomepathstringisnotvalid

Cause:ThesuppliedADRhomeisnotvalid,possiblybecausethepathdoesnotexist.

Action:CheckifthesuppliedADRhomepathexists

()DIA48447:Theinputpath[path]doesnotcontainanyADRhomes

Cause:WhenusingSET HOMEPATH tosetanADRhome,youmustsupplyapathrelativetothecurrentADRbase.

Action:IfthenewdesiredADRhomeisnotwithinthecurrentADRbase,firstsetADRbasewithSET BASE ,andthenuseSHOW HOMES tochecktheADRhomesunderthenewADRbase.Next,useSET HOMEPATH tosetanewADRhomeifnecessary.

()DIA48448:ThiscommanddoesnotsupportmultipleADRhomes

Cause:TherearemultiplecurrentADRhomesinthecurrentADRCIsession.

Action:UsetheSET HOMEPATH commandtomakeasingleADRhomecurrent.

AboutOracle(http://www.oracle.com/corporate/index.html) ContactUs(http://www.oracle.com/us/corporate/contact/index.html) LegalNotices

(http://www.oracle.com/us/legal/index.html) TermsofUse(http://www.oracle.com/us/legal/terms/index.html) YourPrivacyRights

(http://www.oracle.com/us/legal/privacy/index.html)

Copyright2015,Oracleand/oritsaffiliates.Allrightsreserved.

Documents

ADRCI_ ADR Command Interpreter