![Page 1: Anatomy of Autoconfig in Oracle E-Business Suite](https://reader033.vdocuments.net/reader033/viewer/2022061206/54821005b479590f0d8b468d/html5/thumbnails/1.jpg)
Anatomy of AutoconfigSession# 12112
Vasu Balla
The Pythian Group
![Page 2: Anatomy of Autoconfig in Oracle E-Business Suite](https://reader033.vdocuments.net/reader033/viewer/2022061206/54821005b479590f0d8b468d/html5/thumbnails/2.jpg)
About Me
Oracle Apps DBA with 10+ Years of ExperienceOracle Apps ATG Customer Advisory Board Member since 2012Oracle EBS Cluster Technical Lead at Pythian
@vasuballa
![Page 3: Anatomy of Autoconfig in Oracle E-Business Suite](https://reader033.vdocuments.net/reader033/viewer/2022061206/54821005b479590f0d8b468d/html5/thumbnails/3.jpg)
• Recognized Leader:
Global industry-leader in remote database administration services and consulting for Oracle, Oracle Applications, MySQL and Microsoft SQL Server
Work with over 250 multinational companies such as Forbes.com, Fox Sports, Nordion and Western Union to help manage their complex IT deployments
• Expertise:
Pythian’s data experts are the elite in their field. We have the highest concentration of Oracle ACEs on staff - 10 including 3 ACE Directors—and 2 Microsoft MVPs.
Pythian holds 7 Specializations under Oracle Platinum Partner program, including Oracle Exadata, Oracle GoldenGate & Oracle RAC
• Global Reach & Scalability:
Around the clock global remote support for DBA and consulting, systems administration, special projects or emergency response
About Pythian
![Page 4: Anatomy of Autoconfig in Oracle E-Business Suite](https://reader033.vdocuments.net/reader033/viewer/2022061206/54821005b479590f0d8b468d/html5/thumbnails/4.jpg)
Agenda
•Internals of Autoconfig
•Best Practices
•Advanced features of Autoconfig
![Page 5: Anatomy of Autoconfig in Oracle E-Business Suite](https://reader033.vdocuments.net/reader033/viewer/2022061206/54821005b479590f0d8b468d/html5/thumbnails/5.jpg)
What is Autoconfig?
•11i/R12 tool to configure E-Business Suite Environment
•Controls all configuration files of DB, Apps Techstack & Apps profile options
•Available for all version of 11i & R12
![Page 6: Anatomy of Autoconfig in Oracle E-Business Suite](https://reader033.vdocuments.net/reader033/viewer/2022061206/54821005b479590f0d8b468d/html5/thumbnails/6.jpg)
Autoconfig Components
•Context files
•Template files
•Drivers
•Autoconfig scripts
![Page 7: Anatomy of Autoconfig in Oracle E-Business Suite](https://reader033.vdocuments.net/reader033/viewer/2022061206/54821005b479590f0d8b468d/html5/thumbnails/7.jpg)
Context File•XML repository of configuration related
information
•A XML file for each application and database node
•XML files location
APPS: <INST_TOP>/appl/admin/<CONTEXT_NAME>.xml
DB: <RDBMS_ORACLE_HOME>/appsutil/<CONTEXT_NAME>.xml
![Page 8: Anatomy of Autoconfig in Oracle E-Business Suite](https://reader033.vdocuments.net/reader033/viewer/2022061206/54821005b479590f0d8b468d/html5/thumbnails/8.jpg)
•Contains named tags
•Are replaced with actual values during autoconfig run
•Default Location
<PROD_TOP>/admin/template
<RDBMS ORACLE_HOME>/appsutil/template
Template files
![Page 9: Anatomy of Autoconfig in Oracle E-Business Suite](https://reader033.vdocuments.net/reader033/viewer/2022061206/54821005b479590f0d8b468d/html5/thumbnails/9.jpg)
•Mapping between template file and target configuration file
•Details of commands to be executed
•Every product top contains its own driver file
•Eg. <AD_TOP>/admin/driver/adtmpl.drv <FND_TOP>/admin/driver/fndtmpl.drv
Drivers
![Page 10: Anatomy of Autoconfig in Oracle E-Business Suite](https://reader033.vdocuments.net/reader033/viewer/2022061206/54821005b479590f0d8b468d/html5/thumbnails/10.jpg)
adautocfg.sh
•Located in $INST_TOP/admin/scripts
adchkcfg.sh
•Located in $AD_TOP/bin
Autoconfig Scripts
![Page 11: Anatomy of Autoconfig in Oracle E-Business Suite](https://reader033.vdocuments.net/reader033/viewer/2022061206/54821005b479590f0d8b468d/html5/thumbnails/11.jpg)
Lets Visualize !
![Page 12: Anatomy of Autoconfig in Oracle E-Business Suite](https://reader033.vdocuments.net/reader033/viewer/2022061206/54821005b479590f0d8b468d/html5/thumbnails/12.jpg)
Contd…
![Page 13: Anatomy of Autoconfig in Oracle E-Business Suite](https://reader033.vdocuments.net/reader033/viewer/2022061206/54821005b479590f0d8b468d/html5/thumbnails/13.jpg)
Contd.
![Page 14: Anatomy of Autoconfig in Oracle E-Business Suite](https://reader033.vdocuments.net/reader033/viewer/2022061206/54821005b479590f0d8b468d/html5/thumbnails/14.jpg)
Different Phases in Autoconfig• CVM - updates the xml file itself incase of a new xml template
• INSTE8 and BINCPY– creates files and copying from source files to target configuration files.
• INSTE8_SETUP - runs all scripts that involve no DB connection
• INSTE8_PRF - runs all scripts that update profile options.
• INSTE8_APPLY - runs other scripts that involve updates to Database
![Page 15: Anatomy of Autoconfig in Oracle E-Business Suite](https://reader033.vdocuments.net/reader033/viewer/2022061206/54821005b479590f0d8b468d/html5/thumbnails/15.jpg)
Examples
![Page 16: Anatomy of Autoconfig in Oracle E-Business Suite](https://reader033.vdocuments.net/reader033/viewer/2022061206/54821005b479590f0d8b468d/html5/thumbnails/16.jpg)
Best Practices
![Page 17: Anatomy of Autoconfig in Oracle E-Business Suite](https://reader033.vdocuments.net/reader033/viewer/2022061206/54821005b479590f0d8b468d/html5/thumbnails/17.jpg)
Autoconfig Check Utility
•Run adchkcfg.sh well ahead of downtime window
•It runs autoconfig in test mode
•Generates a report with details on what will be effected during a real autoconfig run
![Page 18: Anatomy of Autoconfig in Oracle E-Business Suite](https://reader033.vdocuments.net/reader033/viewer/2022061206/54821005b479590f0d8b468d/html5/thumbnails/18.jpg)
![Page 19: Anatomy of Autoconfig in Oracle E-Business Suite](https://reader033.vdocuments.net/reader033/viewer/2022061206/54821005b479590f0d8b468d/html5/thumbnails/19.jpg)
Editing Context File•Oracle recommended method is OAM
•We can also edit the xml file manually
•Choose either one of the method, Don’t use both ways of editing in same instance
•If you use OAM, make sure apps listener is running on all nodes
![Page 20: Anatomy of Autoconfig in Oracle E-Business Suite](https://reader033.vdocuments.net/reader033/viewer/2022061206/54821005b479590f0d8b468d/html5/thumbnails/20.jpg)
Customizing Templates•Create custom directory
$ mkdir $FND_TOP/admin/template/custom
•Copy original template to custom dir
$ cd $FND_TOP/admin/template
$ cp apachectl_sh_1013.tmp custom/
•Make the change in custom template
![Page 21: Anatomy of Autoconfig in Oracle E-Business Suite](https://reader033.vdocuments.net/reader033/viewer/2022061206/54821005b479590f0d8b468d/html5/thumbnails/21.jpg)
The Old Fashioned Way
• Begin/End Customizations syntax is still valid
• Disadvantage is all content tagged in begin/end customization is moved to end of the file after autoconfig
• Avoid it as its not easy to track customizations
• Use adcustomizer.sh to migrate custom templates
![Page 22: Anatomy of Autoconfig in Oracle E-Business Suite](https://reader033.vdocuments.net/reader033/viewer/2022061206/54821005b479590f0d8b468d/html5/thumbnails/22.jpg)
Advanced Features
![Page 23: Anatomy of Autoconfig in Oracle E-Business Suite](https://reader033.vdocuments.net/reader033/viewer/2022061206/54821005b479590f0d8b468d/html5/thumbnails/23.jpg)
Parallel Autoconfig•Feature introduced in 12.1, useful when
managing multinode instances
•Enables autoconfig to run in parallel
•Internally uses dbms_locks to avoid same script running at the same time from multiple nodes
•Syntax: perl $AD_TOP/bin/adconfig.pl contextfile=<CtxFile> –parallel
![Page 24: Anatomy of Autoconfig in Oracle E-Business Suite](https://reader033.vdocuments.net/reader033/viewer/2022061206/54821005b479590f0d8b468d/html5/thumbnails/24.jpg)
Autoconfig Profiler
•Useful tool to diagnose issues with slow autoconfig issues
•Generates a report showing runtimes of each production top and templates
•Syntax: $AD_TOP/bin/adconfig.pl contextfile=<CtxFile> –profile
![Page 25: Anatomy of Autoconfig in Oracle E-Business Suite](https://reader033.vdocuments.net/reader033/viewer/2022061206/54821005b479590f0d8b468d/html5/thumbnails/25.jpg)
Rolling back autoconfig•Autoconfig provides a way to rollback
changes done.
•Run restore.sh from the autoconfig out directory
$ cd $INST_TOP/admin/out/<MMDDhhmm>
$ restore.sh
![Page 26: Anatomy of Autoconfig in Oracle E-Business Suite](https://reader033.vdocuments.net/reader033/viewer/2022061206/54821005b479590f0d8b468d/html5/thumbnails/26.jpg)
Other tools•adgentns.pl – to regenerate
tnsnames.ora, useful in multinode env
•adclonectx.pl retrieve – to extract xml file from database to filesystem
•GenCtxInfRep – generates report on what all templates are using a xml tag
perl <FND_TOP>/bin/txkrun.pl -script=GenCtxInfRep -keyword="<keyword>"
![Page 27: Anatomy of Autoconfig in Oracle E-Business Suite](https://reader033.vdocuments.net/reader033/viewer/2022061206/54821005b479590f0d8b468d/html5/thumbnails/27.jpg)
Other tools
•adtmplreport.sh – generates report on customized templates
adtmplreport.sh contextfile=<CONTEXT_FILE> listcustom
![Page 28: Anatomy of Autoconfig in Oracle E-Business Suite](https://reader033.vdocuments.net/reader033/viewer/2022061206/54821005b479590f0d8b468d/html5/thumbnails/28.jpg)
Questions? Comments?
![Page 29: Anatomy of Autoconfig in Oracle E-Business Suite](https://reader033.vdocuments.net/reader033/viewer/2022061206/54821005b479590f0d8b468d/html5/thumbnails/29.jpg)
THANK YOUVasu Balla
Room 601 – Staged Patching Approach – Thu 12:15pm
@vasuballa #C13TCH #C13DEN
www.pythian.com/blog