Autoconfig In Oracle Apps R12

Table of Contents

Introduction to Autoconfig in oracle apps R12

Autoconfig in oracle apps r12 is a tool that supports the 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 mid-tier.

Run the 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 purposes. 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, and 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 a specific file as what it will contain. As above, the variable “%s_apclog%” represents a parameter value as defined in the 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 the 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 the driver file 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 the corresponding value from the context file, e.g for the %s_webport% parameter it reads the corresponding value from the 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 the 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 the database tier
unzip appsutil.zip

Create context.xml file using adbldxml.sh on Database tier as an oracle
Generate diff Report using adcfgchk.sh and Analyze for differences.
Perform pre-Autoconfig steps

Run Autoconfig and do post Autoconfig Steps
Migrate the 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 the Application using the 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 supports 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

R12 Autoconfig phases

Here are the phases for Autoconfig

 # There are five phases which autoconfig recognizes and performs in 
order.
# They are in order
# INSTALL ( Instantiate the template during Install )
=> if the file exists, do not replace it

 # INSTE8 ( To instantiate files )
=> create new files from templates, files marked as INSTALL in driver 
files will not be instantiated


# INSTE8_SETUP ( Instantiate and run in setup phase )
=> executing scripts after instantiation phase

# INSTE8_PRF ( Instantiate and run in profiles phase )
=> profiles phase mostly consists of running scripts to update profile 
options

# INSTE8_APPLY ( Instantiate and run in apply phase )
Services phase
=> updating of AD_APPL_TOPS table with accurate informatio

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