Autoconfig In Oracle R12

Introduction to Autoconfig in oracle apps R12

-Autoconfig in oracle apps r12 is a tool that supports automated configuration of an Applications instance.
-Autoconfig tool is a set of scripts to centralize and simplify E-Business Suite configuration management.
-It does so by maintaining a central repository of E-Business Suite environment information in a context file(.xml) on each midtier.
-Run adconfig command to propagate changes to all the corresponding files.

How to run autoconfig in R12

-adbldxml.sh – Creates the Applications context file, e.g. .xml
-adchkcfg.sh – This script is used for analysis purpose. It generates a report that shows differences between the original configuration files and the AutoConfig generated configuration files.
-adconfig.sh – This script calls the Java API to run the AutoConfig engine, which instantiates template files with instance-specific details from the XML context file, updates configuration files and profile options.

Autoconfig Context file

-Context file contains all the variables and their values related to the files of tech stack, environment for managing the variables centrally.
-Context file is created under $APPL_TOP/admin with naming conventions as .xml using adbldxml.sh script.

Autoconfig template files

-Template files that include named tags, which are replaced with instance-specific information from the according Context (this process is called “instantiation”).
-The template files are located in the relevant product. For e.g. $_TOP/admin/template directories like adapcctl_ux.sh resides under $AD_TOP/admin/template

header_string=”$Header: adapcctl_ux.sh 115.50 2006/04/07 11:05:26 mmanku ship $”
prog_version=`echo “$header_string” | awk ‘{print $3}’`
program=`basename $0`
usage=”t$program {start|stop|status|graceful|restart|configtest|help}”#
# Make sure the logfile directory exists
#
if [ ! -d `dirname %s_apclog%` ]; then
mkdir -p `dirname %s_apclog%`
fi;
if [ ! -d `dirname %s_apclog_pls%` ]; then
mkdir -p `dirname %s_apclog_pls%`
fi;printf “n$program version $prog_versionn”

-It is used to store site-specific details for each product. It maintains the template info about an specific file as what it will contain. As above, varaible “”%s_apclog%” represnts a parameter value as defined in context file.

Autoconfig template Driver files

-Every product in the E-Business Suite maintains a driver file used by AutoConfig. The driver file lists the AutoConfig file templates and their destination locations.
-Used to tell AutoConfig how to build target files
-AutoConfig searches each /admin/driver directory,
Looking for the appropriate tmpl.drv files.
For example: adtmpl.drv,fndtmpl.drv

AutoConfig Scripts
A set of scripts that provide a simplified interface to the AutoConfig APIs.

How Autoconfig  works in R12

-First create the Context file using adbldxml.sh
-Provide the required parameter values in context file, like s_webport=8000.
-Run autoconfig using adconfig.sh
-Autoconfig engine scans the /admin/driver directory to find the “template Driver file ” like it reads “fndtmpl.drv” under $FND_TOP/ admin/driver to get the list of files to be created for this product. For example it gets httpd.conf to be created as
fnd admin/template httpd_ux.conf INSTE8 /Apache/Apache/conf httpd.conf
-from the above entry in driver file it also gets the “template filename“ as “httpd_ux.conf” to be used to create the httpd.conf file.
-For creating httpd.conf it reads the parameter from “httpd_ux.conf” and corresponding value from context file, for e.g for %s_webport% parameter it reads corresponding value from context file and replaces the parameter in the created httpd.conf file.

How to Implement Autoconfig in oracle apps R12

-Apply Autoconfig Patches
-Change ownership of the application tier ORACLE_HOME .It should be owned by applmgr
-Migrate Database tier to autoconfig
-Generate appsutil.zip using perl $AD_TOP/bin/admkappsutil.pl on admin tier as applmgr
-Copy appsutil.zip to $ORACLE_HOME on database tier
-unzip appsutil.zip
-Create context.xml file using adbldxml.sh on Database tier as oracle
-Generate diff Report using adcfgchk.sh and Analyze for differences.
-Perform pre-Autoconfig steps
-Run Autoconfig and do post Autoconfig Steps
-Migrate Application tier to autoconfig
-Create context.xml file using adbldxml.sh on Middle tier as applmgr
-Generate diff Report using adcfgchk.sh and Analyze for differences.
-Perform pre-Autoconfig steps
-Run Autoconfig and do post Autoconfig Steps
-Start applications using Autoconfig utilities.

Autoconfig – Startup Scripts

Start Application using following Autoconfig utilities.

cd $COMMON_TOP/admin/scripts/

Listener : lsnrctl start listener_
Apache : adapcctl.sh start
Form server : adfrmctl.sh start apps/pass
Conc. Man. : adcmctl.sh start apps/pass
Report Serv : adrepctl.sh start

Autoconfig also support some basic customization .For this it provides keywords
#Begin Customization

#END Customization.
The customized parameters can be included between these two keywords and Autoconfig will not overwrite these.

Autoconfig log file location in R12

Database Tier

Logs for the autoconfig are located:

RDBMS $ORACLE_HOME/appsutil/log/$CONTEXT_NAME/< timestamp >/adconfig.log
RDBMS $ORACLE_HOME/appsutil/log/$CONTEXT_NAME/< timestamp >/NetServiceHandler.log

Application Tier

Logs for the adconfig are located:
$INST_TOP/admin/log/< timestamp >/adconfig.log
$INST_TOP/admin/log/< timestamp >/NetServiceHandler.log

Related Articles

How to run Autoconfig in parallel
Steps to Run Autoconfig On R12 Application including both Database and Application Tier
Important Changes in Autoconfig R12.2
Oracle apps autoconfig templates location and How to customize the template for autoconfig files
R12.2/R12/11i Common log file locations
https://docs.oracle.com/cd/E18727_01/doc.121/e12841/T120505T120514.htm