EBS Auto Config
EBS AutoConfig :
AutoConfig is a tool that simplifies and standardizes configuration management tasks in an Oracle E-Business Suite environment. A fresh install of Release 12 includes AutoConfig as a standard (and required) configuration management tool. AutoConfig can also be used with earlier releases of Oracle E-Business Suite.
AutoConfig can be used to instantiate files or scripts, and then execute them for installation and configuration. Examples of instantiation include: Instantiation of a configuration file to be used at runtime. Instantiation of an SQL script to set profile options.
AutoConfig template files are used as the starting point for creating site-specific configuration files. AutoConfig evaluates the context variables in a template file, determines the actual values required, and creates a configuration file with these values substituted.
-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.
The Applications Context
Where the System Identifier (SID) was traditionally used to identify a file as belonging to a particular Oracle E-Business Suite environment, an Applications context is used in an AutoConfig-managed environment such as Oracle E-Business Suite Release 12. The default context name, also referred to in this chapter as <CONTEXT_NAME>, is <SID>_<hostname>.
Using an Applications context has a number of advantages:
- Simplifies overall management of an Oracle E-Business Suite system
- Allows easier startup and shutdown of applications services
- Permits services to be installed or deinstalled independently of others
- Integrates seamlessly with a shared application tier file system
- Enables use of Oracle Applications Manager for configuration management
- Facilitates support for Oracle Real Application Clusters
Before AutoConfig and the Applications context were introduced, configuration management tasks could be time-consuming and prone to error, in some cases requiring manual changes to be made to several configuration files. While individual configuration files are still used in an AutoConfig-enabled environment, they play a secondary role to an XML-based repository of Oracle E-Business Suite environment information, called the context file.
By centralizing the configuration information, AutoConfig simplifies procedures for activities that range from upgrading a technology stack component to starting and stopping applications services. Another benefit is that the various files AutoConfig employs can be updated via standard Oracle E-Business Suite patches.
There are separate context files for the application and database tiers of an Oracle E-Business Suite system.
Applications Context File -
The Applications context file,<INST_TOP>/appl/admin/<CONTEXT_NAME>.xml, is a repository for environment-specific details used by AutoConfig to configure the application tier. Information from this file is used to generate Oracle E-Business Suite configuration files and update relevant database profiles.
Information stored includes:
- Name and location of the database
- Port numbers for Forms and Web services
- Product-specific port numbers
- Information about application tier services controlled by AutoConfig
The values of the context variables that make up the context file are in part determined by the choices you make when you run Rapid Install. For example, when you specify that a particular application tier node is to be used as a concurrent processing server, the relevant variable will be set to execute the scripts that start the service.
Database Context File -
The database context file RDBMS_ORACLE_HOME>/appsutil/<CONTEXT_NAME> .xml,performs an equivalent role on the database tier. Information from this file is used to generate configuration files used on the database tier when AutoConfig is next run.
A number of key configuration and control scripts are employed in an AutoConfig environment. AutoConfig creates several directories for these scripts and their associated files.
AutoConfig Scripts :
Key AutoConfig configuration scripts on UNIX (command files on Windows) include:
adautocfg.sh - Wrapper script that passes the name of the specific environment context file to adconfig.sh. Located in <INST_TOP>/admin/scripts on the application tier, and <RDBMS_ORACLE_HOME>/appsutil/scripts/<CONTEXT_NAME> on the database tier.
adconfig.sh - Invoked by adautocfg.sh, this script is a wrapper for adconfig.pl. Located in <AD_TOP>/bin on the application tier, and <RDBMS_ORACLE_HOME>/appsutil/bin on the database tier.
adconfig.pl - Invoked by adconfig.sh, this Perl script calls the Java API to carry out the actual configuration tasks. Located in <AD_TOP>/bin on the application tier, and <RDBMS_ORACLE_HOME>/appsutil/bin on the database tier.
In addition to these configuration scripts, several additional AutoConfig scripts are used to help manage the Oracle E-Business Suite system.
AutoConfig Directories :
Several directories are created by AutoConfig, as shown in the following table.
AutoConfig Directories
Directory Name | Directory Contents |
<INST_TOP>/admin/install | Install scripts |
<INST_TOP>/admin/scripts | Control scripts |
<INST_TOP>/admin/log | Log files |
AutoConfig is used for a wide range of system configuration activities, from installation to maintenance, the following discussion of its operations is divided into several sections.
Context Value Management :
Context Value Management (CVM) is an AutoConfig component that is used to manage the values of variables in the context file, and automate required updates to it. CVM supports updates to both the application tier and database tier context files.
CVM actions include:
- Adding new variables to a context file
- Updating values of variables in an existing context file
- Applying new versions of context file templates
- Executing scripts or configuration tools that must complete before the AutoConfig engine starts, for example when generating the tnsnames.ora file
AutoConfig Files :
As well as the context files and configuration scripts that have already been described, AutoConfig uses several other types of file in its configuration management activities. These may themselves be divided into different categories.
Template Files :
AutoConfig template files are used as the starting point for creating site-specific configuration files. AutoConfig evaluates the context variables in a template file, determines the actual values required, and creates a configuration file with these values substituted. This process, described in more detail later in this chapter, is called instantiation. There is one template file for each configuration file. Template files are located in the various <PROD_TOP>/admin/template directories on the application tier, and in the <RDBMS_ORACLE_HOME>/appsutil/template directory on the database tier.
Template files used by AutoConfig can be divided into the following categories:
Templates for APPL_TOP Configuration Files -
These are either files requiring configuration-specific information in the APPL_TOP, or files used to load configuration profiles into the Oracle E-Business Suite database.
Templates for Management Scripts -
To run all the standard processes required by Oracle E-Business Suite, Rapid Install creates scripts to start and stop each of these required processes. These scripts need configuration information in order to:
Create the correct environments for each process
Start the processes with the correct parameters
Point the processes at the correct database instance (if applicable)
Driver Files :
AutoConfig driver files are used to list the corresponding template files and locations, and specify the commands to be executed. For example, the commands might update profile options.
Driver files are located in each <PROD>_TOP/admin/driver directory on the application tier, and in the <RDBMS_ORACLE_HOME>/appsutil/template directory on the database tier.
Configuration Files :
AutoConfig configuration files, such as httpd.conf, are created as a result of AutoConfig instantiating the corresponding template files. Configuration files contain values corresponding to the settings specified for a particular site. After AutoConfig has been run, numerous configuration files will have been created in various directories.
Role of the template and driver files
AutoConfig uses the various template files to determine the basic settings needed. There is one template file for each configuration file. Different versions of the template files exist for UNIX (for example httpd_ux.conf), and Windows (for example httpd_nt.conf).
The driver files list the names and locations of the files that need to have context variables replaced. They also define the phases into which instantiation is divided, and specify the commands that are to be executed for specific products. When AutoConfig runs, it cycles through the various <PROD>_TOP/admin/driver directories looking for driver files such as adtmpl.drv, fndtmpl.drv, and icxtmpl.drv.
As well as its instantiation activities, AutoConfig may execute other scripts, depending on the requirements of the specific Oracle E-Business Suite system.
Phases of Operation :
As AutoConfig parses the driver files, it carries out a series of actions, grouped into several distinct phases:
INSTE8 - Instantiates AutoConfig template files to the AutoConfig configuration files specified in the relevant template driver files.
INSTE8_SETUP - Executes setup scripts that carry out activities not involving connection to the database.
INSTE8_PRF - Executes setup scripts that update profile options.
INSTE8_APPLY - Executes setup scripts that carry out activities involving updates to the database.
BINCPY - Copies the file mentioned from the source file to the configuration file, creating parent directories for the latter if necessary. AutoConfig will report an error if the source file cannot be found.
BINCPY_IGERR - Copies the file mentioned from the source file to the configuration file, creating parent directories for the latter if necessary. AutoConfig will not report an error if the source file cannot be found.
AutoConfig carries out these actions in the following order:
All INSTE8 and BINCPY actions - Carries out all file instantiations called for during INSTE8, INSTE8_SETUP, INSTE8_PRF and INSTE8_APPLY, and all copying from source files to target configuration files.
INSTE8_SETUP actions - For the files that were instantiated in Step 1, AutoConfig runs all SETUP scripts.
INSTE8_PRF actions - For the files that were instantiated in Step 1, AutoConfig runs all PRF scripts.
INSTE8_APPLY actions - For the files that were instantiated in Step 1, AutoConfig runs all APPLY scripts.
Management Tasks :
There are several areas in which an administrator can use AutoConfig to update, control, and monitor an Oracle E-Business Suite system. While many tasks will normally be undertaken from Oracle Applications Manager, you may on occasion need to run a script (command file on Windows) from the command line.
Managing the Context :
Oracle Applications Manager enables you to edit the Applications context as required. From the Administration tab, choose AutoConfig and click on Edit Parameters for the relevant context file. After making a change to the context, you must run AutoConfig to update the relevant configuration files. Before doing so, you should examine the proposed changes by running the adchkcfg.sh configuration check script.
Do not edit E-Business Suite configuration files manually. Any changes will be lost when AutoConfig is next run.
On occasion, you may need to undo configuration changes that have been made. The previous configuration can be restored by running the restore.sh utility, which enables you to roll back the changes made by an AutoConfig run. This is achieved by utilizing the backup copies of the configuration files that are created when AutoConfig is run.
The backup files are located in <INST_TOP>/admin/out/<MMDDhhmm> on the application tier, and <RDBMS_ORACLE_HOME>/appsutil/out/<CONTEXT_NAME><MMDDhhmm> on the database tier, where the <MMDDhhmm> directory name indicates the month, day, hour and minute of the AutoConfig run.
You can restore the configuration that existed immediately before the current one by navigating to the appropriate backup directory and running the restore.sh script. To restore an earlier configuration, you must use the Context File History feature of Oracle Applications Manager.
Build Context Utility :
The adblxml utility, introduced in Release 12.1, can be used to create a new context file on the database tier. The new file acts as a central repository for database configuration information, and is essential in enabling AutoConfig on the database tier of an Oracle E-Business Suite instance.
A new context file on the database tier can be created using the following command:
perl $ORACLE_HOME/appsutil/bin/adbldxml.pl \ [template=<contextfile_template>][out=<contextfile_name>
Where <contextfile_template> is the location of the context template (default is $ORACLE_HOME/appsutil/template/adxdbctx.tmp), and <contextfile_name> is the absolute path of the context file to be generated (the default is $ORACLE_HOME/appsutil/<context_name>.xml).
Note: The adblxml utility is only supported on the database tier, not on the application tier.
Controlling the System :
AutoConfig utilizes a number of application tier control scripts, located in <INST_TOP>/admin/scripts.
Key Application Tier Control Scripts
Script Name | Function |
adstrtal.sh | Starts all application tier server processes |
adstpall.sh | Stops all application tier server processes |
adautocfg.sh | Runs AutoConfig |
The corresponding directory on the database tier is <RDBMS_ORACLE_HOME>/appsutil/scripts/<CONTEXT_NAME>, where control scripts allow the database and database listener processes to be started and stopped, and AutoConfig to be run.
Checking the System :
Several other scripts facilitate system management in an AutoConfig-managed environment such as Release 12. For example, you can identify the effects of proposed changes before you make them.
Configuration Check Utility
AutoConfig Search Utility
AutoConfig Profiler
Running AutoConfig in Parallel :
Introduced in Release 12.1, the parallel mode feature enables AutoConfig to be run simultaneously across multiple nodes of an Oracle E-Business Suite system. When running in parallel mode, AutoConfig uses the dbms_locks PL/SQL package to ensure that configuration of one node does not interfere with configuration of other nodes: this is required because certain AutoConfig configurations of one node depend on the configurations of other nodes.
Comments
Post a Comment