UsingAutoConfigtoManageSystemConfigurationsinOracleEBusinessSuiteRelease12

(DocID387859.1)
Modified: 26Jan2014

Type: WHITEPAPER

UsingAutoConfigtoManageSystemConfigurationsinOracleEBusinessSuite
Release12
LastUpdated:September12,2012
ThemostcurrentversionofthisdocumentispublishedasMyOracleSupportKnowledgeDocument387859.1.
Thisdocumentcontainsthefollowingsections:
Section1:OverviewofAutoConfigComponentsand
Section6:UsingAutoConfigonanOracleRAC
Tools
Instance
1.1.AutoConfigComponents
Section7:OracleEBusinessSuiteServices:
1.2.AutoConfigTools
ProcessManagement
Section2:UsingAutoConfigToolsforSystem
7.1.ModifyingAutoConfigmanagedServices
Configuration
andServiceGroups
2.1.PreviewingEffectsofRunningAutoConfig
7.2.CommandstoManageOracleE
2.2.RunningAutoConfigontheDatabaseTier
BusinessSuiteServiceProcesses
2.3.RunningAutoConfigontheApplication
Section8:KnownIssues
Tier
2.4.ReviewingAutoConfigLogFiles
Section9:FrequentlyAskedQuestions
2.5.RollingBackanAutoConfigSession
Section3:PatchingAutoConfig
3.1.ApplyingtheLatestAutoConfigUpdates
3.2.EnablingAutoConfigonaNewOracle
Home
Section4:CustomizingAutoConfigManaged
Configurations

9.1.OverviewandTerminology
9.2.TheContextFile
9.3.RunningAutoConfig
9.4.Customizations
9.5.PatchingAutoConfig
9.6.NetServices
9.7.DatabaseConnectivity
9.8.OracleRAC
9.9.WindowsSpecificRequirements
9.10.Troubleshooting

4.1.PrerequisitesforAutoConfig
Customizations
4.2.ImplementingAutoConfigCustomizations AppendixA:SpecificationforAutoConfigDriverFile
4.3.AdvancedFeaturesofAutoConfig
Syntax
Customizations
AppendixB:SettingthePERL5LIBenvironment
Section5:AdvancedAutoConfigFeaturesand
variableontheDatabasetier
Utilities
ChangeLog
5.1.RunningAutoConfiginParallelAcross
MultipleNodes
5.2.ProfilingAnAutoConfigRun
5.3.UsingtheCheckConfigUtility
5.4.UsingtheContextVariableInformation
Utility

Conventions

Attention:WindowsusersthisdocumenttypicallyusesUNIXsyntaxwhenspecifyingdirectories.
SubstitutetheappropriateWindowssyntaxwhereapplicable.

Convention

Meaning

APPLMGR

UserwhoownstheApplicationsfilesystem(APPL_TOPandapplicationtiertechnologystack)

ORACLE

Userwhoownsthedatabasefilesystem(RDBMS ORACLE_HOMEanddatabasefiles).

CONTEXT_NAME

LogicalnameforyourContext.Default:<SID>_<hostname>

CONTEXT

Fullpathtothecontextfile(eitherApplicationscontextfileordatabasecontextfile).
Default:<INST_TOP>/appl/admin/<CONTEXT_NAME>.xmland
<RDBMS_ORACLE_HOME>/appsutil/<CONTEXT_NAME>.xml

APPSpwd

Applicationsdatabaseuserpassword

APPSuser/APPSpwd Applicationsdatabaseusernameandpassword
Monospace Text

Representscommandlinetext.Typethiscommandexactlyasshown.

OnUNIX,thebackslashcharacterisenteredattheendofacommandlinetoindicate
continuationofthecommandonthenextline.

AutoConfigtemplate
file

Customtemplatefile

AnAutoConfigtemplatefilecontainsnamedtags,whicharereplacedwithinstancespecific
informationwhenAutoConfigruns.Forexample:<FND_TOP>/admin/template/afwebprf.sh
AutoConfigtemplatefilesshouldnotbeedited.

TocustomizeAutoConfigmanagedconfigurationfiles,copytheAutoConfigtemplatefiletoa
customtemplatefileandeditthecustomtemplatefile.Forexample:
<FND_TOP>/admin/template/custom/afwebprf.sh

WhenAutoConfigdetectsacustomtemplatefile,AutoConfiginstantiatesthisfileinplaceof
theAutoConfigtemplatefile.
AutoConfigtemplate
directory

DirectorywhereOracledeliversAutoConfigtemplatefiles.ThereisanAutoConfigtemplate
directoryforeveryproduct.
Location:<product_top>/admin/template
<RDBMS ORACLE_HOME>/appsutil/template
Forexample:<FND_TOP>/admin/template
<ORACLE_HOME>/appsutil/template

Customtemplate
directory

Configurationfile

DirectorywhereyoukeepyourcustomizedAutoConfigtemplatefiles.
Location:<product_top>/admin/template/custom
<RDBMS ORACLE_HOME>/appsutil/template/custom
Forexample:<FND_TOP>/admin/template/custom
<ORACLE_HOME>/appsutil/template/custom
TheinstantiatedconfigurationfilethatiscreatedwhenAutoConfigruns.Forexample:
<INST_TOP>/admin/install/afwebprf.sh

<>

Textenclosedinanglebracketsrepresentsavariable.Substituteavalueforthevariabletext.
Donottypetheanglebrackets.

SECTION1:OVERVIEWOFAUTOCONFIGCOMPONENTSANDTOOLS
AutoConfigisatoolthatsupportsautomatedconfigurationofanOracleEBusinessSuiteRelease12instance.Allthe

informationrequiredforconfiguringanApplicationsinstanceiscollectedintotwolocalrepositories,calledthe
Applicationscontextfileandthedatabasecontextfile.WhenAutoConfigrunsontheapplicationtier,ituses
informationfromtheApplicationscontextfiletogenerateallconfigurationfilesandupdatedatabaseprofiles.When
AutoConfigrunsonthedatabasetier,itusesinformationfromthedatabasecontextfiletogenerateallconfiguration
filesusedonthedatabasetier.
AutoConfigprovidesseveralmajorbenefits,including:
ConfigurationSupport:AutoConfigconfigurestheAPPL_TOP,theORACLE_HOMEs,andthesupporting
technologystack.
ConfigurationManagement:AutoConfigcentralizestheconfigurationandreconfigurationofanApplications
instance.
ConfigurationDeliveryandPatching:Theuptakeofnewtechnologyissimplified,asnewconfigurationsand
configurationchangescanbeprovidedintheformofapatch.
1.1.AutoConfigComponents
AutoConfigconsistsofseveralcomponents:
Component

Description

Applicationscontext

AnXMLrepositorylocatedintheINST_TOPthatcontainsinformation
specifictotheAPPL_TOP.

Databasecontext

AnXMLrepositorylocatedintheRDBMSORACLE_HOMEthatcontains
informationspecifictothatdatabasetier.

AutoConfigtemplate
files

Filescontainingnamedtagsthatarereplacedwithinstancespecific
informationfromtheappropriatecontext("instantiation").

AutoConfigdriverfiles

EveryOracleEBusinessSuiteproductmaintainsadriverfileusedby
AutoConfig.ThedriverfileliststheAutoConfigfiletemplatesandtheir
destinationlocations.

AutoConfigscripts

AsetofscriptsthatprovideasimplifiedinterfacetotheAutoConfigAPIs.

TheApplicationsRelease12applicationtierisAutoConfigenabled,andhasanApplicationscontextfile
storedintheINST_TOPas<INST_TOP>/appl/admin/<CONTEXT_NAME>.xml.TheApplicationsRelease
12databasetiercreatedviaRapidInstallisalsoAutoConfigenabled,andhasadatabasecontextfile
storedintheRDBMSORACLE_HOMEas<RDBMS ORACLE_HOME>/appsutil/<CONTEXT_NAME>.xml.
Whenachangeismadetoanyofthecontextfilesoranyofthetemplatefiles,theAutoConfigutility
updatestheApplicationsRelease12configuration.
AutoConfigcanalsobeusedtostartandstopallApplicationssystemservicesthatitmanages.
1.2.AutoConfigTools
BelowisasummaryoftheAutoConfigtools.
Script

Location

adautocfg.sh/cmd

OnApplicationsTier:
<INST_TOP>/admin/scripts

OnDatabaseTier:

Utility

Thisscriptis
usedforrunning
AutoConfig.

<RDBMS_ORACLE_HOME>/appsutil/scripts/<CONTEXT_NAME> MoreDetails

adchkcfg.sh/cmd

OnApplicationsTier:

Thisscriptmay

<AD_TOP>/bin

OnDatabaseTier:
<RDBMS_ORACLE_HOME>/appsutil/bin

berunbefore
running
AutoConfigto
reviewthe
changeson
running
AutoConfig.This
willgeneratea
reportshowing
thedifferences
betweenthe
existing
configurationand
whatthe
configuration
wouldbeafter
running
AutoConfig.
MoreDetails

GenCtxInfRep.pl

OnApplicationsTier:
<FND_TOP/patch/115/bin

OnDatabaseTier:
<RDBMS_ORACLE_HOME>/appsutil/bin

Thisscriptcan
beusedtofind
outdetailed
informationabout
contextvariables
andthe
templatesin
whichtheyare
used,givenallor
partofacontext
variablenameas
akeyword.
MoreDetails

adtmplreport.sh/cmd OnApplicationsTier:
<AD_TOP>/bin

OnDatabaseTier:
<RDBMS_ORACLE_HOME>/appsutil/bin

Thisscriptcan
beusedto
gather
information
regardingthe
locationofthe
AutoConfig
templates,
providedthe
locationofthe
instantiatedfiles
andviceversa.
MoreDetails

admkappsutil.pl

OnApplicationsTier:
<AD_TOP>/bin

Thisscriptis
usedwhile
applyingpatches
tothedatabase
tier.Runningthis
scriptgenerates
appsutil.zip
whichmaybe
copiedoverto
thedatabasetier

tomigratethe
patchtothe
databasetier.
MoreDetails
Besidestheabovetools,therearestartandstoptoolsthatareusedtomanagetheruntimeprocesses
ofEBSServices.ThesetoolsarelistedinSection7.

SECTION2:USINGAUTOCONFIGTOOLSFORSYSTEMCONFIGURATION
AsmentionedinSection1,AutoConfigisusedtoautomatesystemconfiguration.Thissectiondescribeshowthe
AutoConfigtoolscanbeusedforthispurpose.Thesetoolsaremeanttobeusedinthefollowingorder:
2.1.PreviewingEffectsofRunningAutoConfig
BeforerunningAutoConfig,theCheckConfigutilitymayberuntoreviewthechangesthatwouldoccurinthefile
systemaswellasthedatabaseinthenextAutoConfigrun.Thisstepisoptional.
ExecutethefollowingcommandtoruntheCheckConfigutility.
OntheDatabasetier:
OnUnix:
sh <RDBMS_ORACLE_HOME>/appsutil/bin/adchkcfg.sh contextfile=<CONTEXT_FILE>

OnWindows:
<RDBMS_ORACLE_HOME>\appsutil\bin\adchkcfg.cmd contextfile=<CONTEXT_FILE>

OntheApplicationstier:
OnUnix:
sh <AD_TOP>/bin/adchkcfg.sh contextfile=<CONTEXT_FILE>

OnWindows:
<AD_TOP>\bin\adchkcfg.cmd contextfile=<CONTEXT_FILE>

PleaserefertoSection5.3formoredetailsonthistool.

2.2.RunAutoConfigontheDatabaseTier
RunningAutoConfigonthedatabasetierisrequiredinthefollowingscenarios:
Aftermigratingapatchtothedatabasetier,theCheckConfigutilityreportsanypotentialchangestothe
templates.
Aftercustomizationsonthedatabasetier
Afteradatabaseorapplicationtierupgrade
AfterrestorationofthedatabaseorOracleHomefromabackuptape
AfteraJDKupgradeonthedatabasetier
AftertheNetServicesTopologyInformationismanuallycleanedupusingoneofthesupportedprocedures(eg.
fnd_conc_clone.setup_clean).Subsequently,AutoConfigmustberunontheapplicationtiernodes.
AfterregistrationofaRACnode.
AftersettinguptheAPPL_TOPonasharedfilesystem.
AllothercaseswheredocumentationsaysthatAutoConfigshouldberunonthedatabasetier.

ExecutethefollowingcommandtorunAutoConfigonthedatabasetier.
OnUnix:
sh <RDBMS_ORACLE_HOME>/appsutil/scripts/<CONTEXT_NAME>/adautocfg.sh

OnWindows:
<RDBMS_ORACLE_HOME>\appsutil\scripts\<CONTEXT_NAME>\adautocfg.cmd

Attention:
ThedatabaseserverandthedatabaselistenermustremainavailableduringtheAutoConfig
run.Alltheotherdatabasetierservicesshouldbeshutdown.
RunningAutoConfigmaychangeyourexistingenvironmentfiles.AfterrunningAutoConfig,you
shouldalwayssettheenvironmentbeforeyourunanyApplicationsutilities,inordertoapply
thechangedenvironmentvariables.

2.3.RunAutoConfigontheApplicationTier
RunAutoConfigonallapplicationtiernodes.
ExecutethefollowingcommandtorunAutoConfig.
OnUnix:
sh <INST_TOP>/admin/scripts/adautocfg.sh

OnWindows:
<INST_TOP>\admin\scripts\adautocfg.cmd

Attention:
ThedatabaseserverandthedatabaselistenermustremainavailableduringtheAutoConfig
run.Onlytheapplicationtierserversshouldbeshutdown.
RunningAutoConfigmaychangeyourexistingenvironmentfiles.AfterrunningAutoConfig,
youshouldalwayssettheenvironmentbeforeyourunanyApplicationsutilities,inorderto
applythechangedenvironmentvariables.

2.4.ReviewingAutoConfigLogFiles
AutoConfiglogfilesarestoredunder:
Tier

Directory

Application

<INST_TOP>/admin/log/<MMDDhhmm>

Database

<RDBMS ORACLE_HOME>/appsutil/log/<CONTEXT_NAME>/<MMDDhhmm>

OnelogfileiscreatedperAutoConfigsession.ItwillcontaindetailsofeveryactionthatAutoConfigperformedduring

therun.
2.5.RollingBackanAutoConfigSession
EachAutoConfigrunofcreatesarollbackscriptyoucanusetoreverttothepreviousconfigurationsettingsif
necessary.ThescriptandallbackupconfigurationfilesfromeachAutoConfigsessionarestoredin:
Tier

Directory

Application

<INST_TOP>/admin/out/<MMDDhhmm>

Database

<RDBMS ORACLE_HOME>/appsutil/out/<CONTEXT_NAME>/<MMDDhhmm>

where:< MMDDhhmm>=(month,day,hour,minuteofAutoConfigrun)
TorollbackanAutoConfigsession,executethefollowingcommands:
OnUNIX
restore.sh

OnWindows
restore.cmd

SECTION3:PATCHINGAUTOCONFIG
ForpatchingAutoConfigontheEBusinessSuiteR12instance,AutoConfigneedstobeenabledonboththe
applicationstierandthedatabasetier.
3.1.ApplyingtheLatestAutoConfigUpdates
InordertogetthelatestAutoConfigupdatesonboththeapplicationstierandthedatabasetier,performthefollowing
stepsintheorderlisted:
a. ApplytheTXKAutoConfigTemplatepatch
UpdatetheOracleApplicationsfilesystemwiththeAutoConfigfilesbyapplyingthelatestAutoConfigTemplate
patch(Patch9386653for12.0.XcustomersandPatch8919489for12.1.Xcustomers)toallapplicationtier
nodesintheApplicationsinstance.
WindowsItaniumcustomerson12.0.Xshouldapplyanadditionaloneoffpatch,6501658.Customersneedto
beonatleastthe12.0.2patchsetinordertoapplythisoneoffpatch.
WindowsItaniumandWindows2008x8664customersrunningsplittiermodeon12.0.Xshouldapplythe
additionaloneoffPatch13742583.
Note:ADXandTXKrolluppatchesforconfigurationmanagementhavebeencombined.
b. CopyAutoConfigtotheRDBMSORACLE_HOME
UpdatetheRDBMSORACLE_HOMEfilesystemwiththeAutoConfigfilesbyperformingthefollowingsteps:
Ontheapplicationtier(astheAPPLMGRuser):
LogintotheAPPL_TOPenvironment(sourcetheenvironmentfile)
Createappsutil.zipfile
perl <AD_TOP>/bin/admkappsutil.pl

Thiswillcreateappsutil.zipin<INST_TOP>/admin/out
Onthedatabasetier(astheORACLEuser):
CopyorFTPtheappsutil.zipfiletothe<RDBMSORACLE_HOME>
cd<RDBMSORACLE_HOME>
unzipoappsutil.zip

c. RunAutoConfig
RunAutoConfigonthedatabasetierandthenontheapplicationstierasdescribedinsubsections2.2and2.3
inSection2.
3.2.EnablingAutoConfigonaNewOracleHome
InR12,AutoConfigisenabledbydefaultontheapplicationstier.Butitmightnotbeenabledonthedatabasetierin
thefollowingscenarios:
DatabasetiernotcreatedbyRapidInstall
Crossplatformmigrationofthedatabasetier
Upgradingto11gDatabase
UpgradingthedatabasetierfromApplications11itoEBusinessSuiteRelease12
InordertoenableAutoConfigonthedatabasetier,performthefollowingstepsintheorderlisted:
1. Applypatch6636108ontheApplicationstier
Customerswhoareon12.0.Xneedtoapplythispatchwhichdeliverstheadbldxmlutilityforgeneratingthe
contextfileonthedatabasetier.ThispatchisalsoincludedinthelatestAutoConfigTemplatepatch(Patch
9386653for12.0.XcustomersandPatch8919489for12.1.Xcustomers).
Note:Ifyourinstanceison12.0.Xandisnotupgradedto10.1.3.3ASpatchset,Patch4585869needsto
beappliedinordertousetheadbldxmlutility.
2. CopyAutoConfigtotheRDBMSORACLE_HOME
UpdatetheRDBMSORACLE_HOMEfilesystemwiththenewAutoConfigfilesdeliveredintheabovepatch
followingStep2inSection3.1.
3. InstallJREontheDatabasetier
Followthestepsbelowtoensurethatjreversionontheapplicationstierandthedatabasetierisatleast1.5or
higher:
Ifyouareusinga"fullycertified"platform,pleaserefertoMetalinkNote418664.1toinstalljreunderthe
<RDBMS_ORACLE_HOME>/appsutildirectory.
Ifyouareusinga"Databasetieronly"platform,pleaserefertoMetalinkNote456197.1toinstalljre
underthe<RDBMS_ORACLE_HOME>/appsutildirectory.
4. GeneratetheDatabaseContextFile
ExecutethefollowingcommandtocreateyourDatabaseContextFile:

perl<RDBMS_ORACLE_HOME>/appsutil/bin/adbldxml.pl

Attention:IfyoubuildthecontextfileforaninstancethatrunsonRAC,allyourRACinstanceshavetobe
upandrunningwhileexecutingtheadbldxmlutility.TheutilityconnectstoallRACinstancestogather
informationabouttheconfiguration.

5. RunAutoConfigontheDatabasetier
RunAutoConfigontheDatabasetierbyexecutingthebelowcommand:
OnUnix:
<RDBMS_ORACLE_HOME>/appsutil/bin/adconfig.sh contextfile=<context_file>

OnWindows:
<RDBMS_ORACLE_HOME>\appsutil\bin\adconfig.cmd contextfile=<context_file>

SECTION4:CUSTOMIZINGAUTOCONFIGMANAGEDCONFIGURATIONS
AutoConfigisatoolthatsimplifiesandstandardizesconfigurationmanagementtasksinanOracleEBusinessSuite
environment.TheconfigurationgeneratedbyAutoConfigmaynotalwaysmeetyourspecificrequirements,anditmay
benecessarytocustomizeAutoConfigforyourenvironment.
ExampleswhereyoumightwanttocustomizeAutoConfiginclude:
StartadditionalservicesorprocesseswhenyoustartOracleApplicationsservices
DefineyourOC4Jconfiguration
ExtendOracleFormstointegratewithathirdpartyJavaversion
DevelopcustomapplicationsthataremaintainedbyAutoConfig
Historically,Oracledidnotdocumentproceduresonhowtoimplementcustomizations.Ifyoutriedtocustomizeyour
AutoConfiggeneratedfilesbymanuallyeditingthem,yourchangeswerelosteverytimeAutoConfigran.Toavoidthis,
OracleSupportmayhaveinstructedyoutoaddyourcustomizationsbetween"Begin/Endcustomizations"blocksin
theconfigurationfiles.Thislimitedandinflexiblemethodhasnowbeensupersededbyafullysupportedmechanismto
extendyourAutoConfigmaintainedenvironmentwithmaximumflexibility,andpreservingyourextensionseverytime
AutoConfigisrun.
4.1.PrerequisitesforAutoConfigCustomizations
BeforecustomizingAutoConfig,certainprerequisitesmustbemet.
1. Reviewyourcurrentconfiguration
RuntheAutoConfigcheckutilityasdescribedinSection5.3.Reviewanydifferencesinthereportandidentify
themanualconfigurationchangesthatyouwanttoimplementascustomizations.
2. Reviewandmigrateexistingcustomizations
Ifyouimplementedcustomizationsbetween"Begin/Endcustomization"blocksinthepast,thenyoumust
migratethosesettingsnow.Executethefollowingcommand:
Platform

Tier

Command

UNIX

Application

<AD_TOP>/bin/adcustomizer.shcontextfile=<CONTEXT_FILE>

Database

<RDBMSORACLE_HOME>/appsutil/bin/adcustomizer.shcontextfile=
<CONTEXT_FILE>

Windows

Application

<AD_TOP>\bin\adcustomizer.cmdcontextfile=<CONTEXT_FILE>

Database

<RDBMSORACLE_HOME>\appsutil\bin\adcustomizer.cmdcontextfile=
<CONTEXT_FILE>

Theadcustomizerscript:

a.
b.
c.
d.

Detectsallconfigurationfilesthathave"Begin/Endcustomizations"blocks.
CopiesthecorrespondingAutoConfigtemplatefilestocustomtemplatefiles.
Appendsthecontentsinthe"Begin/Endcustomizations"blockstotheendofthecustomtemplatefiles.
Removesthe"Begin/Endcustomizations"blocksfromtheconfigurationfile.

Reviewthelogfilegeneratedbytheadcustomizerscript.Ensurethatallyourcustomizationsweresuccessfully
migratedtothecustomtemplatefile(s)byexaminingthegeneratedcustomtemplatefile(s).
4.2.ImplementingAutoConfigCustomizations
Thissectionaddressesthedifferenttypesofcustomizationsandhowtoimplementthem.

Note:AllfilesmanagedbyAutoConfighavethefollowingheader:
################################################################
#
#ThisfileisautomaticallygeneratedbyAutoConfig.Itwillbereadand
#overwritten.Ifyouwereinstructedtoeditthisfile,orifyouarenot
#abletousethesettingscreatedbyAutoConfig,refertoMetalink
#document387859.1forassistance.
#
################################################################

Afteridentifyingyourcustomizationneed,performthestepsassociatedwithit.Oraclesupportsthefollowingtypesof
customizations:
Changingthevalueofanexistingcontextvariable
Addinganewcontextvariabletothecontextfile
CustomizinganAutoConfigtemplatefiledeliveredbyOracle
CreatingacustomerownedAutoConfigtemplatefile
1. Changingthevalueofanexistingcontextvariable
a. Editthecontextvariablevalue
UsetheOracleApplicationsManagerContextEditortochangevaluesofexistingcontextvariables.
RefertoOracleApplicationsSystemAdministrator'sGuideConfigurationfordetailsofhowtousethe
OracleApplicationsManagerContextEditor.
b. RunAutoConfig
Dependingonwhetherthecontextvariablebelongstotheapplicationtierorthedatabasetier,run
AutoConfigontheappropriatetier,followingthestepsmentionedinSection2.
2. Addinganewcontextvariabletothecontextfile
a. Addthecontextvariable
UsetheOracleApplicationsManagerContextEditorifyouwanttoaddacontextvariablethatisnot
maintainedbyAutoConfig.RefertotheHelppagesavailableonOracleApplicationsManager.The
relevantinformationforaddingcustomcontextvariablesislocatedinthe"SystemConfiguration">
"AutoConfig">"ManageCustomParameters"section.
b. RunAutoConfig
Dependingonwhetherthecontextvariablehasbeenaddedfortheapplicationtierorthedatabasetier,
runAutoConfigontheappropriatetier,followingthestepsmentionedinSection2.

3. CustomizinganAutoConfigtemplatefiledeliveredbyOracle
IfyouwanttocustomizeanexistingAutoConfigtemplatefile,performthefollowingstepsintheorderlisted:
a. DeterminetheAutoConfigtemplatefileyouwanttocustomize
ExecutethefollowingcommandtofindoutthecorrespondingAutoConfigtemplatefileforthe
configurationfileyouwanttocustomize:

Platform Tier

Command

Application <AD_TOP>/bin/adtmplreport.shcontextfile=<CONTEXT_FILE>

UNIX

target=<configurationfile>

Database

<RDBMSORACLE_HOME>/appsutil/bin/adtmplreport.sh
contextfile=<CONTEXT_FILE>target=<configurationfile>

Windows Application <AD_TOP>\bin\adtmplreport.cmdcontextfile=<CONTEXT_FILE>

target=<configurationfile>

Database

<RDBMSORACLE_HOME>\appsutil\bin\adtmplreport.cmd
contextfile=<CONTEXT_FILE>target=<configuration>

Forexample,ifyouwanttocustomize
$INST_TOP/admin/install/afwebprf.sh

OnUNIX
$AD_TOP/bin/adtmplreport.shcontextfile=$CONTEXT_FILE\
target=$INST_TOP/admin/install/afwebprf.sh

OnWindows
%AD_TOP%\bin\adtmplreport.cmdcontextfile=%CONTEXT_FILE%\
target=%INST_TOP%\admin\install\afwebprf.cmd

TheadtmplreportutilityreturnsthenameandlocationoftheAutoConfigtemplatefile.FortheaboveUNIX
exampleitwouldreturn:
$FND_TOP/admin/template/afwebprf.sh

YoucannotcustomizeallAutoConfigtemplatefiles.TheAutoConfigtemplatefilecannotbecustomized
ifthe"LOCK"keywordappearsinthetemplatefile'sentryintheproductdriverfile.AutoConfigignores
customtemplatefilesthataremarkedwith"LOCK".
Forexample,thefollowingentryin<AD_TOP>/admin/driver/adtmpl.drvwouldpreventcustomization
ofthefileadconfig.txt:
adadmin/templateadconfig.txtINSTE8<s_at>/adminadconfig.txt600LOCK

b. Createthecustomtemplatedirectory
Createadirectorynamed"custom"atthelocationwheretheAutoConfigtemplatefileresides.
Forexample,ifyouwanttocustomize<FND_TOP>/admin/template/afwebprf.sh,executethe
followingcommandastheapplmgruser:
OnUNIX

mkdir$FND_TOP/admin/template/custom

OnWindows
mkdir%FND_TOP%\admin\template\custom

c. CopytheAutoConfigtemplatefile
CopytheAutoConfigtemplatefiletothecustomtemplatefile.
Executethefollowingcommandastheapplmgruser:
OnUNIX
cp -i <AutoConfig template file> <custom template file>

Forexample:
cpi$FND_TOP/admin/template/afwebprf.sh\
$FND_TOP/admin/template/custom/afwebprf.sh

OnWindows
copy<AutoConfigtemplatefile><customtemplatefile>

Forexample:
copy%FND_TOP%\admin\template\afwebprf.cmd\
%FND_TOP%\admin\template\custom\afwebprf.cmd

d. Editthecustomtemplatefile
Editthecustomtemplatefilewiththetexteditorofyourchoice,suchasvionUNIXorWordpadon
Windows.
Note:ItisnotsupportedtoeditAutoConfigtemplatefiles.Besuretoeditthecustom
templatefile.
e. Verifyyourcustomizations
ExecutetheadchkcfgutilityasdescribedinSection5.3.Whenthisutilityruns,itinstantiatesany
customtemplatefilesinplaceofthecorrespondingAutoConfigtemplatefile.Theadchkcfgutility
generatesareportwithinformationaboutallfilesandprofileoptionsthatwillbechangedduringthenext
normalrunofAutoConfig.Verifythatyourcustomizationswouldbeappliedasexpectedinyournext
AutoConfigrun.
Note:adchkcfg.sh/cmdinstantiatesthetemplatesintothefollowinglocation:
Ontheapplicationtier:
<INST_TOP>/admin/out/<MMDDhhmm>

Onthedatabasetier:
<RDBMSORACLE_HOME>/appsutil/out/<CONTEXT_NAME>/<MMDDhhmm>

f. RunAutoConfig
RunAutoConfigasdescribedinSection2.WhenAutoConfigruns,itinstantiatesanycustomtemplate
fileinplaceofthecorrespondingAutoConfigtemplatefile.
4. CreatingacustomerownedAutoConfigtemplatefile
YoucancreateanAutoConfigtemplatefileofyourown.Thiswillenableyoutodevelopcustom
applicationsthatAutoConfigcanconfigureandmaintain.
Performthefollowingtasksintheorderlisted:
a. Defineaproduct_top
UsetheOracleApplicationsManagerContextEditortoaddyourcustomproduct_toptothecontextfile.
RefertotheHelppagesavailableinOracleApplicationsManager.Therelevantinformationforadding
customcontextvariablesislocatedinthe"SystemConfiguration">"AutoConfig">"ManageCustom
Parameters"section.Choosethevariabletype"PROD_TOP"whenaddingtheproduct_topvariable.The
defaultvaluefortheproduct_topvariablemustbesetto'<s_at>/<productname>/12.0.0'.
Forexample,definetheproducttopfortheproduct'my'asfollows:
OA_VAR=c_mytop
DefaultValue=<s_at>/my/12.0.0
Title=MyProducttop
Description=Thisismyproducttop
OA_TYPE=PROD_TOP

b. CreatethecustomerownedAutoConfigtemplatedirectory
CreatethedirectorywhereyourAutoConfigtemplatefileswillreside.Executethefollowingcommandas
theapplmgruser:
OnUNIX
mkdir<c_mytop>/admin/template

OnWindows
mkdir<c_mytop>\admin\template

c. DevelopthecustomerownedAutoConfigtemplatefile
CreatethecustomAutoConfigtemplatefileinthecustomproducttopAutoConfigtemplatedirectory.
Therearenofilenamerestrictions,andthenewtemplatefilecanbeofanytypethatcanstoretext,
suchastextfile,shellscript,Perlscript,orSQLscript.TouseAutoConfiginstantiation,enteryour
contextvariablesinthefile.WhenAutoConfigruns,itreplacesthecontextvariableswiththeassociated
valuesfromthecontextfile.
Forexample,createandeditthefile
<c_mytop>/admin/template/myTemplate.txt

d. CreatethecustomerownedAutoConfigdriverdirectory
CreatethedirectorywhereyourAutoConfigdriverfilewillreside.Executethefollowingcommandasthe
applmgruser:
OnUNIX
mkdir<c_mytop>/admin/driver

OnWindows

mkdir<c_mytop>\admin\driver

e. DevelopthecustomerownedAutoConfigdriverfile
TheAutoConfigdriverfileinstructsAutoConfigwheretoplacethegeneratedconfigurationfile.Placethe
driverfileinthecustomAutoConfigdriverdirectory.Thenameforthedriverfileisdefinedas:
<product>tmpl.drv.Inthisexample,thedriverfilewouldbenamed: mytmpl.drv.RefertoAppendixA:
SpecificationforAutoConfigDriverFileSyntaxforinformationontheformatofthedriverfile.
Forexample,tohaveAutoConfiginstantiatetheaboveexampletemplatefile,thedriverfilewouldneedto
containthisline:
myadmin/templatemyTemplate.txtINSTE8<s_pt>myConfiguration.txt660

4.3.AdvancedFeaturesofAutoConfigCustomizations
ThissectiondiscussesadvancedfeatureswhenusingAutoConfigCustomizations.
1. Debuggingcustomizations
Ifproblemsarisewithcustomizationsthatyouimplemented,itmaybeusefultorunAutoConfigwiththe
AutoConfigtemplatefiles,ignoringanycustomtemplatefiles.Executethefollowingcommand:
OnUNIX
<AD_TOP>/bin/adconfig.shnocustomcontextfile=<CONTEXT_FILE>

OnWindows
<AD_TOP>\bin\adconfig.cmdnocustomcontextfile=<CONTEXT_FILE>

2. Preservingcustomizationsafterupdates
YoumustreviewyourcustomizationswheneverADPatchdeliversanewversionofanAutoConfigtemplatefile
forwhichyoueditedthecorrespondingcustomtemplatefile.Ifthecustomizationsarestillrequired,copythe
newversionoftheAutoConfigtemplatefiletothecustomtemplatedirectory,andeditthecustomtemplatefile
withyourcustomizations.
AutoConfigchecksthatyourcustomtemplatefilesareofthesameversionsastheAutoConfigtemplatefiles,
andwillnotrunifitdetectsanyversionmismatch.
3. Reports
Thereportproducedbytheadtmplreportutilitycan:
ListallcustomizedfilesinanOracleEBusinessSuiteinstance
ListallAutoConfigtemplatefiles,theircustomtemplatefilesandtheirconfigurationfiles
IdentifythenameandlocationoftheAutoConfigtemplatefileandthecustomtemplatefileforagiven
configurationfile
IdentifythenameandlocationoftheconfigurationfileforagivenAutoConfigtemplatefile
Thereportutilityislocatedat:
Tier

Location

Application

<AD_TOP>/bin

Database

<RDBMS ORACLE_HOME>/appsutil/bin

TolistallfilesthatyoucustomizedinanOracleEBusinessSuiteinstance:
Platform

Command

UNIX

adtmplreport.sh contextfile=<CONTEXT_FILE> listcustom

Windows

adtmplreport.cmd contextfile=<CONTEXT_FILE> listcustom

Tolistallconfigurationsfiles,theirAutoConfigtemplatefilesandtheircustomtemplatefiles:
Platform

Command

UNIX

adtmplreport.sh contextfile=<CONTEXT_FILE>

Windows

adtmplreport.cmd contextfile=<CONTEXT_FILE>

ToidentifytheconfigurationfileforagivenAutoConfigtemplatefile:
Platform

Command

UNIX

adtmplreport.sh contextfile=<CONTEXT_FILE> template=

<templatefilepath>

Windows

adtmplreport.cmd contextfile=<CONTEXT_FILE> template=

<templatefilepath>

ToidentifytheAutoConfigtemplateandcustomtemplatefileforagivenconfigurationfile:
Platform

Command

UNIX

adtmplreport.sh contextfile=<CONTEXT_FILE> target=

<configurationfile>

Windows

adtmplreport.cmd contextfile=<CONTEXT_FILE> target=

<configurationfile>

SECTION5:ADVANCEDAUTOCONFIGFEATURESANDUTILITIES
ThissectiongivesanoverviewofsomeoftheusefulnewadvancedAutoConfigfeaturesandutilities.
5.1.RunningAutoConfiginParallelAcrossMultipleNodes
ThisfeaturewasintroducedinTXK12.0.4ConsolidatedPatch.ItenablesAutoConfigtobeexecutedsimultaneously
acrossmultiplenodesofanR12EBusinessSuiteinstance,thusreducingthemaintenancedowntime.
AutoConfigcanberunin'parallelmode'byissuingthefollowingcommand.
OnApplicationstier:
perl <AD_TOP>/bin/adconfig.pl contextfile=<CONTEXT_FILE> [product=<product_top>] parallel

OnDatabasetier:
perl <ORACLE_HOME>/appsutil/bin/adconfig.pl contextfile=<CONTEXT_FILE> parallel

Note:WhenrunningAutoConfigsimultaneouslyonmultiplenodes,the'parallel'optionmustbespecifiedwhile
startingAutoConfigoneverynode.OtherwisetheexecutionofAutoConfigprocessesonindividualnodeswillnot
besynchronized,whichmightresultininconsistentfilesystemordatabaseupdates.

5.2.ProfilingAutoConfigRun
TheAutoConfigPerformanceProfilerfeaturehasbeenintroducedinTXK12.0.4ConsolidatedPatch.Thisfeaturecan
beusedtoprofileanAutoConfigrunandgenerateaconsolidatedreportinHTMLformat.Thereportdisplaysa
summarizedviewlistingalltheproducttopsalongwiththetotalinstantiation/executiontimeofthetemplateswithin
them.Theprofilereportcomprisesthefollowingsections:
Summary(Seeascreenshot)
ThissectionofthereportshowstheprofileinformationforallproducttopsprocessedinthecurrentAutoConfig
run.Itshowsthefollowing:
ProductTop:Shortnameofeachproducttop.
InstantiationTime:Totaltimetakentoinstantiatetemplatesfromeachproducttop.
ExecutionTime:Totaltimetakentoexecutescriptsfromeachproducttop.
Time(%):PercentageofAutoConfigexecutiontimetakentoinstantiateandexecutescriptsfromeach
producttop.
Status:Whetherornotallthetemplatesfromeachproducttopweresuccessfullyinstantiatedand
executed.
Theprofileinformationforindividualtemplatescanbeseenbydrillingdownintotheproducttopslistedinthesummary
section.
Details(Seeascreenshot)
Thissectioncontainstheprofileinformationforallproducttemplatesthatareonlyinstantiated/executedinthe
currentAutoConfigrun.Itshowsthefollowing:
ScriptName:Targetnameofthetemplate.
InstantiationTime:Timetakentoinstantiatethetemplate.
ExecutionTime:Timetakentoexecutetheinstantiatedtemplate.
Time(%):Percentageofproducttopprocessingtimetakentoprocessthetemplate.
Status:Whetherornotthetemplatewassuccessfullyprocessed.
ExecutionSummary:Containsthesourceandtargetlocationsofthetemplateandtheexecutionreport
ofthescript.Thissummarycanbeviewedbyclickingonthescriptnamelinkinthedetailedreport.
AutoConfigcanberuninthe'profile'modebyissuingthefollowingcommand:
OnApplicationTier:
perl <AD_TOP>/bin/adconfig.pl contextfile=<CONTEXT_FILE> [product=<product_top>] profile

OnDatabaseTier:
perl <ORACLE_HOME>/appsutil/bin/adconfig.pl contextfile=<CONTEXT_FILE> [product=<product_top>] profile

5.3.CheckConfigUtility
TheCheckConfigutility(adchkcfg)hasbeenavailablesincethebasereleaseofOracleEBusinessSuiteRelease12.
ItisusedtoreviewtheconfigurationchangesthatwouldtakeeffectonanEBusinessSuiteinstanceduringthenext
AutoConfigrun.ItidentifiesthepotentialchangestoboththeFilesystemaswellastheDatabase.Itcanberunon
boththeapplicationstierandthedatabasetier.
Theutilityislocatedinthefollowinglocation:
Tier

Location

Application

<AD_TOP>/bin

Database

<ORACLE_HOME>/appsutil/bin

TheCheckConfigutilitymayberunbyexecutingthefollowingcommand:
OnUNIX

adchkcfg.sh contextfile=<CONTEXT_FILE>

OnWindows
adchkcfg.cmd contextfile=<CONTEXT_FILE>

ThisscriptgeneratesbothHTMLandtextreports.Thereportsprovideinformationaboutallfilechanges,profileoption
changesandotherimportantdatabaseupdatesthatwillbedoneduringthenextnormalexecutionofAutoConfig.The
reportconsistsoftwotabs:
FileSystemChanges(Seeascreenshot)
Thisreportisdividedintothefollowingsections:
AutoConfigContextFileChanges
Displaysinformationaboutthelocationofthecontextfile,thecontentofthecurrentlyactivecontextfile,
thecontentofthecontextfilethatwillbegeneratedinthenextAutoConfigrun.Inadditionitalso
displaysanHTMLreporthighlightingthedifferencesbetweenthecurrentandthenewcontextfile,ifany.
ServiceGroupStatus
DisplaysthestatusoftheServiceGroupsandthecorrespondingservicesontheapplicationstier.This
sectionispresentonlyinthereportgeneratedontheapplicationstier.
ChangedConfigurationFiles
DisplaysalistofallthefilesthatwillbechangedduringanAutoConfigexecution.Foreachfile,
informationisdisplayedaboutthelocationoftheruntimefile,thecontentofthecurrentlyactivefile,the
contentofthefilethatwillbegeneratedinthenextAutoConfigrun.Inaddition,anHTMLreporthighlights
thedifferencesbetweenthecurrentandthenewconfigurationfile,plusthelocationoftheAutoConfig
templatefile(ifapplicable).
NewConfigurationFiles
DisplaysalistofallthenewfilesthatwillbecreatedduringanAutoConfigexecution.Foreachfile,
informationisdisplayedaboutthelocationoftheruntimefile,thecontentofthenewfileandthelocation
oftheAutoConfigtemplatefile.
TemplateCustomizations
ThissectionhasbeenintroducedinOracleTechstackReleaseUpdatePack2for12.1.Itdisplaysalist
ofallcustomizedAutoConfigtemplatesandreportsthediffbetweentheoriginalAutoConfigtemplateand
thecustomizedtemplate.
DatabaseChanges(Seeascreenshot)
Thisreportisdividedintothefollowingsections:
ProfileValueChanges
DisplaysdetailsofonlythoseprofileswhosevaluewouldbechangedinthenextAutoConfigrun.For
eachsuchprofile,thecurrentvalueintheDatabase,thenewAutoConfigvaluethatwouldbesetforit,
theProfileLevelandthenameoftheAutoConfigscriptthatchangestheprofilevalueisdisplayed.
ProfileValues
DisplaysdetailsasinprevioussectionforallAppsDatabaseprofilesmanagedbyAutoConfig,
irrespectiveofwhethertheirvaluewouldchangeornotinthenextAutoConfigrun.
OtherDatabaseupdates
Displaysdetailsforimportantdatabaseupdates(nonprofilechanges)thatwillbedoneinthenextrunof
AutoConfig.Thetablename,columnname,thecurrentcolumnvalueintheDatabaseandthenew
AutoConfigvalueisdisplayedalongwiththenameoftheupdatingAutoConfigscriptandabrief
description.
Thescriptalsocreatesazipfilereport"ADXcfgcheck.zip"thatcontainsallthefilesandreportsmentionedabove.The
ADXcfgcheck.zipcanbecopiedtoalocaldesktopPCandtheHTMLreportcanbeviewedtherewithoutbreakingthe
hyperlinksinthereport.
5.4.ContextVariableInformationUtility
TheTXKContextVariableInformationutilitywasintroducedinTXK12.0.4ConsolidatedPatch.
Thiscommandlineutilitycanbeusedtofindoutdetailedinformationaboutcontextvariablesandthetemplatesin
whichtheyareused.TheutilityacceptsallorpartofacontextvariablenameandgeneratesanHTMLortextreport

containinginformationaboutthematchedcontextvariablesthevariabledescriptions,defaultandcurrentvalues.The
variabledescriptioncontainsrecommendedsettings,rangeofallowedvaluesandlinkstodocumentsfordetailed
usageinformation.Additionally,thisutilityliststheconfigurationtemplateswheretherespectivecontextvariablesare
used.Seeascreenshotofthegeneratedreport.
TheContextVariableInformationutilitycanbeexecutedasfollows:
1. SourcetheApplicationsenvironmentfileastheowneroftheapplicationtierfilesystem(APPLMGRuser).
2. Runthetechnologyvalidationutilityusingthefollowingsyntax:
OnApplicationsTier:
perl<FND_TOP>/bin/txkrun.plscript=GenCtxInfRepkeyword="<keyword>"

OnDatabaseTier:
perl<ORACLE_HOME>/appsutil/bin/txkrun.plscript=GenCtxInfRepkeyword="<keyword>"

Theutilitytakesthefollowingarguments:
contextfile(optional):completepathtothecontextfile.Bydefault,itissettothevalueof
<CONTEXT_FILE>
keyword(required):allorpartofacontextvariablename
reportType(optional):thereporttype.Validvaluesarehtml(default)ortext
outfile(required):thereportfile.Ifonlythenameandnotthecompletepathforthereportfileisprovided,
thereportwillbegeneratedinthe<APPLTMP>directory.

SECTION6:USINGAUTOCONFIGONANORACLERACINSTANCE
ThissectionguidesyouthroughthestepsthatneedtobeperformedwhenyourOracleRelease12instanceisrunning
onOracleRealApplicationClusters(OracleRAC).

Note:RefertoOracleMetaLinkNote388577.1forconvertingaRelease12singleinstancetoOracle
RAC,implementingAutoConfigwithOracleRAC,andimplementingloadbalancingofdatabase
connectionsonOracleRACforRelease12applicationtiers.

OracleEBusinessSuiteRelease12deliverstheinfrastructuretogenerateacompletetnsnames.orafilerequiredfor
OracleRAC.Thisincludes
Instancealiasesforeachdatabasetiernode
Loadbalancealiaseswithaddresslistsforeachdatabasetiernode
FNDSMandFNDFSaliases(usedbytheCPServiceManager)foreachapplicationtiernode
Virtualhostnamesupport
Thetnsnames.orafileisdynamicallygeneratedusingtheNetServicesTopologyDataModel.TheNetServices
TopologyDataModelstorestheentiretopologicalinformationaboutasingleOracleEBusinessSuiteenvironment.
Completethestepsinthissection(intheorderlisted)tosupportAutoConfigonOracleRAC:
1. ApplylatestTXKAutoConfigTemplatepatch
UpdatetheOracleApplicationsfilesystemwiththeAutoConfigfilesbyapplyingthelatestAutoConfigTemplate
patch(Patch9386653for12.0.XcustomersandPatch8919489for12.1.Xcustomers)toallapplicationtier
nodesinyoursystem.FollowtheinstructionsdescribedinSection3forapplyingthepatch.

2. Reviewinit.ora
AutoConfigwillnotoverwriteyourexistinginit.orafile.However,whennoinit.orafileexists,AutoConfigwill
generateaninit.orathatiscompatiblewithOracleRAC.Werecommendcreatingabackupoftheexisting
init.orafileandletAutoConfiggenerateanewinit.orafile.Thiswillensurethattheinit.orafileconformstothe
Oracle'sstandardsforexample,useofDB_Nameastheservicenameorhandlinglocalandremotelisteners.
3. MigrateAutoConfigPatchtotheDatabasetier
FollowthestepsinSection3tomigratetheAutoConfigPatchtothedatabasetier.
4. RunAutoConfigonallDatabasetiernodes
RunAutoConfigonalldatabasetiernodes.FollowtheinstructionsdescribedinSection2above.
Attention:Thedatabaseserverinstanceandthedatabaselistenermustremainavailable
duringtheAutoConfigrun.Alltheotherdatabasetierservicesshouldbeshutdown.
5. RunAutoConfigontheApplicationtier
RunAutoConfigoneachApplicationtier.Usetheadautocfg.sh/.cmdcommanddescribedinSection2.
Attention:Thedatabaseserverandthedatabaselistenermustremainavailableduringthe
AutoConfigrun.
6. Restartthedatabaselistener
Stopandrestartyourdatabaselistener.
YoursystemisnowAutoConfigenabledwithOracleRAC.RefertoSection2forinformationonmanagingsystem
configuration.

SECTION7:ORACLEEBUSINESSSUITESERVICES:PROCESSMANAGEMENT
ThissectiondescribeshowtomanagetheOracleEBusinessSuiteservicesthroughAutoConfig.
AsmentionedinSection2,ApplicationsservicesmustbeshutdownbeforerunningAutoConfigontheapplications
tier.AftercompletionoftheAutoConfigrun,theseservicesmayberestarted.Thescriptsadstrtal.sh/cmdand
adstpall.sh/cmdcanbeusedforthispurpose.
InApplicationsRelease12,theApplicationsserviceshavebeencategorizedintoservicegroups,accordingtothetype
ofserviceprovided.Aparticularservicewillbestartedorstoppedviatheadstrtaloradstpallscriptsonlyifboththe
serviceanditsservicegroupareenabled.
7.1.ModifyingAutoConfigManagedServicesandServiceGroups
DependingontherequirementofaparticularApplicationsinstance,itispossibletomodifythesetof
Applicationsservicesandservicegroupsthatwillbestartedandstoppedviatheadstrtal/adstpallscripts.
Thiscanbedonebyenablingtherequiredservicesandservicegroups,anddisablingthosethatarenot
needed.
a. CheckingwhetheraServiceGroup/Serviceisenabledordisabled
AcompletelistofthestatusofallServiceGroupsandServicesisavailableinSection2ofthe
reportgeneratedbytheCheckConfigutility(adchkcfg).Formoredetails,pleaserefertoSection
5.3.
Additionally,thelogfilesgeneratedbytheadstrtal/adstpallscriptsalsoprovideareport
containingalistoftheApplicationservicegroupsandtheservicesthataremanagedvia
AutoConfig.Thislistalsoreportswhetheraparticularservicegrouporserviceis'enabled'or

'disabled'.
b. EnablingorDisablingaServiceGroup
Checkthevalueofthe'status'contextvariablecorrespondingtotheservicegroup.
Changethevalueofthisvariableto'enabled'toenabletheservicegroup,orto'disabled'to
disabletheservicegroup.
c. EnablingaService
Checkthevalueofthe'status'contextvariablecorrespondingtotheservicegrouptowhich
theservicebelongs.
Iftheservicegroupis'disabled',enabletheservicegroupasdescribedabove.
Changethevalueofthe'status'contextvariablecorrespondingtotheserviceto'enabled'if
itisnotalreadysetto'enabled'.
d. DisablingaService
Checkthevalueofthe'status'contextvariablecorrespondingtotheservice.
Changethevalueofthisvariableto'disabled'ifitisnotalreadysetto'disabled'.
Forexample,performthefollowingstepstomanagetheservice'OracleMetricsServer'(partofthe
ServiceGroup'OtherServices')viaAutoConfig.
1. Checkthestatusoftheservicegroup'OtherServices'.
2. Incaseitis'disabled',changethevalueofthecontextvariable's_other_service_group_status'to
'enabled'.
3. Nextcheckthestatusoftheservice'OracleMetricsServer'.
4. Ifthestatusissetto'disabled',changethevalueofthecontextvariable's_metsstatus'to
'enabled'.
Note:FormoredetailsontheServiceGroupsandServicesinEBusinessSuiteRelease12,please
refertoMyOracleSupportKnowledgeDocument406558.1.
7.2.CommandstoManageOracleEBusinessSuiteServiceProcesses
a. CommandsformanagingprocessesontheApplicationstier
Theadstrtal/adstpallscriptscanbeusedtostart/stopallApplicationservicesmanagedbyAutoConfig.
Alternatively,itisalsopossibletoadministertheindividualservicesseparatelyusingtherespectiveservice
controlscripts.
Allscriptslistedbelowarelocatedin<INST_TOP>/admin/scripts.
Functionality

UNIXCommand

WindowsCommand

StartApplicationsservices

adstrtal.sh

adstrtal.cmd

StopApplicationsservices

adstpall.sh

adstpall.cmd

Startindividualservice

<control_script>
start

Stopindividualservice

<control_script>stop <control_script>

stop

<control_script>
start

Note:PleaserefertoSection3inMyOracleSupportKnowledgeDocument406558.1forthecontrolscript

namesfortherespectiveservices.
b. CommandsformanagingprocessesontheDatabasetier
Allthescriptslistedbelowarelocatedin
<RDBMS ORACLE_HOME>/appsutil/scripts/<CONTEXT_NAME>.

Functionality

UNIXCommand

WindowsCommand

Startdatabaselistenerprocess

addlnctl.shstart<SID>

addlnctl.cmdstart<SID>

Stopdatabaselistenerprocess

addlnctl.shstop<SID>

addlnctl.cmdstop<SID>

Startdatabaseprocess

addbctl.shstart

addbctl.cmdstart

Stopdatabaseprocess

addbctl.shstop

addbctl.cmdstop

Note:TomanageOracleConfigurationManager(OCM)processesrunningonanOracleEBusinessSuite
Release12instance,refertotheOCMdocumentation.OCMprocessesarenotmanagedbystandardservice
managementscriptssuchasadstrtal.shandadstpall.sh.

SECTION8:KNOWNISSUES
ThissectionlistsanyknownissueswiththeconfigurationmanagementofyourOracleEBusinessSuiteRelease12
environment.
1. OnaMultinodeinstallationwiththeFormsServicesandBatchProcessingServicesenabledon
separatenodes,OAMfailstoupdatethecontextvariablesontheBatchProcessingServicesnode
CheckwhethertheListenerServiceisupontheFormsServicesnode.Incasetheserviceisdown,startthe
serviceusingoneofthefollowingoptions:
a. StarttheTNSlistenerservicemanuallyusingthefollowingcommand:
OnUNIX
sh$INST_TOP/admin/scripts/adalnctl.shstart<TWO_TASK>

OnWindows
%INST_TOP%\admin\scripts\adalnctl.cmdstart<LOCAL>

a. EnablemanagementoftheTNSListenerServiceviatheadstrtal/adstpallscriptsontheFormsServices
node.
'Enable'theTNSListenerServicebyfollowingthestepsmentionedinSection7.
Stopallmiddletierservicesusingtheadstpall.sh/cmdscript.
Startupthemiddletierservicesusingtheadstrtal.sh/cmdscript.
2. AutoConfigfailstoexecuteontheWindowsItaniumplatform
Applytheoneoffpatch,6501658,whichdeliversthefixforthisissue.Customersneedtobeonatleastthe
12.0.2patchsetinordertoapplythisoneoffpatch.

SECTION9:FREQUENTLYASKEDQUESTIONS
9.1.OverviewandTerminology

1.
2.
3.
4.
5.
6.
7.
8.
9.

WhatisAutoConfig?
Whatisthedifferencebetweentheapplicationtierandthedatabasetier?
HowcanIidentifytheapplicationtierandthedatabasetierinamultinodesystem?
HowdoIconfigureAutoConfigforamultinodesystem?
WhatuserdoIloginastouseAutoConfiginatypicalmultinodesystem?
Whatdoestheterm"Contextname"mean?
Whatdoestheterm"ConfigHome"mean?
WhatarethebasiccomponentsofAutoConfig?
WhatarethedifferentAutoConfigscriptsandwhatdotheydo?

9.2.TheContextFile
1.
2.
3.
4.

WhatisthenamingconventionforApplicationsContextfile?
HowdoImakechangestotheApplicationsContextfile?
CanIuseadbldxml.pltogeneratecontextfilesinRelease12?
HowdoIrecovertheApplicationscontextfileifitislostordeletedaccidentally?

9.3.RunningAutoConfig
1.
2.
3.
4.
5.
6.

WhenshouldIrunAutoConfig?
WhichfilesandprofileoptionsarechangedwhenIrunAutoConfig?
WhereisthelogfilelocatedthatAutoConfigcreates?
Whichdirectoriesbasedonthe<Context_Name>willAutoConfigcreate?
Whatisthelocationofcontrolscriptsthatareusedtostarttheservices?
HowdoIrollbackanAutoConfigsession?

9.4.Customizations
1.
2.
3.
4.
5.
6.

HowdoIpreservecustomizationstoanAutoConfigmaintainedenvironment?
Whatare"CustomizableTemplates"?
Whatare"NonCustomizabletemplates"?
HowdoIdeterminewhetheritisa"Customizable/NonCustomizable"template?
Whatisthemechanismforsendingappsuser/passwordtoanewcustomtemplate?
WhatdoIdowhenapatchorOracledocumentationinstructsmetomanuallymodifyanAutoConfigmaintained
file?

9.5.PatchingAutoConfig
1. HowdoIgetthelatestchangestoAutoConfig?
2. HowdoIapplythelatestAutoConfigpatch?
9.6.NetServices
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.

WhatistheNetServicesTopologyDataModel?
WhenistheNetServicesTopologyDataModelseeded?
Whatmechanismisusedtogeneratethetnsnames.orafile?
HowdoIseedtheNetServicesTopologyDataModel?
WhendoIneedtoderegisteradatabasetieroranapplicationtier?
HowdoIderegisteranapplicationtierfromtheNetServicesTopologyDataModel?
HowdoIderegisteradatabasetierfromtheNetServicesTopologyDataModel?
WhendoIneedtopurgethecompleteNetServicesTopologyDataModel?
HowdoIpurgethecompleteNetServicesTopologyDataModel?
HowdoIseedtheNetServicesTopologyDataModelafterpurgingit?
IwanttoderegisteranapplicationtieroradatabasetierfromtheNetServicesTopologyDataModel.Ican'tuse
theadgentns.plbecauseIalreadydecommissionedthetierorremovedthecontextfile.HowcanIderegister
thetier?
12. IwanttopurgethecompleteNetServicesTopologyDataModel.Ican'tusetheadgentns.plscriptbecauseI
removedtherelevantcontextfile(s).HowcanIpurgetheDataModel?

13. HowdoIconfigureAutoConfigtogeneratethefailoveraliases?
14. ForwhichdatabaseversionscanIdefinefailoveraliases?
9.7.DatabaseConnectivity
1.
2.
3.
4.
5.

ShouldthedatabaseserverremainavailableduringtheAutoConfigrun?
Whatistheuseofthecontextvariables_apps_jdbc_connect_descriptor?
WhendoIneedtoreset(empty)thecontextvariables_apps_jdbc_connect_descriptor?
DoesAutoConfigsupportspfiles?
WhatstepsdoIneedtofollowtomaintainmydatabaseconnectivitywhenImigratemydatabasefromone
host/platformtoanother?
6. Imigratedmydatabasetiertoanewhost/platform,buttheapplicationtierstilltriestoconnecttotheold
database.HowcanIfixthissituation,sothattheapplicationtierconnectstothenewdatabase?
9.8.OracleRAC
1. MyRelease12instanceisconfiguredwithRAC.NowIwanttomigratetoAutoConfig.HowdoIachievethat?
2. MyRelease12instanceisconfiguredasnonRAC.NowIwanttomigratetoRACusingAutoConfig.What
stepsshouldIfollow?
3. IappliedalltherequiredRACpatches,butmyTWO_TASKvariablesstillpointtotheinstancealiases.How
canIpointthemtoloadbalancedaliases?
4. MyRACenvironmentusesanspfile.HowdoIensurethatmyspfileisinsyncwiththeinit.orafiles?
9.9.WindowsSpecificRequirements
1. WhatisthecorrectsettingforMSDEVDIR?
2. CanIusetheperlshippedbyMKStorunadconfig.cmdonWindows?
9.10.Troubleshooting
1. WhatshouldIdoifmyAutoConfigscriptexitswithnonzerostatus?
9.1.OverviewandTerminology
1)WhatisAutoConfig?
Answer:
AutoConfigisaconfigurationtoolthatautomatestheconfigurationofanOracleEBusinessSuiteinstance.The
informationrequiredforconfiguringanApplicationssystemiscollectedintoanXMLrepository,calledtheApplications
context.ThereisoneApplicationscontextforeachapplicationtier,andoneforeachdatabasetier.WhenAutoConfig
runs,itusesinformationfromtheApplicationscontextfiletogenerateallconfigurationfiles,andupdatedatabase
profiles.
BacktoFAQList
2)Whatisthedifferencebetweentheapplicationtierandthedatabasetier?
Answer:
Beforewecananswerthat,let'sdefineafewtermsinthecontextoftheRelease12architecture:
Aserveristhetraditionaltermforaprocessthatprovidesaparticularfunctionality.Thisterm,inthesenseofa
denotingasingleprocess,islessappropriateforsomecomponentsoftheRelease12architecture,inwhich
casethereplacementtermofserviceorservicegroupisused.
Anodeisalogicalgroupingofservers,andthereforefundamentallyasoftwareconceptratherthanahardware
concept,althoughitisoftenalsousedtorefertothemachineonwhichaparticularnodeisinstalled.
Atierisalogicalgroupingofserversorservices,potentiallyspreadacrossmorethanonephysicalmachine.

Nowlet'sanswerthequestion.
Theapplicationtier(sometimescalledthemiddletier)consistsofanumberofserversorservicesthatdefine
thesetofprocessesthatwillbestartedoneachapplicationnode,andcanbeactivatedordeactivated
accordingtothefunctionthenodeistoperform.TheseincludeFormsservices,Webservices,andBatch
Processingservices(ConcurrentProcessingserver).Akeyroleoftheseservicesistoprovidecommunication
betweenthedesktoptierandthedatabasetier.
Thedatabasetierconsistsofthedatabaseserver,whichstoresallthedataoftheRelease12systeminan
Oracledatabase.
TheprimarylocationofthefilesusedbytheapplicationtierserversistheAPPL_TOP,whereastheprimarylocationof
thefilesusedbythedatabasetierserveristheOracle10gORACLE_HOME.
BacktoFAQList
3)HowcanIidentifytheapplicationtierandthedatabasetierinamultinodesystem?
Answer:
Anodecansupportoneormoreservers(orservices),andcanthereforebelongtooneormoretiers.
Inasinglenodesystem,thatnodebelongstoboththeapplicationtierandthedatabasetier,sinceallserversare
containedonthatsinglenode.
Inamultinodesystem,eachnodesupportsoneormoreservers(orservices),andbelongstooneorbothtiers.Ifthe
nodeprovidesanyoftheapplicationtierservices,includingFormsservices,Webservices,orBatchProcessing
services(ConcurrentProcessingserver),thenthereisanAPPL_TOPonthenode,itbelongstotheapplicationtier,
andisconsideredanapplicationtierservernode.Ifthenodecontainsthedatabaseserver,whichmeansthatthereis
anOracle10gORACLE_HOMEandtheApplicationsdatabaseinstanceonthenode,thenthenodebelongstothe
databasetier,andisconsideredadatabaseservernode.
Let'sanalyzeacommonconfigurationwherethedatabaseserverandtheConcurrentProcessingserverexistonone
node(Node1),andtheotherserversexistonasecondnode(Node2).SinceNode1containsbothanapplicationtier
server(ConcurrentProcessingserver)andthedatabaseserver,Node1belongstoboththedatabasetierandthe
applicationtier.SinceNode2containsonlyapplicationtierservers,Node2belongsonlytotheapplicationtier.
BacktoFAQList
4)HowdoIconfigureAutoConfigforamultinodesystem?
Answer:
AutoConfigisenabledbydefaultoneveryapplicationtiernodeinOracleEBusinessSuiteRelease12.
BacktoFAQList
5)WhatuserdoIloginastouseAutoConfiginatypicalmultinodesystem?
Answer:
FornodesrunningWindows,thereisonlyoneuserthatownsboththeapplicationtierserversandthedatabase
server,soyouwouldloginasthatuser.
FornodesrunningUNIX(includingLinux),ifyouwanttoconfiguretheapplicationtierservers,loginastheuserthat
ownstheapplicationtierservers(oftenreferredtoastheapplmgruser).Ifyouwanttoconfigurethedatabaseserver,
loginastheuserthatownsthedatabaseserver(oftenreferredtoastheoracleuser).Notethattheapplmgruserand
theoracleusercanbethesameuser,ordifferentusers.
BacktoFAQList
6)Whatdoestheterm"<Context_Name>"mean?

Answer:
The"<Context_Name>"isthelogicalnameforyourcontextrepository.Thedefaultvaluefor<Context_Name>is
<SID>_<hostname>.
BacktoFAQList
7)Whatistheenvironmentvariable$INST_TOP?
Answer:
NewinRelease12,theInstanceTop($INST_TOP)isthecentrallocationforalltheinstancespecificinformation.The
locationispointedtobythecontextvariables_config_home.
BacktoFAQList
8)WhatarethebasiccomponentsofAutoConfig?
Answer:
Components

Location

ApplicationsContext Ontheapplicationtier:
<INST_TOP>/appl/admin

Onthedatabasetier:
<RDBMS ORACLE_HOME>/appsutil

Description
AnXMLrepository(<CONTEXT_NAME>.xml)
containsinformationspecifictothat
Applicationsinstance.
Donotmanuallyupdatethisfile!

AutoConfig
TemplateFiles

Ontheapplicationtier:
<PROD_TOP>/admin/template

Forexample:
<AD_TOP>/admin/template
<FND_TOP>/admin/template

Onthedatabasetier:

Includenamedtagswhicharereplacedwith
instancespecificinformationfromthe
ApplicationsContext.Thereisonetemplatefile
foreachconfigurationfile.
Forexample:
apps_nt.conf
apps_ux.conf

<RDBMS
ORACLE_HOME>/appsutil/template

AutoConfigDriver
File

Ontheapplicationtier:
<PROD_TOP>/admin/driver

Forexample:
<AD_TOP>/admin/driver/adtmpl.drv
<FND_TOP>/admin/driver/fndtmpl.drv

UsedbyAutoConfigtolisttheAutoConfig
TemplateFiles,theirdestinationlocations,and
thecommandstobeexecuted,forexample,
thecommandstoupdateprofileoptions.Every
ProductTopcontainsitsownAutoConfigDriver
File.

Onthedatabasetier:
<RDBMS
ORACLE_HOME>/appsutil/template

AutoConfigScripts

Ontheapplicationtier:
<AD_TOP>/bin

Onthedatabasetier:
<RDBMS ORACLE_HOME>/appsutil/bin

Provideasimplified
interfacetotheAutoConfigAPIs.
Forexample:
adautocfg.sh/ adautocfg.cmd
adconfig.sh/ adconfig.cmd

BacktoFAQList
9)WhatarethedifferentAutoConfigscriptsandwhatdotheydo?
Answer:
Thescriptsarelistedinthefollowingtable.
Note:.shscriptsareforUNIXusersand.cmdscriptsareforWindowsusers.

Scripts

Location

Description

adautocfg.sh

Ontheapplicationtier:

Awrapperscriptthatcalls

<INST_TOP>/admin/scripts

adconfig.sh/adconfig.cmd.Instantiatestemplate

adautocfg.cmd

fileswithvaluesspecifictotheinstance(takenfrom
theApplicationsfortheapplicationtierandthe
<RDBMS ORACLE_HOME>/appsutil/ databasecontextforthedatabasetier).Updates
scripts/<CONTEXT_NAME>
configurationfilesandprofileoptions.
Onthedatabasetier:

adconfig.sh
adconfig.cmd

Ontheapplicationtier:
<AD_TOP>/bin

Onthedatabasetier:
<RDBMS
ORACLE_HOME>/appsutil/bin/

adconfig.pl

Ontheapplicationtier:
<AD_TOP>/bin

Awrapperscriptthatcallsadconfig.pl.Inearlier
versionsofAutoConfigadconfig.sh/
adconfig.cmdusedtocalltheJavaAPItostart
AutoConfig.

AwrapperscriptthatcallstheJavaAPItostart
AutoConfig.

Onthedatabasetier:
<RDBMS
ORACLE_HOME>/appsutil/bin

adchkcfg.sh
adchkcfg.cmd

Ontheapplicationtier:
<AD_TOP>/bin

Onthedatabasetier:
<RDBMS
ORACLE_HOME>/appsutil/bin

Generatesareportthathighlightsdifferences
betweentheoriginalconfigfilesandAutoConfig
generatedconfigfiles.Thereportisnamed
cfgcheck.html.Itislocatedunder:
Ontheapplicationtier:
<INST_TOP>/admin/
/out/<MMDDhhmm>

Onthedatabasetier:
<RDBMS ORACLE_HOME>/appsutil/out/
<CONTEXT_NAME>/<MMDDhhmm>

BacktoFAQList
9.2.TheContextFile
1)Whatisthenamingconventionfortheapplicationtiercontextfile?
Answer:

Thedefaultnameforthecontextfileis<CONTEXT_NAME>.xml.
BacktoFAQList
2)HowcanImakechangestoacontextfile?
Answer:
InOracleApplicationsManager(OAM),navigatetoSiteMap.ClickonAutoConfig.ClickonEditParameterstoedit
therelevantcontextfile.
Attention:Manuallyeditingacontextfileisnotsupported.Manycontextvariableshave
dependenciesbetweeneachother.TheOAMAutoConfigresolvesallthesedependencies
whenchangingthevalueofavariable.Manuallyeditingthecontextfilecouldbringthe
dataintoaninconsistentstate.
BacktoFAQList
3)CanIuseadbldxml.pltogeneratecontextfilesinRelease12?
Answer:
Theadbldxml.plutilitycanbeusedtogeneratethecontextfileonthedatabasetieronly.Itiscommonlyusedwhen
migratingAutoConfigtoadatabasetiernotcreatedusingRapidInstallorwhenupgradingadatabasetierfrom
Applications11itoEBusinessSuiteRelease12.Thisutilityisnotsupportedontheapplicationstier.
BacktoFAQList
4)HowdoIrecovertheApplicationscontextfileifitislostordeletedaccidentally?
Answer:
TheApplicationscontextfilecanberetrievedbyrunningtheadclonectx.plscript.
Toretrievetheapplicationstiercontextfile,
Executethefollowingcommandontheapplicationstier.

perl<COMMON_TOP>/clone/bin/adclonectx.plretrieve

Onbeingpromptedforthecontextfiletoberetrieved,selecttheoptionofretrievingtheapplicationstiercontext
filethathasbeenlostandretrieveittothedefaultlocationspecifiedbythescript.
Theabovecommandcanbeusedonlywhenthe<INST_TOP>isstillintact.Incasethe<INST_TOP>hasalsobeen
lostaccidentally,theapplicationstiercontextfilemayberetrievedasfollows:
Executethefollowingcommandonthedatabasetier:
perl<ORACLE_HOME>/appsutil/clone/bin/adclonectx.plretrieve

Onbeingpromptedforthecontextfiletoberetrieved,selecttheoptionofretrievingtheapplicationstiercontext
filethathasbeenlost.
Whileconfirmingthelocationforthecontextfile,setittoanyexistingdirectorywithwritepermission.
Oncethecontextfilehasbeengeneratedinthespecifiedlocation,moveittothelocationspecifiedforthe
contextfileinthecontextvariable's_contextfile'.
Toretrievethedatabasetiercontextfile,

Executethefollowingcommandonthedatabasetier:
perl<ORACLE_HOME>/appsutil/clone/bin/adclonectx.plretrieve

Onbeingpromptedforthecontextfiletoberetrieved,selectthedatabasetiercontextfileandretrieveittothe
defaultlocationspecifiedbythescript.
BacktoFAQList
9.3.RunningAutoConfig
1)WhenshouldIrunAutoConfig?
Answer:
YoushouldrunAutoConfiginthefollowingcases:
Youmadeupdatestoacontextfile(viaOracleApplicationsManager).
AnOracleMetaLink noteinstructsyoutorunAutoConfigaspartofanupgrade,migration,cloningand/or
configurationprocess.
TheREADMEofanOraclepatchinstructsyoutorunAutoConfigaftertheapplicationofthepatch.
YouapplyanyADXproductpatch.
BacktoFAQList
2)WhichfilesandprofileoptionsarechangedwhenIrunAutoConfig?
Answer:
RuntheadchkcfgutilitytogetanHTMLreportthatlistsallthefilesandprofileoptionsthatgetchangedwhenyourun
AutoConfig.
Forinstructionsonhowtoruntheadchkcfgutilityandadiscussionaboutthereportthattheutilitygenerates,referto
Section5.3.
BacktoFAQList
3)WhereisthelogfilelocatedthatAutoConfigcreates?
Answer:
ThelogfilethatAutoConfigcreatesislocatedat:
Ontheapplicationtier:
<INST_TOP>/admin/log/<MMDDhhmm>/adconfig.log

Onthedatabasetier:
<RDBMS ORACLE_HOME>/appsutil/log/<CONTEXT_NAME>/<MMDDhhmm>/adconfig.log

where:<MMDDhhmm>=(month,day,hour,andminuteoftheAutoConfigrun)
BacktoFAQList
4)Whichdirectoriesbasedonthe<Context_Name>willAutoConfigcreate?
Answer:
AutoConfigcreatesthefollowingdirectoriesbasedonthe<CONTEXT_NAME>:
InstanceTop :<INSTALL_BASE>/inst/apps/<CONTEXT_NAME>

BacktoFAQList

5)Whatisthelocationofcontrolscriptsthatareusedtostarttheservices?
Answer:
Thecontrolscriptsforstarting/stoppingtheservicesarelocatedat<INST_TOP>/admin/scripts.Thislocationisalso
pointedbyanenvironmentvariable$ADMIN_SCRIPTS_HOME.
BacktoFAQList
6)HowcanIrollbackanAutoConfigsession?
Answer:
AllbackupconfigurationfilesfromeachAutoConfigsessionarestoredin:
Ontheapplicationtier:
<INST_TOP>/admin/out/<MMDDhhmm>

Onthedatabasetier:
<RDBMS ORACLE_HOME>/appsutil/out/<CONTEXT_NAME>/<MMDDhhmm>

where:<MMDDhhmm>=(month,day,hour,andminuteoftheAutoConfigrun)
Youcanrunrestore.sh (UNIX)orrestore.cmd (Windows)torollbackanAutoConfigsession.
BacktoFAQList
9.4.Customizations
1)HowdoIpreservecustomizationstoanAutoConfigmaintainedenvironment?
Answer:
RefertoSection4fordetailsonhowtoimplementcustomizations.
BacktoFAQList
2)Whatarecustomizabletemplates?
Answer:
ThesearetemplatestowhichcustomizationscanbeaddedandrecognizedbyAutoConfig.
BacktoFAQList
3)Whatarenoncustomizabletemplates?
Answer:
Thesearetemplatesthatdonotsupportcustomizations.Anycustomizationsdoneonthesetemplatesarenot
recognizedbyAutoConfig.
BacktoFAQList
4)HowcanIdeterminewhetheratemplateiscustomizableornoncustomizable?
Answer:

Ifakeyword"LOCK"ispresentattheendofthefileentryintherespectivedriver,thenitisanoncustomizable
template.Ifthe"LOCK"keywordisnotseen,thenthattemplatecanbecustomized.
Forexample:
fndadmin/templateapps_conf_1013.tmpINSTE8<s_ora_config_home>/10.1.3/Apache/Apache/conf
apps.conf600LOCK

Therefore,apps_conf_1013.tmpisanoncustomizabletemplate.
BacktoFAQList
5)WhatisthemechanismforsendingtheApplicationsusernameandpasswordtoanewcustomtemplate?
Answer:
InRelease11i,theAPPSusernameandpasswordwerepassedascommandlineargumentstothecallingscript.In
Release12,theAPPSusernameandpasswordarepassedviastandardinputinstead,toincreasesecurity.
BacktoFAQList
6)WhatdoIdowhenapatchorOracledocumentationinstructsmetomanuallymodifyanAutoConfig
maintainedfile?
Answer:
LogaServiceRequestwithOracleSupporttorequestincorporationofthemodificationintherelevantAutoConfig
template.
BacktoFAQList

9.5.PatchingAutoConfig
1)HowdoIobtainthelatestupdatestoAutoConfig?
Answer:
UpdatestoAutoConfigaredeliveredinTXKproductpatches,whichdeliverthepatchesforADXandTXKtemplatesas
wellasforAutoConfig.Patch9386653deliversthelatestTXKproductpatchesfor12.0.X.Patch8919489containsthe
latestTXKproductpatchesfor12.1.Xcustomers).
BacktoFAQList
2)HowdoIapplythelatestAutoConfigpatch?
Answer:
InordertoapplythelatestAutoConfigTemplatepatch(Patch9386653for12.0.XcustomersandPatch8919489for
12.1.Xcustomers),performthestepsintheorderlistedinSection3.Thispatchisrequiredonlyfor12.0.X.
BacktoFAQList
9.6.NetServices
1)WhatistheNetServicesTopologyDataModel?
Answer:
TheNetServicesTopologyDataModelstorestheentiretopologicalinformationaboutasingleOracleEBusiness

Suiteinstance.ThedatamodelstoresinformationabouteachnodeintheOracleEBusinessSuiteinstance,whichis
thenusedtogenerateNetServiceconfigurationfilessuchastnsnames.ora.
TheNetServicesTopologyDataModelstoresthefollowinginformation:
Databasetier:Hostname,DatabaseSID,DatabaseName,InstanceName,TNSDescriptors
Applicationtier:Hostname,FNDFSandFNDSMaliasdescriptors
AutoConfigseedsthedatamodelwithrelevantdata.
BacktoFAQList
2)WhenistheNetServicesTopologyDataModelseeded?
Answer:
TheNetServicesTopologyDataModelisseeded(updated)everytimeyourunAutoConfigontherespectivetier.Every
timeyourunAutoConfigonthedatabasetier,therelevantdataisseededforthedatabasetier.Everytimeyourun
AutoConfigontheapplicationtier,therelevantdataisseededfortheapplicationtier.
BacktoFAQList
3)Whatmechanismisusedtogeneratethetnsnames.orafile?
Answer:
AutoConfigrunstheadgentns.plscriptthatdynamicallygeneratesthetnsnames.orafile.Thisscriptwasintroducedto
supportenhancedconfigurationscenariossuchasOracleRAC.
BacktoFAQList
4)HowdoIseedtheNetServicesTopologyDataModel?
Answer:
TheNetServicesTopologyDataModelcanbeseededbyrunningAutoConfigonthedatabasetier,thenthe
applicationtier.AlsoseeQuestion2.
BacktoFAQList
5)WhendoIneedtoderegisteradatabasetieroranapplicationtier?
Answer:
YouhavetoderegisteratierfromtheNetServicesTopologyDataModelinoneofthefollowingcases:
Youwanttodeleteanapplicationtier
Yourdatabaseisupgraded/migratedresultinginachangeinoneofthefollowingparameters:
DatabaseHost
DatabasePort
DatabaseName
DatabaseSID
Youshouldderegisterthetierbeforethetierisdecommissioned.
BacktoFAQList
6)HowdoIderegisteranapplicationtierfromtheNetServicesTopologyDataModel?
Answer:
ToderegisterthecurrentapplicationtierfromtheNetServicesTopologyDataModel,invokethefollowingcommand:

perl<AD_TOP>/bin/adgentns.plcontextfile=<CONTEXT_FILE>removeserver

BacktoFAQList
7)HowdoIderegisteradatabasetierfromtheNetServicesTopologyDataModel?
Answer:
ToderegisterthecurrentdatabasetierfromtheNetServicesTopologyDataModel,invokethefollowingcommand:
perl<RDBMSORACLE_HOME>/appsutil/bin/adgentns.plcontextfile=<CONTEXT_FILE>removeserver

BacktoFAQList
8)WhendoIneedtopurgethecompleteNetServicesTopologyDataModel?
Answer:
YouneedtopurgethecompleteNetServicesTopologyDataModelwhenthedatabasenameischangedasaresultof
adatabaseupgradeormigration.
BacktoFAQList
9)HowdoIpurgethecompleteNetServicesTopologyDataModel?
Answer:
TopurgethecompleteNetServicesTopologyDataModel,runthefollowingcommand:
perl<AD_TOP>/bin/adgentns.plcontextfile=<CONTEXT_FILE>removesystem

BacktoFAQList
10)HowdoIseedtheNetServicesTopologyDataModelafterpurgingit?
Answer:
SeeQuestion4above,"HowdoIseedtheNetServicesTopologyDataModel?".
BacktoFAQList
11)IwanttoderegisteranapplicationtieroradatabasetierfromtheNetServicesTopologyDataModel.Ican't
usetheadgentns.plscriptbecauseIalreadydecommissionedthetierorremovedthecontextfile.HowcanI
deregisterthetier?
Answer:
InthiscaseyoucanusethePL/SQLAPI.Performthefollowingstepsintheorderlisted:
1. Locatethesystemname:
Thesystemnameisthedatabasename
ObtainitbyrunningthefollowingSQLquery:
selectDB_NAMEfromFND_DATABASES

2. Locatetheservernamecorrespondingtothetierinquestion:
RunthisSQLqueryonthedatabasetier:

selectNAME,SERVER_TYPEfromFND_APP_SERVERS,FND_NODES
whereFND_APP_SERVERS.NODE_ID=FND_NODES.NODE_IDand
SERVER_TYPE='DB'andFND_NODES.NODE_NAME=upper('hostname')

RunthisSQLqueryontheapplicationtier:
selectNAME,SERVER_TYPEfromFND_APP_SERVERS,FND_NODES
whereFND_APP_SERVERS.NODE_ID=FND_NODES.NODE_IDand
SERVER_TYPE='APPS'andFND_NODES.NODE_NAME=upper('hostname')

3. RunthefollowingPL/SQLblock:
begin
FND_NET_SERVICES.remove_server(SYSTEM_NAME,SERVER_NAME)
end
/
commit
/

BacktoFAQList
12)IwanttopurgethecompleteNetServicesTopologyDataModel.Ican'tusetheadgentns.plscriptbecauseI
removedtherelevantcontextfile.HowcanIpurgetheDataModel?
Answer:
Inthiscase,youcanusethePL/SQLAPI.Performthefollowingstepsintheorderlisted:
LocatetheSystemName:
TheSystemnameisthedatabasename
ObtainitbyrunningthefollowingSQLquery:
selectDB_NAMEfromFND_DATABASES

RunthefollowingPL/SQLblock:
begin
FND_NET_SERVICES.remove_system(SYSTEM_NAME)
end
/
commit
/

BacktoFAQList
13)HowdoIconfigureAutoConfigtogeneratefailoveraliases?
Answer:
Togeneratethefailoveraliases,updatethedatabasetiercontextvariables_alt_service_instances.
Youcanspecifyacommaseparateddescriptionlistof"servicename:instance"tomanageconnecttimefailover.For
example:
'SERVICE_NAME:INSTANCE_NAME1,SERVICE_NAME:INSTANCE_NAME2'

ThiswillgenerateaTNSaliasinthetnsnames.orafilethatfailsovertoINSTANCE_NAME1whenthecurrentinstance
isnotavailable.IfINSTANCE_NAME1isnotavailable,failoveristoINSTANCE_NAME2instead.
Tosetupthefailoverlisting,performthefollowingstepsintheorderlisted:
1. Updatethecontextvariables_alt_service_instancesinthedatabasetiercontextfile,applyingthefailoverrules
asdescribedabove
2. RunAutoConfigonalldatabasetiers
3. RunAutoConfigonallapplicationtiers
ThesestepswillgeneratethefailoverTNSalias<INSTANCE_NAME>_FOwithadescriptionlistasconfiguredin
s_alt_service_instances.Beforeyoucanusethesealiases,youwillhavetosetthetwotaskvariables_tool_twotask.
Checkthequestion"ForwhichdatabaseversionscanIdefinefailoveraliases"forinformationabouttheavailabilityof
failoveraliasesondifferentdatabaseversions.
Note:Thegeneratedalias<INSTANCE_NAME>_FOcanonlybeusedforfailover.
BacktoFAQList
14)ForwhichdatabaseversionscanIdefinefailoveraliases?
Answer:
Youcangeneratefailoveraliasesforalldatabaseversionsthatare8.1.7.4orhigher.OracleEBusinessSuiteRelease
12usestheOracle10gRelease2database.
BacktoFAQList
9.7.DatabaseConnectivity
1)DoesthedatabaseserverneedtobeavailableduringtheAutoConfigrun?
Answer:
Yes.ThedatabaseserveranddatabaselistenermustremainavailablewhenAutoConfigisrunoneitherthedatabase
tierorapplicationtier.
BacktoFAQList
2)Whatisthepurposeofthecontextvariables_apps_jdbc_connect_descriptor?
Answer:
s_apps_jdbc_connect_descriptorstorestheconnectstringusedforallJDBCconnections.Thevalueforthiscontext
variableisgeneratedbyAutoConfig.
Whenthevalueisreset(empty),AutoConfigtriestoconnecttothedatabaseusingthes_dbSid,s_dbhostand
s_dbportcontextvariables.Seenextquestion.
BacktoFAQList
3)WhendoIneedtoreset(empty)thecontextvariables_apps_jdbc_connect_descriptor?
Answer:
Youshouldresetthevaluefors_apps_jdbc_connect_descriptortoanemptyvalue(""),whenoneofthefollowing
valueschanges:
DatabaseHost

DatabasePort
BacktoFAQList

4)DoesAutoConfigsupportspfiles?
Answer:
AutoConfigcurrentlydoesnotsupportspfiles.Itonlysupportstheinit.orafile.
BacktoFAQList
5)WhatstepsdoIneedtofollowtomaintainmydatabaseconnectivitywhenImigratemydatabasefromone
host/platformtoanother?
Answer:
Performthestepsintheorderlisted:
Beforethemigration:
1. DeregisterthedatabasetierfromtheNetServicesTopologyDataModel.Refertothequestion"HowdoI
deregisteradatabasetierfromtheNetServicesTopologyDataModel?"
Afterthemigration:
1. Resetthecontextvariables_apps_jdbc_connect_descriptorinthecontextfilefortheapplicationtierto
anemptystring.
2. Updatethecontextvariabless_dbhostands_dbportinthecontextfilefortheapplicationtiertoreflect
thenewvaluesinthemiddletiercontextfile.
BacktoFAQList
6)Imigratedmydatabasetiertoanewhost/platform,buttheapplicationtierstilltriestoconnecttotheold
database.HowcanIfixthissituation,sothattheapplicationtierconnectstothenewdatabase?
Answer:
YourolddatabasetierisstillregisteredintheNetServicesTopologyDataModel.Performthefollowingsteps:
Youhavetocleanupthedatamodelbyfollowingthestepsdescribedinthequestion:"HowdoIpurgethe
completeNetServicesTopologyDataModel?".
Performthestepdescribedinthequestion:"HowdoIseedtheNetServiceTopologyDataModel?"
BacktoFAQList
9.8.OracleRAC
1)MyRelease12instanceisconfiguredwithOracleRAC.NowIwanttomigratetoAutoConfig.HowdoI
achievethat?
Answer:
AutoConfigisalreadyenabledbydefaultinyourRelease12instance.
BacktoFAQList
2)MyRelease12instancedoesnotcurrentlyutilizeOracleRAC.IwanttomigratetoOracleRACusing
AutoConfig.WhatstepsshouldIfollow?
Answer:
TomigrateanOracleEBusinessSuiteRelease12instancetoOracleRAC,followtheinstructionsdescribedin

Document388577.1:UsingOracle10gRelease2RealApplicationClustersandAutomaticStorageManagementwith
OracleEBusinessSuiteRelease12.
BacktoFAQList
3)IappliedalltherequiredOracleRACpatches,butmyTWO_TASKvariablesstillpointtotheinstance
aliases.HowcanIpointthemtotheloadbalancedaliases?
Answer:
Updateyourapplicationtiercontextfileandsetthevaluesofthefollowingcontextvariablestothedesiredload
balancedaliasnames:
s_tools_twotask
s_weboh_twotask
BacktoFAQList
4)MyRACenvironmentusesanspfile.HowdoIensurethatmyspfileisinsyncwiththeinit.orafiles?
Answer:
OnaRACenvironment,AutoConfigcreatesthefollowinginit.orafilescontainingvaluesfordatabaseparameters:
init<s_dbSid>.ora:ThisfilecontainsdatabaseparametersspecifictoRACconfiguration.
<s_dbSid>_APPS_BASE.ora:Thisfilecontainsgenericdatabaseparametersthatareapplicableforbothnon
RACandRACconfigurations.
Anyadditionaldatabaseparametervaluesmaybesetbyspecifyingthemintheifile.Thelocationoftheifileis
specifiedbythecontextvariable's_init_ifile'.
Performthefollowingstepstosyncupthespfilewiththeinit.orafiles.
Case1:Tosyncupthespfilewiththenewinit.orafilescreatedbyrunningAutoConfig
1. Generatethepfilefromtheexistingspfilebyexecutingthefollowingcommandinthedatabase.
SQL>createpfile='<pfile_name>'fromspfile

Note:The<pfile_name>providedshouldbedifferentfrominit<s_dbSid>.ora.Otherwise,itwould
overwritetheexistinginit<s_dbSid>.orafilegeneratedinthelastAutoConfigrun.
2. Movetheexistinginit<s_dbSid>.orafileand<s_dbSid>_APPS_BASE.orafilestosomeotherlocation.
ThisisrequiredsinceAutoConfigwillcreatenewinit.orafilesonlyiftheyarenotalreadypresent.
3. RunAutoConfigtocreatethenewinit<s_dbSid>.oraand<s_dbSid>_APPS_BASE.orafiles.
4. Diffthepfile<pfile_name>withtheinit<s_dbSid>.oraandthe<s_dbSid>_APPS_BASE.orafilestoview
thecustomizationsdoneinthespfile.
5. Ifthevaluesofanyoftheparametersdefinedintheinit<s_dbSid>.oraor<s_dbSid>_APPS_BASE.ora
filehavebeencustomizedinthespfile,updatethosevaluesinthecorresponding.orafiles.
6. Ifanynewparametershavebeenintroducedinthespfile,addentriesforthoseparametersintotheifile.
Thelocationoftheifileisspecifiedbythecontextvariable's_init_ifile'.
7. InordertocreateanewspfilewiththelatestAutoConfigchanges,movetheexistingspfiletosomeother
location.
8. Shutdownthedatabaseandstartitagain.
9. Connecttothedatabaseandcreatethenewspfileusingthefollowingcommand:
SQL>createspfilefrompfile

ThiswillcreatethespfilecontainingthelatestAutoConfigchangesaswellastheexisting
customizations.
10. ShutdownthedatabaseandstartitagainforthenewspfilelocationtobereflectedintheDatabase.
Case2:Tosyncupthespfilewiththeexistinginit.orafiles
Performsteps1through10asmentionedinCase1,skippingsteps2and3forgenerationofnewinit.orafiles.
BacktoFAQList

9.9.WindowsSpecificRequirements
1)WhatisthecorrectsettingforMSDEVDIR?
Answer:
UsethepathtotheVCdirectoryfromyourVisualStudio2005installation.Thevcvars32.batfileexistsunderthe
VC\bindirectory.
Forexample:MSDEVDIR=C:\VS2005\VCwherevcvars32.batexistsunderC:\VS2005\VC\bin
BacktoFAQList
2)CanIusetheperlshippedbyMKStorunadconfig.cmdonWindows?
Answer:
No.TheperlshippedbyMKSisnotcertified.UsetheperlavailableinyourApplicationsenvironment(ASforthe
applicationtier,10gforthedatabasetier)ordownloadActivePerlfromperl.com.PerlhastobeinthePATHinorderfor
AutoConfigtorun.
BacktoFAQList
9.10.Troubleshooting
1)WhatshouldIdoifmyAutoConfigscriptexitswithnonzerostatus?
Answer:
IfAutoConfigexitswithnonzerostatus,opentheadconfig.logandcheckforthereportederrors:
Errorsintheinstantiationphase:Checktoseeifthetemplatefileslistedintheerrorsummaryexistinyour
filesystem.Iftheydonotexist,theremaybeaproblemwiththeAutoConfigfiledriveroftheproduct.Report
theproblemtoOracleSupport.Ifthetemplatefilesexist,checkforpermissionissues.Ifyoucannotfixthe
issue,reporttheproblemtoOracleSupport.
ErrorencounteredintheSETUP/PROFILE/APPLYphase:Checktheadconfig.logfiletoseethereasonfor
thefailure.Ifyoucannotfixtheissue,reporttheproblemtoOracleSupport.
Note:Refertothequestion"WherearethelogfilesthatAutoConfigcreates?"forthelocationofthelogfile.
BacktoFAQList

APPENDIXA:SPECIFICATIONFORAUTOCONFIGDRIVERFILESYNTAX
ThecontentforAutoConfigdriverfilesiswelldefined.EveryfileyouwantAutoConfigtoinstantiateneedsanentryin
theAutoConfigdriverfile.Entriesconsistof<TAB>or<SPACE>separatedfields.Thefollowingtableliststhefields
andtheircontents.

FieldName

Description

ProductName

Specifiestheshortnamefortheproduct

AutoConfig
template
directory

DirectoryunderneaththeproducttopthathoststheAutoConfigtemplatefile

AutoConfig
templatefile

NameofthetemplatefiletobeprocessedbyAutoConfig

Action

ActionthatAutoConfigperformsontheAutoConfigtemplatefile.Possiblevaluesare:
INSTE8>AutoConfiginstantiatesthetemplateeachtimeitisrun.
INSTE8_SETUP>Inadditiontoinstantiating,executetheresultingconfigurationfileduring
theSETUPPhaseofeachrunofAutoConfig.
INSTE8_PRF>Inadditiontoinstantiating,executetheresultingconfigurationfileduringthe
PROFILEPhaseofeachrunofAutoConfig.
INSTE8_APPLY>Inadditiontoinstantiating,executetheresultingconfigurationfileduring
theAPPLYPhaseofeachrunofAutoConfig.
INSTALL>AutoConfiginstantiatesthetemplatefileonlyiftheresultingconfigurationfile
doesnotalreadyexist.
INSTALL_SETUP>Inadditiontoinstantiating,AutoConfigexecutestheresulting
configurationfileduringtheSETUPphaseiftheconfigurationfiledoesnotalreadyexist.
INSTALL_PRF>Inadditiontoinstantiating,AutoConfigexecutestheresulting
configurationfileduringthePROFILEphaseiftheconfigurationfiledoesnotalreadyexist.
INSTALL_APPLY>Inadditiontoinstantiating,AutoConfigexecutestheresulting
configurationfileduringtheAPPLYphaseiftheconfigurationfiledoesnotalreadyexist.

Configuration
directory

AutoConfigplacestheinstantiatedconfigurationfileinthisdirectory

Configuration
file

Nameoftheinstantiatedconfigurationfile

Configuration
filepermission
(UNIXonly)

AutoConfiggeneratestheconfigurationfilewiththeprovidedUNIXstylepermissions

Forexample,inthecaseofthedriverfileentry:
myadmin/templatemyTemplate.txtINSTE8<s_pt>myConfiguration.txt660

AutoConfigwouldinstantiatethetemplatefile<MY_TOP>/admin/template/myTemplate.txtandgeneratethe
configurationfilemyConfiguration.txtintothePortaldirectory(thePortaldirectoryisinstantiatedfrom<s_pt>)with660
(readandwriteforuserandgroup)permission.Nosupplementaryinformationisavailableatpresent.

APPENDIXB:SETTINGTHEPERL5LIBENVIRONMENTVARIABLEONTHEDATABASETIER
Bydefault,thePERL5LIBenvironmentvariableissettothefollowingontheDatabasetier:
<ORACLE_HOME>/perl/lib/5.8.3:<ORACLE_HOME>/perl/lib/site_perl/5.8.3:<ORACLE_HOME>/appsutil/perl

Butforaninstancewith11gR2Database,theperlversiononthedatabasetieris'5.10.0'.Sothevariable'PERL5LIB'
onthe11gR2databasetierneedstobesetasfollows:
exportPERL5LIB=<ORACLE_HOME>/perl/lib/5.10.0:<ORACLE_HOME>/perl/lib/site_perl/5.10.0:
<ORACLE_HOME>/appsutil/perl

CHANGELOG
Date

Description

Sep12,2012

AddedreferencetoOneoffPatch13742583.

June01,2011

ModifiedAppendixBwithcorrectvalueofPERL5LIBvariableonthedatabasetier.

July15,2010

AddedreferencetotheR12.TXK.B.DELTA.3(Patchset8919489).

Jun10,2010

AddedreferencetotheR12.TXK.A.DELTA.7(Patchset9386653).

Feb17,2010

AddedreferencetotheR12.TXK.B.DELTA.2(Patchset7651166).

Dec31,2009

AddedappendixregardingsettingthePERL5LIBvariableonthedatabasetier.

Nov04,2009

AddedinformationaboutthenewCheckConfigsection.

Oct19,2009

EnhancedSection3.2tohaveastepforrunningAutoConfigonanewlycreated
OracleHome.

Sep10,2009

ModifiedSection3.2Step3toclarifytheminimumsupportedjreversion.

Aug28,2009

AddednoteaboutTXKAutoConfigTemplatepatchnotbeingreleasedfor12.1.1
asofnow.

May14,2009

CorrectedtyposinSection2

Apr30,2009

Restructuredthedoc
EnhancedtheTableofContents
RestructuredandsplitSection2(SystemConfigurationandMaintenance)
intoSections2and3.
MovedtheSystemConfigurationcommandsintoSection7.
MovedtheAutoConfigtoolslistintoSection1.
MergedthecontentofSection6(AutoConfigonDatabasetier)intothe
newsectiononPatchingAutoConfig(Section3).
RenamedSection3(ApplicationServicesManagement)andmoveditto
Section7.

Apr09,2009

AddedanewsectionfortheAutoConfigfeaturesandtools.

Mar20,2009

AddedaclarificationnoteregardingOCMservicemanagement

Dec23,2008

UpdatedlinkstotheAutoConfigpatchtopointto12.0.6(R12.TXK.A.DELTA.6)
patchset.

Nov19,2008

Removedlinksto12.0.2(R12.TXK.A.delta.2)patchset.

July17,2008

MovedtheFAQonspfilestoagenericsection.

June19,2008

AddedSection6,"AutoConfigontheDatabasetier".

Jan21,2008

UpdatedreferencestothelatestAutoConfigPatch.

Dec11,2007

AddedaknownissueforWindowsItaniumcustomers.

Nov06,2007

AddedFAQregardingRACspfiles.

Oct18,2007

UpdatedreferencestothelatestAutoConfigPatch.

Oct03,2007

Modifiedinstructionsforsettingdefaultvalueofcustomproducttop.

July20,2007

Addedaknownissue.

July19,2007

AddedbackreferencestothelatestAutoConfigPatch.

May15,2007

RemovedreferencestothelatestAutoConfigpatchuntilnextpatchrelease.

Feb19,2007

Modifiedthenameofthecustomcontextvariable.AlsomodifiedtheFAQon
retrievalofcontextfile.

Jan24,2007

Initialcreation.

Note387859.1byOracleEBusinessSuiteDevelopment
Copyright2007,2008OracleCorporation

REFERENCES