What is Autoconfig? Autoconfig is a tool for configuring application instance.
What are the programs and program name involved in Auto Config? You can see perl,shell,cmd and java programs.
1.adconfig.pl- Its a main program which inturn call Java APIs for configuring appl instance.
args-appl context file location
2.adautocfg.sh/adautocfg.cmd-This program inturn calls adconfig.pl
args-apps password
3.adconfig.sh-This program again calls adconfig.pl
These three programs used for running Auto config.
4. adchgatname.pl - This program will validating the APPL_TOP name in context file .If the APPL_Top name is changed, then this utility will take care of storing the old APPL_TOP name in APPL_TOP/admin/ATName.txt.Adconfig.pl calls this program .
In Oracle Applications 11i & R12 (12i) all the configuration parameters are captured in two context files:
Application context file called the .xml contains the configuration information for the application tier & is located in $APPl_TOP/admin for each node of application tier.
Database context file called the .xml contains the configuration information for the database tier & is located in $ORACLE_HOME/appsutil/.
Details stored in the context file contains host names,domain name , directory structure, port numbers used ……
The AutoConfig feature of Oracle application manager(OAM) is used to update & manage context files.
Updating Context file
Suppose we want to update the active port from to 80 , for this we will edit the application context file as follows:
Step 1 :Start all services
$ $COMMON_TOP/admin/scripts//adstrtal.sh APPS/ Step 2 :log on to OAM & click site map.
Step 3:Click AutoConfig from the list of System Configuration features in the Administration tab.
Step 4 : Click the Edit Parameter button for the application tier context file to access the Context File Parameters page & then click the system tab.
Step 5 : Click the Focus icon (blue triangle) for oa_web_server. This expands oa_web_server and shows the web server related parameters.
Step 6:Update the WebPort (s_active_webport) parameter from <> to 80.
Step 7 : Save it & answer the tab.Then logout of OAM
AutoConfig Script
The autoconfig script uses information from the context file to generate all applications configuration files & updates database profiles. It is located in
Now we run the autoconfig script to reconfigure the oracle application system with the updated Applications context.
Step 1 : Stop all services
$ $COMMON_TOP/admin/scripts//adstpall.sh APPS/ Step 2:Run the autoconfig script, $adautocfg.sh & respond to the prompts.
Step 3:Check log files for any errors.log file for autoconfig is adconfig.log & is located in
/admin//log/MMDDhhmm/
Step 4: Restart all services :
$ $COMMON_TOP/admin/scripts//adstrtal.sh APPS/
Rolling back an autoconfig session
Each execution of AutoConfig creates a roll back script in case you want to revert back to the previous configuration settings. For this we perform the following steps:
Step 1 :Shut down all services:
$ cd $COMMON_TOP/admin/scripts/ $ adstpall.sh APPS/ Step 2:Restore AutoConfig session.
$ cd $APPL_TOP>/admin//out/MMDDhhmm
$ restore.sh
Step 3 : Restart all services:
$ $COMMON_TOP/admin/scripts//adstrtal.sh APPS/
Restoring the AutoConfig updated files and restarting the services allows you to log on to OAM.
Restoring the previous configuration
Now we run OAM AutoConfig to restore the Applications Context.
Step 1 :Log on to the Oracle Application Manager (OAM) & click site map.You will be able to log on but some services will be down.
Step 2: Click AutoConfig from the list of System Configuration features in the Administration tab.
Step 3 : Click the Show History button for the application tier context file to access the Context File History page.
Step 4 :Click the Show Differences from Current Configuration button to see the recently updated parameters & Select Restore Previous Value for the WebPort and DiscovererPort parameters.
Step 5 :Save & respond the tabs. Log out of OAM.
Step 6 :Shut down all services:
$ cd $COMMON_TOP/admin/scripts/ $ adstpall.sh APPS/ Step 7 :Run the AutoConfig script, adautocfg.sh & Respond to the prompts.
Step 8 : View the log file and check for any errors.
Step 9 : Restart all services:
$ $COMMON_TOP/admin/scripts//adstrtal.sh APPS/ Step 10 :Log on to the Oracle Application Manager (OAM)
If the status of some services appears to be down, click the Refresh icon to update the
status.
Related : Metalink Notes 218089.1 Autoconfig FAQ 165195.1 Using AutoConfig to Manage System Configurations with Oracle Applications 11i 387859.1 Using AutoConfig to Manage System Configurations in Oracle Applications Release 12 270519.1 Customizing an AutoConfig Environment 364927.1 How To Run Autoconfig On Database Tier (DB-Tier) 341322.1 How to change the hostname of an Applications Tier using AutoConfig 338003.1 How to change the hostname and/or port of the Database Tier using AutoConfig 315674.1 How To Verify if Autoconfig is Enabled on 11.5.x 391406.1 How to get a clean Autoconfig Environment
Autoconfig is method of configuring Oracle Applications . All the information required to configure Oracle Apps 11i is stored in file called as Context file.Context file is repository for configuration stored in xml format.
What are different Contexts file Autoconfig in 11i ?
There are two context files, one for database tier called as Database Context second for Application tier called as Application Context.
What is location of Contexts file in 11i ?
Database Context file is under Database $ORACLE_HOME/appsutil/_.xml
Application Context file is under $APPL_TOP/admin/_.xml
How to run Autoconfig in 11i ?
You will use script adautocfg.sh (on both Database tier and & Application tier).
Where to check log files after autoconfig is executed ?
On database tier its under $ORACLE_HOME/appsutil/log/$CONTEXT_NAME/MM_DD_YYYY/adconfig.log
On Application tier its under $APPL_TOP/admin/$CONTEXT_NAME/log/MMDDYYYY/adconfig.log
where CONTXT_NAME is _
What if my Context file itself is corrupted, Can I create one ?
Yes you have utility called adbldxml to build Context File.
How to change some parameter in Context/xml file ?
If you are an expert then you can open xml file via any editor & change it but is recommending to use Context Editor or if you are on OAM.H or higher then use OAM (Oracle Application Manager) to change context file.
When should I run AutoConfig?
You should run AutoConfig in the event of the following cases:
You did updates to your Applications Context file.
An Oracle Metalink Note instructs you to run AutoConfig as part of an upgrade, migration, cloning and/or configuration process.
The Readme of an Oracle patch instructs you to run AutoConfig after the application of the patch.
You apply any ADX Product patch.
Which files / profile options get changed when I run AutoConfig?
Run the adchkcfg utility to get an html report that lists all the files and profile options that get changed when you run AutoConfig.
adchkcfg.sh scripts reside in $AD_HOME/bin and output generate in $APPL_TOP/admin/$CONTECT_NAME/out/
How can I roll back an AutoConfig session?
All backup configuration files from each AutoConfig session are stored in:
On the application tier: /admin//out//
On the database tier: /appsutil/out///
Inside these directories, there will be several files which autoconfig has taken a backup off before making changes. Also there will be a script restore.sh.
You can run restore.sh (Unix) or restore.cmd (Windows) to roll back an AutoConfig session.
How to run AutoConfig in TEST mode?
We can run autoconfig in test mode. This will reduce the risk and we can understand the impact better. We use adchkcfg.sh scripts it willl create a report which will list all files & profile options that is going to change when you run AutoConfig.
Below is the sample run for the same.
$ adchkcfg.sh Enter the full path to the Applications Context file: /PRODAPPL/ADMIN/PROD.xml
......
......
After execution of autoconfig is run on test mode, it will generate a zip file (ADXcfgcheck.zip). You can copy the zip file to $OA_HTML location and unzip the same. You can then view the report using following URL
Autoconfig is tool to configure oracle Applications 11i, Application Tier as well Database Tier.
If you want to configure database tier then you have to execute adautocfg.sh script on database tier.
If you want to configure on application tier then you have to execute adautocfg.sh on application tier.
You can find adautocfg.sh script for Database tier in $ORACLE_HOME/appsutil/scripts/$CONTEXT_NAME and for Application tier in $COMMN_TOP/admin/scripts/$CONTEXT_NAME
