You are on page 1of 26

Autoconfig FAQ [ID 218089.

1] Modified 09-JUL-2010 PUBLISHED View Change log Type FAQ Status

Frequently Asked Questions About Using AutoConfig With Oracle Applications Release 11i
June 2010
The information in this document (MetaLink Note 218089.1) pertains to E-Business Suite 11i. Customers using E-Business Suite Release 12 should instead refer to MetaLink Note 387859.1.

Questions Overview and Terminology

1. What is AutoConfig? 2. What is the difference between the application tier and the database tier? 3. How can I identify the application tier and the database tier in a multi-node system? 4. How do I configure AutoConfig for a multi-node system? 5. What user do I log in as to use AutoConfig in a typical multi-node system? 6. How do I determine if AutoConfig is enabled? 7. Is AutoConfig compatible with Oracle Applications 11.5.x? 8. What does the term "Context_name" mean? 9. What are the basic components of AutoConfig ? 10. What are the different AutoConfig scripts and what do they do?
The Context file

11. How will the adbldxml utility name the Applications Context file it generates? 12. How do I make changes to the Applications Context file? 13. I want to execute the adbldxml utility on a fresh RDBMS Oracle Home. How can I build the
Context file, when the database environment file is not present?

14. I was instructed to change the value of the context variables s_adperlprg and s_perl5lib. How
can I achieve that?

Running AutoConfig

15. When should I run AutoConfig? 16. Which files / profile options get changed when I run AutoConfig? 17. Where is the log file located that AutoConfig creates? 18. Which directories based on the Context_name will AutoConfig create? 19. I see multiple directories under <COMMON_TOP>/admin/scripts - which one do I use?

20. How do I roll back an AutoConfig session? 21. How does AutoConfig know which scripts to create for service controls? 22. How does AutoConfig know what application tier node type the APPL_TOP supports?
Customizations

23. How do I preserve customizations to an AutoConfig-maintained environment? 24. What do I do when a patch or Oracle documentation instructs me to manually modify an
AutoConfig-maintained file?

Patching AutoConfig

25. How do I get the latest changes to AutoConfig? 26. How do I apply the latest AutoConfig patch?
Net Services

27. What is the Net Services Topology Data Model? 28. When is the Net Services Topology Data Model seeded? 29. What mechanism is used to generate the tnsnames.ora file? 30. How do I seed the Net Services Topology Data Model? 31. When do I need to deregister a database tier or an application tier? 32. How do I deregister an application tier from the Net Services Topology Data Model? 33. How do I deregister a database tier from the Net Services Topology Data Model? 34. When do I need to purge the complete Net Services Topology Data Model? 35. How do I purge the complete Net Services Topology Data Model? 36. How do I seed the Net Services Topology Data Model after purging it? 37. I want to deregister an application tier or a database tier from the Net Services Topology Data
Model. I can't use the adgentns.pl because I already decommissioned the tier or removed the context file. How can I deregister the tier?

38. I want to purge the complete Net Services Topology Data Model. I can't use the adgentns.pl
script because I removed the relevant context file(s). How can I purge the Data Model?

39. How do I configure AutoConfig to generate the failover aliases? 40. For which database versions can I define failover aliases?
Database connectivity

41. Should the database server remain available during the AutoConfig run? 42. What is the use of the context variable s_apps_jdbc_connect_descriptor? 43. When do I need to reset (empty) the context variable s_apps_jdbc_connect_descriptor? 44. What steps do I need to follow to maintain my database connectivity when I migrate my
database from one host/platform to another?

45. I migrated my database tier to a new host/platform, but the application tier still tries to connect to
the old database. How can I fix this situation, so that the application tier connects to the new database?

RAC

46. My 11i instance is configured with RAC. Now I want to migrate to AutoConfig. How do I achieve

Refer to Metalink Note 165195.sh? 60.cmd on Windows? 52. The information required for configuring an Applications system is collected into a repository. After I run AutoConfig in my 11. but my TWO_TASK variables still point to the instance aliases. I get the message "You are not authorized to view this page" when I access the application. there is one Applications Context for each application tier. How do I resolve this problem? problem? Additional References 62. How can I resolve TNS-12500 while trying to start GSM? 58. After I run AutoConfig in my 11. and one for the database tier. What steps should I follow? 48. Can I use the perl shipped by MKS to run adconfig.5. Which ones should I use? 54.that? 47. I applied all the required RAC patches. the Apps. The Oracle Applications Maintenance Procedures and the Oracle Applications Maintenance Utilities provide further information on how to use AutoConfig in the context of maintaining your system. How do I resolve this Questions and Answers Overview and Terminology 1. The script adsvalsn. What is AutoConfig? Answer: AutoConfig is a configuration tool that automates the configuration of an Oracle Applications system. and two metrics server services. . How do I resolve this issue? 51.9 Windows environment I have two Apache services. two forms services. Now I want to migrate to RAC using AutoConfig. using and updating AutoConfig.5. Which ones should I use? 53. When AutoConfig runs.9 Windows environment I have two Apache services and two forms services. My concurrent managers don't start after running AutoConfig? How do I resolve this issue? 59. How do I resolve an address in use (could not bind to port) when starting Apache? 61. On HP/UX Itanium adconfig.cmd contain slashes instead of backslashes on Windows. two metrics client services. My 11i instance is configured as non-RAC. After running AutoConfig. called the Applications Context.1 for details on installing.cmd fails when I run AutoConfig. What should I do if my AutoConfig script exits with non-zero status? 56. it uses information from the Applications Context file to generate all configuration files and update database profiles. How do I resolve a FileNotFoundException while running adupdts. How do I configure AutoConfig to start the TCF servlet? 57.cmd and <CONTEXT_NAME>. How can I point them to load balanced aliases? Windows specifics 49. How do I resolve this issue? Troubleshooting 55. What is the correct setting for MSDEVDIR? 50.pl fails because of a missing POSIX module.

Now let's answer the question. and is considered an application tier server node. Release 11i. refer to Oracle Applications Concepts. Likewise. or administration server. let's define a few terms in the context of the Release 11i architecture: ○ ○ ○ A node or machine is a computer. and can therefore belong to one or more tiers. If the node contains any of the application tier servers. A tier is a logical grouping of one or more servers or computer processes. A server is a collection of one or more computer processes that perform a specific function.) The database tier consists of the database server. If the node contains the database server. concurrent processing server. How do I configure AutoConfig for a multi-node system? . each node contains one or more servers. as well as provide communication between the desktop tier and the database tier. ○ The application tier (also called the middle tier) consists of a number of servers. ○ The primary location of the files used by the application tier servers is the APPL_TOP. Let's analyze a common configuration where the database server and the concurrent processing server exist on one node (Node 1). and the other servers exist on a second node (Node 2). which means that there is an Oracle8i or Oracle9i ORACLE_HOME and the Applications database instance on the node. then the node belongs to the database tier. forms server. including the web server. that process the transactions of the Release 11i system. Node 2 belongs only to the application tier. In a single node system. since all servers are contained on that single node. which stores all the data of the Release 11i system. such as the concurrent processing server. But since Node 2 contains only application tier servers. (Such servers are also referred to as application tier servers. and therefore belongs to one or both tiers. and administration server. whereas the primary location of the files used by the database server is the Oracle8i or Oracle9i ORACLE_HOME. In a multi-node system. web server. the nodes on which such servers run are also referred to as application tier server nodes.[top] 2. [top] 3. and is considered a database server node. Since Node 1 contains both an application tier server (the concurrent processing server) and the database server. then the node belongs to the application tier. Node 1 belongs to both the database tier and the application tier. What is the difference between the application tier and the database tier? Answer: Before we can answer that. forms server. For more information about the Release 11i architecture. which means that there is an APPL_TOP on the node. How can I identify the application tier and the database tier in a multi-node system? Answer: A node can contain one or more servers. that node belongs to both the application tier and the database tier. [top] 4.

then you would not apply an AutoConfig patch on that node. Node 1 = database server Node 2 = administration server. concurrent processing server Node 3 = forms server.1 5. web server Since Node 2 is the only application tier server node.zip file into the RDBMS ORACLE_HOME.zip file into the RDBMS ORACLE_HOME. Once the patches are applied. Once the patches are applied. database server Node 2 = forms server.zip file into the RDBMS ORACLE_HOME.1. you have to update the database server Node1 by running the admkappsutil utility either from the APPL_TOP on Node1 or Node2 (it does not matter on which Node you run the admkappsutil utility). Reference: ○ [top] Metalink Note 208738. If the database server node contains only the database server and no other servers.zip to your RDBMS ORACLE_HOME on Node1 and unzipping the appsutil. the AutoConfig patch needs to be applied to Node 2 and Node3. log in as the user that owns the application tier servers (sometimes referred to as the applmgr user). Once the patch is applied. so you would log in as that user. concurrent processing server. which means to each node that contains an APPL_TOP.zip to your RDBMS ORACLE_HOME on Node1 and unzipping the appsutil. Node 1 = database server Node 2 = administration server. Therefore. the AutoConfig patch needs only be applied to Node 2. For nodes running UNIX or Linux. it must be applied to each application tier server node. Example 2: The system has two nodes. Example 3: The system has three nodes. you have to update the database server Node1 by running the admkappsutil utility from the APPL_TOP on Node1.Answer: The AutoConfig patch is applied using AutoPatch. copying the generated appsutil. This process consists of running the admkappsutil utility on one (only one) application tier. concurrent processing server. there is only one user that owns both the application tier servers and the database server. forms server. which is documented in Metalink Note 165195. the AutoConfig patches need to be applied to both nodes. If you want to configure the database server. copying the generated appsutil. web server Since Node 2 and Node 3 are application tier server nodes. there is a separate process for updating the database server.zip file to the database tier and unzipping the appsutil. .zip to your RDBMS ORACLE_HOME on Node1 and unzipping the appsutil. log in as the user that owns the database server (sometimes referred to as the oracle user). if you want to configure the application tier servers. you have to update the database server Node1 by running the admkappsutil utility from the APPL_TOP on Node2. web server Since both nodes are application tier server nodes. Example 1: The system has two nodes. Once all the application tier servers have been updated by the AutoConfig patch.zip file into the RDBMS ORACLE HOME. copying the generated appsutil. What user do I log in as to use AutoConfig in a typical multi-node system? Answer: For nodes running Windows. Node 1 = administration server. copying the generated appsutil.

5. look in any configuration file in your APPL_TOP. or if you are not # able to use the settings created by AutoConfig.1 . it is no longer considered as officially AutoConfig enabled! [top] 7.9 and higher (database tier): AutoConfig is included in new Applications installations and in the associated maintenance packs. If you were instructed to edit this file. # ################################################################ Note: If you manually changed any file containing this file header.sh (adcfginfo. it is compatible with all 11i releases. For the APPL_TOP: adcfginfo.5.sh contextfile=<CONTEXT> show=enabled If adcfginfo. If the file header contains the following. You can use AutoConfig to configure and maintain any Oracle Applications 11i environment. Is AutoConfig compatible with Oracle Applications 11. The default value for Context_name is .7 and higher (application tier): AutoConfig is included in new Applications installations and in the associated maintenance packs. you have to separately migrate to AutoConfig as part of the pre-upgrade process. Release 11.6 (all tiers): Apply the latest AutoConfig consolidated patch to obtain the AutoConfig utility. [top] 8.1 for assistance. Release 11.5. It will be read and # overwritten.5. use it to check whether AutoConfig is enabled. What does the term "Context_name" mean? Answer: The "Context_name" is the logical name for your Context. refer to Metalink # document 165195.sh contextfile=<CONTEXT> For products: adcfginfo.3 to 11.x? Answer: Yes. How do I determine if AutoConfig is enabled? Answer: Check for the script adcfginfo.10).sh doesn't exist. Follow the instructions of the corresponding maintenance pack.11. Note: If you upgrade from a maintenance pack version that does not include AutoConfig to a maintenance pack version that includes AutoConfig (for example you upgrade from 11.5.5.5. AutoConfig has been run on your instance : ################################################################ # # AutoConfig automatically generates this file.cmd on Windows) under <AD_TOP>/bin.[top] 6. Release 11. If it exists.

xml) contains information specific to that Applications instance. [top] 9.cmd AutoConfig Template Files On the application tier: <PROD_TOP>/admin/template For example: <AD_TOP>/admin/template <FND_TOP>/admin/template On the database tier: <RDBMS ORACLE_HOME>/appsutil/template AutoConfig File Driver On the application tier: <PROD_TOP>/admin/driver For example: <AD_TOP>/admin/driver/adtmpl. Scripts adautocfg.sh adautocfg. for example.<SID>_<hostname>.cmd. Provide a simplified interface to the AutoConfig APIs. Do not manually update this file! Include named tags which are replaced with instance-specific information from the Applications Context.conf Used by AutoConfig to list the AutoConfig Template Files.sh / adconfig.sh / adautocfg. In earlier versions of AutoConfig the default was set to <SID>. Instantiates template files with values specific to the instance (taken from the Applications Context). For example: apps_nt. Every Product Top contains its own AutoConfig File Driver.conf apps_ux. their destination locations.cmd adconfig. Can be updated by running the Context Editor. What are the different AutoConfig scripts and what do they do? Answer: The scripts are listed in the following table.sh scripts are for UNIX users and .cmd Location On the application tier: <COMMON_TOP>/admin/scripts/ <Context_name> Description A wrapper script that calls adconfig. Note: .cmd scripts are for Windows users.drv <FND_TOP>/admin/driver/fndtmpl. For example: adautocfg. What are the basic components of AutoConfig? Answer: Components Applications Context Location On the application tier: <APPL_TOP>/admin On the database tier: <RDBMS ORACLE_HOME>/appsutil Description An XML repository (<Context_name>. There is one template file for each configuration file. and the commands to be executed. . the commands to update profile options.sh/ adconfig.drv On the database tier: <RDBMS ORACLE_HOME>/appsutil/template AutoConfig Scripts On the application tier: <AD_TOP>/bin On the database tier: <RDBMS ORACLE_HOME>/appsutil/bin [top] 10.

html.env Generates a report that highlights differences between the original config files and AutoConfig-generated config files.sh/adconfig. Specific requirements are: .sh adbldxml. The report is named cfgcheck.cmd On the application tier: <AD_TOP>/bin On the database tier: <RDBMS ORACLE_HOME>/appsutil/bin/ On the application tier: <AD_TOP>/bin On the database tier: <RDBMS ORACLE_HOME>/appsutil/bin adbldxml. On the application tier: Source APPS<Context_name>.On the database tier: <RDBMS ORACLE_HOME>/appsutil/ scripts/ <Context_name> adconfig. On the database tier: Source <Context_name>. adbldxml creates the Applications Context file using the same name.pl.cmd On the application tier: <AD_TOP>/bin On the database tier: <RDBMS ORACLE_HOME>/appsutil/bin [top] The Context file 11.cmd On the application tier: <AD_TOP>/bin On the database tier: <RDBMS ORACLE_HOME>/appsutil/bin Updates configuration files and profile options.sh adchkcfg.env (or APPSORA. Creates the Applications Context File. In earlier versions of AutoConfig adconfig. it first checks for the existence of an Applications Context file conforming to specific requirements in the <APPL_TOP>/admin directory on the application tier and in the <RDBMS ORACLE_HOME>/appsutil directory on the database tier. It is located under: On the application tier: <APPL_TOP>/admin/ <Context_name>/out/<MMDDhhmm> On the database tier: <RDBMS ORACLE_HOME>/appsutil/out/ <Context_name>/<MMDDhhmm> adchkcfg. Before running this script.pl A wrapper script that calls the Java API to start AutoConfig. A wrapper script that calls adconfig. adconfig. you need to source the environment.env doesn't exist).cmd used to call the Java API to start AutoConfig.env if APPS<Context_name>. If an xml file exists. How will the adbldxml utility name the Applications Context file it generates? Answer: When adbldxml generates the Context file.sh adconfig.

By manually editing the Applications Context file you will bring the data into an inconsistent state.g. Use this link to update your Applications Context file. Review your Applications Context file. How can I make changes to the Applications Context file? Answer: Go to the OAM Login page. Many context variables have dependencies between each other. when the database environment file is not present? Answer: The adbldxml utility requires the following environment variables to be set: ○ ORACLE_HOME ORACLE_SID (LOCAL on Windows) TNS_ADMIN On UNIX export ORACLE_SID=PROD On Windows set LOCAL=PROD ○ ○ ○ ○ [top] Set the variables according to your instance.pl 3. The default name for the Context file is <Context_name>. Note: Manually editing the Applictions Context file is not supported. then perform the following steps depending on your use case: ○ You were instructed to use a certain perl version. I want to execute the adbldxml utility on a fresh RDBMS Oracle Home. How can I achieve that? Answer: Apply the latest AutoConfig patch. /usr/lib/perl5 on Linux) and perl is in your PATH: 1. Sign in and navigate to Site Map. s_adperlprg and s_perl5lib will now point . Source the environment file (APPS<Context_name>. For example: 14. The OAM AutoConfig resolves all these dependencies when changing the value of a variable.○ ○ [top] The Context file refers to the hostname for which we generate the file. The Context file refers to the Database SID for which we generate the file. I was instructed to change the value of the context variables s_adperlprg and s_perl5lib. unset PERL5LIB 2.xml. 12. Click on AutoConfig. For additional information see the Oracle Applications Maintenance Procedures.env) 4. You have perl and its libraries installed in the perl standard location for your os (e. How can I build the Context file. [top] 13. perl $AD_TOP/bin/adconfig.

[top] Running AutoConfig When should I run AutoConfig? Answer: You should run AutoConfig in the event of the following cases: You did updates to your Applications Context file. perl is installed at /u03/myperl/bin and the perl libraries at /u03/myperl/lib). You installed perl and its libraries into a custom .non perl standard location (e.pl 4.pl AutoConfig will update the context variables in the context file accordingly. For instructions on how to run the adchkcfg utility and a discussion about the report that the . ○ You were instructed to use a certain perl version. Source the environment file (APPS<Context_name>. then adpatch will automatically invoke AutoConfig if the patch that you apply requires AutoConfig to run. export PERL5LIB 3. An Oracle Metalink Note instructs you to run AutoConfig as part of an upgrade. s_adperlprg and s_perl5lib will now point to your customized perl location. Review your Applications Context file.I or higher applied and you want to see the list of files and profile options that will get changed when adpatch is run. Note: When you have AD.Section Patching . You apply any ADX Product patch. migration.005 export PERL5LIB /u03/myperl/bin/perl $AD_TOP/bin/adconfig.I or higher applied on your system. refer to Oracle Applications Maintenance Procedures .g. For more information. The Readme of an Oracle patch instructs you to run AutoConfig after the application of the patch.to your system perl location.00503:/u03/myperl/lib/site_perl/ 5. then run adpatch with the apply=no option before applying the patch. [top] Which files / profile options get changed when I run AutoConfig? Answer: Run the adchkcfg utility to get an html report that lists all the files and profile options that get changed when you run AutoConfig. Example:    PERL5LIB=/u03/myperl/lib/5. After the AutoConfig run subsequent utilities and tools can use the context variables s_adperlprg and s_perl5lib. cloning and/or configuration process. <location of the new perl you want to use> <AD_TOP>/bin/adconfig. If you have AD. 1.Testing a Patch before Applying it. PERL5LIB=<location of the new PERL5LIB that you want to use> 2.env) 5.

hour.7. AutoConfig now creates the directory <SID>_<hostname>.5. Oracle Applications comes with the modified directory structure.utility generates.which one do I use? Answer: Previously. day. [top] Where is the log file located that AutoConfig creates? Answer: The log file that AutoConfig creates is located at: On the application tier: <APPL_TOP>/admin/<Context_name>/log/<MMDDhhmm>/adconfig. [top] I see multiple directories under <COMMON_TOP>/admin/scripts . and minute of the AutoConfig run) You can run restore.sh (Unix) or restore. If your system contains both directory names.cmd (Windows) to roll back an AutoConfig session. You can safely delete directories named <SID>. day. hour. after backing them up. [top] . AutoConfig generated the directory <SID> in <COMMON_TOP>/admin/scripts. For additional information see Oracle Applications Maintenance Procedures.1. To provide support for a shared APPL_TOP. see Appendix B of the Metalink Note 165195. and minute of the AutoConfig run) [top] Which directories based on the Context_name will AutoConfig create? Answer: AutoConfig creates the following directories based on the Context_name: Install Scripts : <COMMON_TOP>/admin/install/<Context_name> Control Scripts : <COMMON_TOP>/admin/scripts/<Context_name> Log files : <COMMON_TOP>/admin/log/<Context_name> Beginning with Release 11. use the scripts under <SID>_<hostname>. Refer to Metalink Document 233428.log where: <MMDDhhmm> = (month.log On the database tier: <RDBMS ORACLE_HOME>/appsutil/log/<Context_name>/<MMDDhhmm>/adconfig. [top] How can I roll back an AutoConfig session? Answer: All backup configuration files from each AutoConfig session are stored in: On the application tier: <APPL_TOP>/admin/<Context_name>/out/<MMDDhhmm>/ On the database tier: <RDBMS ORACLE_HOME>/appsutil/out/<Context_name>/<MMDDhhmm>/ where: <MMDDhhmm> = (month.1 on OracleMetalink to learn more about the Shared APPL_TOP configuration.

reports and other files related to these services exist in the APPL_TOP. The following variables in the Applications Context file define which files are patched and maintained for the APPL_TOP: Context Variable Action If set to Yes. the APPL_TOP contains the necessary files to provide s_isAdWeb Oracle HTTP services If set to Yes. create administration service scripts s_isConc If set to Yes. If set to Yes. web server Node 2 = concurrent processing server. If set to Yes. all variables are set to "YES" in the Applications Context file. Multi-node system: Example Node 1 = forms server. On Node 2 only the admin and concurrent processing service control scripts are created. the APPL_TOP contains binaries and scripts used to s_isAdAdmin maintain the Applications system. create forms service scripts The variables are set according to your configuration when you create the Applications Context file: Single-node system: All the service control scripts are present on the same node. the APPL_TOP contains the necessary files to provide s_isAdForms Forms services The variables are set according to your configuration when you create the Applications Context Node 1 Value NO NO YES YES Node 2 Value YES YES NO NO . administration server. Therefore. All binaries. scripts. The Applications Context files contain the following values: Context Variable s_isAdmin s_isConc s_isWeb s_isForms [top] How does AutoConfig know what application tier node type the APPL_TOP supports? Answer: The AD Utilities such as AutoPatch and AD Administration patch and maintain files based on the application tier node type that the APPL_TOP supports. the APPL_TOP can be used to provide the CP and Reports s_isAdConc services. create concurrent processing and reports service scripts s_isWeb If set to Yes. database server On Node 1 only the forms and web service control scripts are created. create web service scripts s_isForms If set to Yes.How does AutoConfig know which scripts to create for service controls? Answer: The following variables in the Applications Context File let AutoConfig know which scripts to create: Context Variable Action s_isAdmin If set to Yes.

. Log a Service Request with Oracle Support. web server Node 2 = concurrent processing server. administration server. database server Every node has its own APPL_TOP that only patches and maintains the files specific to the node. [top] What do I do when a patch or Oracle documentation instructs me to manually modify an AutoConfig-maintained file? Answer: Contact Oracle Support to incorporate the necessary changes in the AutoConfig templates: 1. Multi-node system. Identify the patch or the note that is requesting the manual change. Multi-node system sharing the same APPL_TOP: A shared APPL_TOP contains all the necessary software components to run any service. providing the same information.file: Single-node system: All the application tier types are present on the same node and there is only one APPL_TOP. The latest patch at the time of this writing are patch number 9535311.1 for details on how to implement customizations. [top] Patching AutoConfig How do I get the latest changes to AutoConfig? Answer: Updates to AutoConfig are delivered in the TXK AutoConfig and Templates patch. where every node has a separate APPL_TOP: Example: Node 1 = forms server. 2. All variables are set to "YES" in the Applications Context file. All variables are set to "YES" in the Applications Context files sharing the APPL_TOP. The Applications Context files contains the following values: Context Variable s_isAdAdmin s_isAdConc s_isAdWeb s_isAdForms [top] Node 1 Value NO NO YES YES Node 2 Value YES YES NO NO Customizations How do I preserve customizations to an AutoConfig-maintained environment? Answer: Refer to Metalink Note 270519.

TNS Descriptors.zip Run AutoConfig on the Database Tier If you enabled AutoConfig on the Database Tier. Copy AutoConfig to the RDBMS ORACLE_HOME If you enabled AutoConfig on the Database Tier. Attention: The database server must remain available during the AutoConfig run. Apply the AutoConfig patch Update the Oracle Applications file system with the AutoConfig files by applying patch 9535311.ora). Only the application tier servers should be shut down.1. Attention: The database server must remain available during the AutoConfig run. to all application tier nodes in the Applications instance.zip file to the <RDBMS ORACLE_HOME> cd <RDBMS ORACLE_HOME> unzip -o appsutil. ○ Run AutoConfig on the Application Tiers Run AutoConfig on all application tier nodes.    On the Database Tier (as the ORACLE user):   ○ Copy or FTP the appsutil. The data model stores information about each node in the Oracle Applications instance which is then used to generate the Net Service configuration files (for example tnsnames. update the RDBMS ORACLE_HOME file system with the AutoConfig files by performing the following steps:  On the Application Tier (as the APPLMGR user):  Log in to the APPL_TOP environment (source the environment file) Create appsutil.zip in $APPL_TOP/admin/out . Database Name.. AutoConfig seeds the data model with relevant data. All the other database tier services should be shut down.. run AutoConfig on the database tier node. The Net Services Topology Data Model stores the following information: ○ On the database tier: Hostname.[top] How do I apply the latest AutoConfig patch? Answer: Perform the following steps in the order listed: ○ ○ ○ Review the pre-requisites as documented in Metalink Note 165195. .. Instance Name.pl This will create appsutil. Database SID.zip file perl <AD_TOP>/bin/admkappsutil.. [top] Net Services What is the Net Services Topology Data Model? Answer: The Net Services Topology Data Model stores the entire topological information about a single Oracle Application instance.

every time you run AutoConfig on the application tier. It generates the tnsnames.ora based on the information in the Net Services Topology Data Model.. When is the Net Services Topology Data Model seeded? Answer: The Net Services Topology Data Model is seeded every time you run AutoConfig on the respective tier. Respectively.pl template adgentns.pl template adgentns.○ [top] On the application tier: Hostname.E and higher Excepti TXK.NODE FND_NODES. Every time you run AutoConfig on the database tier...ora is generated from a template or from the adgentns..E _ID column is _ID column is not _ID column is e not present present present availabl AutoCon fig on templa databas te e tier AutoCon fig on templa applicati te on tier [top] How do I seed the Net Services Topology Data Model? Answer: The Net Services Topology Data Model can be seeded/updated by running AutoConfig on the database tier followed by all application tiers. the relevant data is seeded/updated for the application tier..pl template template template ..NODE databas ADX.pl script was introduced with ADX..pl script: ADX. [top] What mechanism is used to generate the tnsnames. the adgentns. The adgentns.NODE FND_NODES. FNDFS and FNDSM alias descriptors.pl script dynamically generates the tnsname.E.ora file based on an AutoConfig template. [top] When do I need to deregister a database tier or an application tier? Answer: You have to deregister a tier from the Net Services Topology Data Model in one of the following cases: ○ You want to delete an application tier adgentns.ora file? Answer: In ADX. AutoConfig instantiates the tnsnames. Refer to the following matrix to understand when tnsnames..G and ons like PRE FND_NODES. the relevant data is seeded/updated for the database tier.ora file. To support enhanced configuration scenarios (for example RAC).D and earlier.

when the Database Name is changed as a result of a database upgrade/migration.pl appspass=<APPSpwd> contextfile=<CONTEXT> -removeserver [top] How do I deregister a database tier from the Net Services Topology Data Model? Answer: To deregister the current database tier from the Net Services Topology Data Model.pl appspass=<APPSpwd> \ contextfile=<CONTEXT> -removeserver [top] When do I need to purge the complete Net Services Topology Data Model? Answer: You need to purge the complete Net Services Topology Data Model. [top] How do I purge the complete Net Services Topology Data Model? Answer: To purge the complete Net Services Topology Data Model. invoke the following command: perl <RDBMS ORACLE_HOME>/appsutil/bin/adgentns.○ Your database is upgraded/migrated resulting in a change in one of the following parameters:     Database Host Database Port Database Name Database SID You should deregister the tier before the tier is decommissioned.pl appspass=<APPSpwd> contextfile=<CONTEXT> -removesystem [top] How do I seed the Net Services Topology Data Model after purging it? Answer: See question "How do I seed the Net Services Topology Data Model". [top] How do I deregister an application tier from the Net Services Topology Data Model? Answer: To deregister the current application tier from the Net Services Topology Data Model. invoke the following command: perl <AD_TOP>/bin/adgentns. invoke the following command: perl <AD_TOP>/bin/adgentns. [top] .

remove_system(SYSTEM_NAME).  ○ Run the following PL/SQL block: begin FND_NET_SERVICES. Query on the application tier: select NAME. Perform the following steps in the order listed: ○ Locate the System Name:  The System name is the database name Verify with sql query: select DB_NAME from FND_DATABASES. SERVER_NAME).NODE_ID = FND_NODES. / [top] I want to purge the complete Net Services Topology Data Model.pl script because I already decommissioned the tier or removed the context file. Query on the database tier: select NAME. end.I want to deregister an application tier or a database tier from the Net Services Topology Data Model.NODE_NAME=upper('hostname').remove_server(SYSTEM_NAME. SERVER_TYPE from FND_APP_SERVERS. end. / commit.NODE_ID and SERVER_TYPE='APPS' and FND_NODES. How can I deregister the tier? Answer: In this case you can use the PL/SQL API. I can't use the adgentns. / [top] .NODE_ID and SERVER_TYPE='DB' and FND_NODES. / commit. Perform the following steps in the order listed: ○ Locate the System Name:  The System name is the database name Verify with sql query: select DB_NAME from FND_DATABASES. SERVER_TYPE from FND_APP_SERVERS.pl script because I removed the relevant context file(s). FND_NODES where FND_APP_SERVERS. I can't use the adgentns.  ○ Locate the server name corresponding to the tier in question:   ○ Run the following PL/SQL block: begin FND_NET_SERVICES.NODE_NAME=upper('hostname'). FND_NODES where FND_APP_SERVERS. How can I purge the Data Model? Answer: In this case you can use the PL/SQL API.NODE_ID = FND_NODES.

1. All jdbc connections are done using this context variable.4 or higher. These aliases will still not be used anywhere.0. perform the following steps in the order listed: 1.0. These steps will generate tns aliases <INSTANCE_NAME>_FO with description lists as configured in s_alt_service_instances. [top] For which database versions can I define failover aliases? Answer: You can generate failover aliases for all database versions that are 8. [top] Database connectivity Should the database server remain available during the AutoConfig run? Answer: Yes. The value for this context variable is generated . On 8. The database server and the database listener must remain available during the AutoConfig run. as well when running AutoConfig on the database tier. If you run AutoConfig on the application tier.6 Oracle Home. For example 'SERVICE_NAME:INSTANCE_NAME1.4 or higher the generated alias <INSTANCE_NAME>_FO can only be used for failover. 2. Run AutoConfig on all database tiers. Update the context variable s_alt_service_instances in the database tier context file applying the failover rules as described above.1.ora file that fails over to INSTANCE_NAME1 when the current instance is not available.6 the generated alias can't be used for failover. This is true when running AutoConfig on the application tier. To set up the failover listing. You can specify a comma separated list of "servicename:instance" to use connect time failover management. it can be used for load balancing. Note: On database versions that are 8. [top] What is the use of the context variable s_apps_jdbc_connect_descriptor? Answer: The s_apps_jdbc_connect_descriptor stores the connect string for jdbc connections. Check the question "For which database versions can I define failover aliases for information about the availability of failover aliases on different database versions. However.How do I configure AutoConfig to generate the failover aliases? Answer: To generate the failover aliases use the database tier context variable s_alt_service_instances.7.7. Oracle Applications does not support failover aliases for the 8. If INSTANCE_NAME1 is not available it fails over to INSTANCE_NAME2. Run AutoConfig on all application tiers. then the 806 database listener must remain available also.SERVICE_NAME:INSTANCE_NAME2' will generate a TNS Alias in the tnsnames. You will have to set the two task variables like s_tool_twotask to actually use these aliases. Currently. 3.

When the value is reset (empty). Perform the step described in the question: "How do I seed the Net Service Topology Data Model?" RAC . [top] I migrated my database tier to a new host/platform. Deregister the database tier from the Net Services Topology Data Model. Reset the context variable s_apps_jdbc_connect_descriptor in the context file for the application tier to an empty string. [top] When do I need to reset (empty) the context variable s_apps_jdbc_connect_descriptor? Answer: You should reset the value for s_apps_jdbc_connect_descriptor to an empty value (" "). but the application tier still tries to connect to the old database.by AutoConfig. s_dbhost and s_dbport context variables. 2. Refer to the question "How do I deregister a database tier from the Net Services Topology Data Model?" If you haven't enabled AutoConfig on the database tier. AutoConfig tries to connect to the database using the s_dbSid. when one of the following value changes: ○ ○ [top] Database Host Database Port What steps do I need to follow to maintain my database connectivity when I migrate my database from one host/platform to another? Answer: Perform the steps in the order listed: ○ Before the migration: 1. Perform the following steps: ○ ○ [top] You have to clean up the data model by following the steps described in the question: "How do I purge the complete Net Services Topology Data Model?". ○ After the migration: 1. so that the application tier connects to the new database? Answer: Your old database tier is still registered in the Net Services Topology Data Model. Update the context variables s_dbhost and s_dbport in the context file for the application tier to reflect the new values in the middle tier context file. you can ignore this step. How can I fix this situation.

Now I want to migrate to RAC using AutoConfig.ora file and let AutoConfig generate an init. This order is required because the RAC configuration data needs to be uploaded to the Net Services Topology Data Model.ora file for you. AutoConfig will not overwrite your existing init. The vcvars32. However. Stop and start the database listener. Run AutoConfig on the database tier. not the MSDev98 directory. but my TWO_TASK variables still point to the instance aliases.ora file when no init. follow the instructions as described in Metalink Note 279956. Now I want to migrate to AutoConfig. Note: You need to enable and run AutoConfig on the database tiers FIRST! followed by the application tiers.ora file.ora file can be created on the application tier. How can I point them to load balanced aliases? Answer: Update your application tier context file and set the values of the following context variables to the desired load balanced alias names: ○ ○ [top] s_tools_twotask s_weboh_twotask Windows specifics What is the correct setting for MSDEVDIR? Answer: Use the path to the VC98 directory. [top] I applied all the required RAC patches.bat file exists only under the VC98 directory. [top] . 4. AutoConfig will generate a RAC conform init. We recommend that you backup your existing init. 5. Enable AutoConfig on all database tiers.My 11i instance is configured with RAC.1. 2.1. Follow the instructions in the AutoConfig Metalink Note 165195.1. follow these steps in the order listed: 1. How do I achieve that? Answer: To migrate to AutoConfig on a RAC instance. [top] My 11i instance is configured as non-RAC. For example:C:\CPP\VC98.ora file conforms to the Oracle's standards (for example using of DB_Name as the service name or handling local and remote listeners). so that a correct tnsnames. What steps should I follow? Answer: To migrate an Oracle Applications 11i instance from non-RAC to RAC. Enable and run AutoConfig on all your application tiers. 3.ora file exists. Follow the instructions in the AutoConfig Metalink Note 165195. This will ensure that the init.

two forms services.cmd on Windows? Answer: No. and two metrics server services. After I run AutoConfig in my 11. Which ones should I use? Answer: ○ The two Apache services are:   ○ Oracle Apache Server <SID> (original service) Oracle Apache Server <Context_name> (new service) OracleFormsServer-Forms60<SID> (original service) OracleFormsServer-Forms60<Context_name> (new service) Oracle Metrics Client <SID> (original service) Oracle Metrics Client <Context_name> (new service) The two forms services are:   ○ The two metrics client services are:   ○ The two metrics server services are: . 9i for the database tier) or download the ActivePerl from perl.5. [top] After I run AutoConfig in my 11.9 Windows environment I have two Apache services and two forms services.5.After running AutoConfig. the Apps.9 Windows environment I have two Apache services. [top] Can I use the perl shipped by MKS to run adconfig. Which ones should I use? Answer: ○ The two Apache services are:   ○ Oracle Apache Server <SID> (original service) Oracle Apache Server <Context_name> (new service) OracleFormsServer-Forms60<SID> (original service) OracleFormsServer-Forms60<Context_name> (new service) The two forms services are:   [top] Run the rem_srv. The perl shipped by MKS is not certified. two metrics client services. Perl has to be in the PATH in order for AutoConfig to run.com. How do I resolve this issue? Answer: Download patch 2690783 from OracleMetaLink and follow the instructions in Readme. Use the perl available in your Applications Environment (iAS for the application tier.cmd contain slashes instead of backslashes on Windows.cmd script delivered in patch 3197605 to remove the duplicate services.cmd and <CONTEXT_NAME>.

5. If you cannot fix the issue. 3. If they do not exist. 8. use the Context Editor to update the TCF Process Status to "disabled" and save the changes. Apply the Thin Client Framework (TCF) Servlet Implementation patch. Report the problem to Oracle Support.cmd script delivered in patch 3695041 to remove the duplicate services. [top] How do I configure AutoConfig to start the TCF servlet? Answer: Perform the following steps: 1. 4.  [top] Oracle Metrics Server <SID> (original service) Oracle Metrics Server <Context_name> (new service) Run the rem_srv.exe [top] Troubleshooting What should I do if my AutoConfig script exits with non-zero status? Answer: If AutoConfig exits with non-zero status. check for permission issues. open the adconfig.log file to see the reason for the failure. Error encountered in the SETUP/PROFILE/APPLY phase: Check the adconfig. If set to "enabled". that can be ignored. the AutoConfig File Driver of the product is faulty.exe %COMMON_TOP%\util\SrvStart. If you cannot fix the issue. Make additional updates based on your system configuration (see Note 164942.xml file. Apply TXK. report the problem to Oracle Support. Stop all application tier services. If your service is set to automatic. Run AutoConfig to update the configuration files. ○ Note: Refer to the question "Where is the log file located that AutoConfig creates?" for the location of the log file.1). Restart all application tier services.A or higher. 6.cmd fails when I run AutoConfig. . then you hit a known issue. 7. The script adsvalsn. You can use the following workaround to resolve the issue: copy %AD_TOP%\bin\adsstart. Verify that the s_tcfstatus variable is set to "disabled" in your <Context_name>. 2.log and check for the reported errors: ○ Errors in the instantiation phase: Check to see if the template files listed in the error summary exist in your file system. How do I resolve this issue? Answer: Check in your Service Control Panel to see if the 806 listener service is set to automatic or manual. If the template files exist. report the problem to Oracle Support.

If the version of the file is 115. If GSM is configured.sh fails with a "FileNotFoundException".6 ORACLE_HOME>/network/admin/<Context_name> AutoConfig depends on the CONC_GSM_ENABLED profile option to create entries for FNDSM in the listener. The patch creates the FNDSM entry in listener.ora located in <8. Reference: ○ AutoConfig Cannot Start Startssl because of Address already in use: make_sock: could . check listener. apply the latest AutoConfig patch.15 or lower. Apply the latest AutoConfig patch.ora file. which prevent the concurrent manager to start. References: ○ ○ [top] adupdts.Unable to Establish a Network Connection How can I resolve TNS-12500 while trying to start GSM? Answer: Change the profile option CONC_GSM_ENABLED to N until GSM is configured.sh Fails With Errors During AutoConfig Script adupdts.ora.0.sh Fails During AutoConfig Migration How do I resolve an address in use (could not bind to port) when staring Apache? Answer: The error "Address already in use: make_sock could not bind to port" occurs when non-SSL Apache and SSL Apache occupy the same port. that these ports don't conflict.References: ○ ○ [top] Oracle Applications 11i . The latest AutoConfig patch makes sure. Reference: ○ [top] Cannot Start GSM Service Manager . Apply the latest AutoConfig patch to get the templates that use Application Context variables. If listener.env (Windows) located in <AD_TOP>/admin/template.View Tree Error . the listener will not to start.sh? Answer: If the script adupdts. your environment file hard codes variables.env (Unix) or APPLSYS_nt.ora contains entries for FNDSM and the corresponding executable is not found.Thin Client Framework (TCF) Servlet Implementation AutoConfig: TCF .TNS Errors in listener Log and CCM Log My concurrent managers don't start after running AutoConfig? How do I resolve this issue? Answer: Look in the file APPLSYS_ux. [top] How do I resolve a FileNotFoundException while running adupdts.

How do I resolve this problem? Answer: When you get the error message "Can't locate loadable object for module POSIX @INC. 2003 January 30.not bind to port [top] I get the message "You are not authorized to view this page" when I access the application. [top] On HP/UX Itanium adconfig.pl fails because of a missing POSIX module. [top] Additional References To read more about configuring Oracle Applications and the features of AutoConfig follow these links: ○ ○ ○ ○ [top] Oracle Applications Manager 11i integrated with Oracle Applications 11i Are Manual Configuration Steps for iProcurement Included in AutoConfig? How to Setup Catalog External Bulk Loader Discoverer bind IP address with AutoConfig Change Log Date December 9. you can change the value of this variable to "Options FollowSymLinks". The pre-patch report txkValidateRollup of TXK AutoConfig Template Rollup G (patch 3239694) or later provides you more detailed instructions. If you want to enable symbolic links. 2004 Description Initial Posting Added question regarding symbolic links when using Apache Added questions 14. 2004 February 16." while running AutoConfig on HP/UX Itanium. Standard security practice and our strong recommendation is that you don't use symbolic links for E-Business Suite files. then download and apply patch 4261525 . 21 and 31 Clarified question 28 . 2004 March 5. Alternatively. 20. the Apache configuration won't allow symbolic links per default. How do I resolve this problem? Answer: After applying TXK AutoConfig Template Rollup F (patch 3104607) or later. use the Context Editor to change the value of the variable s_options_symlinks from "Options -FollowSymLinks" to "# Options -FollowSymLinks". Run AutoConfig to reflect the change and restart the applications services.

2004 August 9. 2004 December 4. 36. 2005 January 24.pl fails because of a missing POSIX module" Reference new patch 3453499 (ADX. 37. 2004 November 16. 2007 June 30. 2004 January 5. 2010 Note 218089.July 7.1 Clarifications for questions 54 and 61 Reference latest TXK AutoConfig and Templates patch October 14. 2004 December 30.F) Added question: "I want to execute the adbldxml utility on a fresh RDBMS Oracle Home.1 by Oracle Applications Development Copyright © 2003 Oracle Corporation Last updated: June 30. 2005 Reference latest ADX patch Added questions 32. 2010 Related Products • Oracle E-Business Suite > Applications Technology > Technology Components > Oracle Applications Technology Stack Keywords TCF. and 38 Clarifications for questions 31 and 32 Reference latest ADX patch Reference latest ADX patch New questions for RAC and Net Services Changed layout to group subjects Reference new ADX Patch Question added for failing adsvalsn. 2005 April 28. How can I build the Context file. AUTOCONFIG.cmd script Reference 11i10 Procedures and Utility books Fixed broken hyperlink for patch 2690783 Reference new ADX Patch Add ADX Patch 4244610 Added questions: "For which database versions can I define failover aliases?" and "On HP/UX Itanium adconfig. when the database environment file is not present?" Reference R12 MetaLink Note 387859. IAS Errors TNS-12500 Back to top Rate this document Top of Form . 2005 March 21. 2004 August 10. 2005 March 9. 2004 December 16. 2005 January 24.

feedback.1 Thank you for your Provide feedback for this article. Please help us to improve our content. Please use 'Contact Us' for other feedback.218089. comments are required w hen selecting a rating of "Poo .