用AutoConfig管理Oracle 电子商务套件第12版的系统配置

本文转自Oracle support用以供大家参考学习

用AutoConfig管理Oracle 电子商务套件第12版的系统配置 (Doc ID 1536298.1)

惯例注意: Windows用户 - 此文件指定目录时通常使用UNIX语法。在适当的地方替换为相应的Windows语法。
惯例意义APPLMGR拥有应用文件系统(APPL_TOP和应用层的技术堆栈)的用户ORACLE拥有数据库文件系统(RDBMS ORACLE_HOME和数据库文件)的用户.CONTEXT_NAME您的上下文的逻辑名称。默认:<SID>_<主机名>CONTEXT上下文文件的完整路径(无论是应用上下文文件或数据库上下文文件)
默认: <INST_TOP>/appl/admin/<CONTEXT_NAME>.xml 和 <RDBMS_ORACLE_HOME>/appsutil/<CONTEXT_NAME>.xmlAPPSpwd应用数据库的用户密码APPSuser/APPSpwd应用数据库的用户名和密码等宽字体文本表示命令行文本。键入以下所示的完整命令.\
在UNIX系统中,一行命令结束时输入反斜杠字符表示命令行延续到下一行.AutoConfig模板文件自动配置模板文件包含命名的标签,自动配置运行时它们被更换特定于实例的信息。例如: <FND_TOP>/admin/template/afwebprf.sh
自动配置模板文件不应被编辑.
自定义模板文件要自定义自动配置管理的配置文件,复制自动配置模板文件到自定义模板文件并编辑自定义模板文件。例如: <FND_TOP>/admin/template/custom/afwebprf.sh
当自动配置检测到一个自定义模板文件,自动配置在自动配置模板文件的位置实例化这个文件.
AutoConfig模板目录Oracle提供自动配置模板文件的目录. 每一个产品有一个自动配置模板目录.
位置: <product_top>/admin/template
<RDBMS ORACLE_HOME>/appsutil/template
例如: <FND_TOP>/admin/template
<ORACLE_HOME>/appsutil/template
自定义模板目录自定义自动配置模板文件的目录.
位置: <product_top>/admin/template/custom
<RDBMS ORACLE_HOME>/appsutil/template/custom
例如: <FND_TOP>/admin/template/custom
<ORACLE_HOME>/appsutil/template/custom
配置文件运行自动配置时创建的实例化配置文件中。例如: <INST_TOP>/admin/install/afwebprf.sh< >在尖括号中的文字代表一个变量。替换变量文本为一个有效值。不要键入尖括号.

第1部分: AutoConfig的组件和工具概述AutoConfig是一个工具,支持自动配置Oracle电子商务套件第12版的实例。

 配置一个应用程序实例所需的所有信息被收集到两个本地资源库中,被称为应用上下文文件和数据库上下文文件。 当AutoConfig运行在应用层上时,它使用应用下文文件中的信息来生成所有的配置文件并更新数据库配置文件。当自动配置运行在数据库层上时,它使用数据库层上下文文件中的信息来生成所有数据库层使用的配置文件。
AutoConfig 提供几大好处,包括:

 * 配置支持: AutoConfig配置APPL_TOP, ORACLE_HOMEs, 及配套的技术堆栈.
 * 配置管理: AutoConfig集中管理一个应用实例的配置和重新配置.
 * 配置的交付和修补: 新技术的吸收被简化,因为新的配置和配置的变化,可以以一个补丁的形式被提供.

1.1. AutoConfig 组件AutoConfig由几个部分组成:

组件描述应用层上下文文件一个位于INST_TOP包含特定APPL_TOP信息的XML信息库.数据库层上下文文件一个位于RDBMS ORACLE_HOME包含特定数据库层信息的XML信息库.AutoConfig模版文件文件包含命名的标签, 被从适当的上下文中取得的特定于实例的信息替换(“实例化”).AutoConfig驱动文件每一个Oracle电子商务套件的产品都维护一个被AutoConfig使用的驱动文件. 驱动文件列出AutoConfig的模版文件和它们的目标位置.AutoConfig脚本一组脚本,提供了AutoConfig APIs的一个简化界面.Oracle电子商务套件第12版的应用层启用了自动配置, 并且有一个存储在INST_TOP中的应用层上下文文件<INST_TOP>/appl/admin/<CONTEXT_NAME>.xml. 通过快速安装的Oracle电子商务套件第12版数据库层同样启用了自动配置, 并且有一个存储在RDBMS ORACLE_HOME中的数据库层上下文文件<RDBMS ORACLE_HOME>/appsutil/<CONTEXT_NAME>.xml. 当任意一个上下文文件或模版文件被改动了, AutoConfig工具会更新Oracle电子商务套件第12版的配置.
AutoConfig也可以被用来开启或关闭它管理的所有应用程序系统的服务.

1.2. AutoConfig 工具下面是AutoConfig工具的一个汇总.

脚本位置
工具adautocfg.sh/cmd应用层:
<INST_TOP>/admin/scripts

数据库层:
<RDBMS_ORACLE_HOME>/appsutil/scripts/<CONTEXT_NAME>
这个脚本用来运行自动配置.

更多信息adchkcfg.sh/cmd应用层:
<AD_TOP>/bin

数据库层:
<RDBMS_ORACLE_HOME>/appsutil/bin这个脚本可以在运行AutoConfig之前运行, 用来查看运行AutoConfig的变化. 这将生成一个报告,显示现有的配置和运行AutoConfig之后的配置之间的差别.

更多信息GenCtxInfRep.pl
应用层:
<FND_TOP/patch/115/bin

数据库层:
<RDBMS_ORACLE_HOME>/appsutil/bin以一个上下文变量名字的全部或部分作为关键字,这个脚本可以用来找出该上下文变量及其使用的模版的详细信息.

更多信息adtmplreport.sh/cmd
应用层:
<AD_TOP>/bin

数据库层:
<RDBMS_ORACLE_HOME>/appsutil/bin提供实例文件的位置,这个脚本可以用来收集相关AutoConfig模板文件位置的信息,反之亦然.

更多信息admkappsutil.pl
应用层:
<AD_TOP>/bin

此脚本在给数据库层打补丁的时候被使用. 运行此脚本生成appsutil.zip,可以将它复制到数据库层以将补丁迁移到数据库层.

更多信息除了以上的工具, 还有用来管理EBS服务运行时进程的开启和关闭的工具. 这些工具在第7部分被列出.

第2部分: 用自动配置 工具进行系统配置

2.1. 预览运行AutoConfig的影响

运行AutoConfig之前, 检查配置工具可能会被运行以查看AutoConfig下一次运行后文件系统和数据库的更改. 这步是可选的.

执行如下命令来运行检查配置工具.

 * 数据库层:

  * Unix:
sh <RDBMS_ORACLE_HOME>/appsutil/bin/adchkcfg.sh contextfile=<CONTEXT_FILE>

  * Windows:
<RDBMS_ORACLE_HOME>\appsutil\bin\adchkcfg.cmd contextfile=<CONTEXT_FILE>

 * 应用层:

  * Unix:
sh <AD_TOP>/bin/adchkcfg.sh contextfile=<CONTEXT_FILE>

  * Windows:
<AD_TOP>\bin\adchkcfg.cmd contextfile=<CONTEXT_FILE>

 

2.2. 在数据库层运行AutoConfig在如下情形中,需要在数据库层运行AutoConfig

 * 迁移一个补丁到数据库层后, 检查配置工具报告任何潜在的模版更改.
 * 在数据库层做自定义后
 * 数据库层或应用层升级后
 * 从备份磁带恢复数据库或Oracle主目录后
 * 数据库层JDK升级后
 * 使用支持程序(如fnd_conc_clone.setup_clean)手动清除网络服务拓扑信息后. 随后,自动配置必须在应用层节点运行.
 * 注册一个RAC节点后.
 * 在共享文件系统设置APPL_TOP后.
 * 所有文件中说需要在数据库层运行自动配置的其他情况.

执行如下命令在数据库层运行AutoConfig.

 * Unix:
sh <RDBMS_ORACLE_HOME>/appsutil/scripts/<CONTEXT_NAME>/adautocfg.sh

 * Windows:
<RDBMS_ORACLE_HOME>\appsutil\scripts\<CONTEXT_NAME>\adautocfg.cmd

注意:

 * 数据库服务器和数据库监听在自动配置运行时必须保持开启. 其他数据库服务可以被关闭.
 * 运行自动配置可能更改已存在的环境文件. 运行自动配置之后, 您应该在运行任何应用程序工具之前总是设定环境,以应用已更改的环境变量.

2.3. 在应用层运行AutoConfig

在所有应用层节点运行AutoConfig.

执行如下命令运行AutoConfig.

 * Unix:
sh <INST_TOP>/admin/scripts/adautocfg.sh

 * Windows:
<INST_TOP>\admin\scripts\adautocfg.cmd

注意:

 * 数据库服务器和数据库监听在运行自动配置时必须保持开启. 只有应用层服务器可以被关闭.
 * 运行自动配置可能更改已存在的环境文件. 运行自动配置之后, 您应该在运行任何应用程序工具之前总是设定环境,以应用已更改的环境变量.

2.4. 查看AutoConfig日志文件

AutoConfig日志文件被存储在:

层目录应用<INST_TOP>/admin/log/<MMDDhhmm>数据库<RDBMS ORACLE_HOME>/appsutil/log/<CONTEXT_NAME>/<MMDDhhmm>每一个AutoConfig会话创建一个日志文件. 它包含AutoConfig在运行过程中进行的每一个动作的细节.

2.5. 回滚一个AutoConfig会话每次AutoConfig运行都创建一个回滚脚本

来自每个AutoConfig会话的回滚脚本和所有备份配置文件都被存储在:

层目录应用<INST_TOP>/admin/out/<MMDDhhmm>数据库<RDBMS ORACLE_HOME>/appsutil/out/<CONTEXT_NAME>/<MMDDhhmm>
<MMDDhhmm> 指 (AutoConfig 运行的月,日,时,分)
回滚一个AutoConfig会话, 执行如下命令:

 * UNIX
restore.sh

 * Windows
restore.cmd

第3部分: 打AutoConfig补丁

在电子商务套件R12实例上打自动配置补丁, 自动配置需要在应用层和数据库层都被启用.

3.1. 应用最新的AutoConfig更新为了获取应用层和数据库层最新的AutoConfig更新, 按顺序执行下列步骤:

 1. 应用TXK AutoConfig 模板补丁
为应用实例中的所有应用层应用最新的AutoConfig模板补丁 (Patch 9386653 - 12.0.X 客户, Patch 8919489 - 12.1.X 客户) 以将最新的AutoConfig文件更新到Oracle应用程序文件系统中.

12.0.X上的Windows Itanium客户应该应用一个额外的one-off 补丁, 6501658. 为了应用这个one-off补丁, 客户需要至少在12.0.2补丁集.

12.0.X上运行分离层模式的Windows Itanium及Windows 2008 x86-64 客户应该应用额外的one-off补丁 Patch 13742583.

注释: 配置管理的ADX和TXK汇总补丁已被合并.

 2.  复制AutoConfig到RDBMS ORACLE_HOME
执行如下步骤更新RDBMS ORACLE_HOME文件系统的自动配置文件:

  * 应用层 (APPLMGR用户):

   * 登陆到APPL_TOP环境 (运行环境文件)
   * 创建appsutil.zip文件
perl <AD_TOP>/bin/admkappsutil.pl

   * 这将会在<INST_TOP>/admin/out下面创建appsutil.zip

  * 数据库层 (ORACLE用户):

   * 复制或FTPappsutil.zip文件到<RDBMS ORACLE_HOME>
cd <RDBMS ORACLE_HOME>
unzip -o appsutil.zip

 

 3. 运行AutoConfig
按照第2部分中2.2和2.3描述的那样在数据库层运行AutoConfig, 然后在应用层运行AutoConfig.

3.2. 在一个新的Oracle主目录启用AutoConfigR12中, 在应用层上AutoConfig默认是被启用的. 但是在数据库层,它在如下情况中可能没有被启用:

 * 数据库层不是用快速安装创建的
 * 跨平台的数据库层迁移
 * 升级到11g数据库
 * 从Applications 11i到R12的数据库层升级

按顺序执行如下命令, 以启用数据库层AutoConfig:

 1. 在应用层应用补丁 6636108
12.0.X上的客户需要应用这个补丁, 它提供工具adbldxml以在数据库层生成上下文文件. 这个补丁也包含于最新的AutoConfig模板补丁 (Patch 9386653 - 12.0.X客户, Patch 8919489 - 12.1.X客户)中.

注释: 若您的实例是在12.0.X上并且没有升级到10.1.3.3 AS补丁集, 需要应用补丁4585869 以使用工具adbldxml.

 2. 复制AutoConfig到RDBMS ORACLE_HOME
按照3.1部分中的步骤2, 将上面补丁提供的新的自动配置文件更新到RDBMS ORACLE_HOME文件系统.

 3. 在数据库层安装JRE
按照下面的步骤,确保应用层和数据库层的JRE版本至少是1.5或更高版本:

  * 若您使用的是"完全认证" 平台, 请参阅My Oracle Support文件 418664.1 在目录<RDBMS_ORACLE_HOME>/appsutil下安装jre.

  * 若您使用的是 "只是数据库层" 平台, 请参阅My Oracle Support文件 456197.1在目录<RDBMS_ORACLE_HOME>/appsutil下安装jre.

 4. 生成数据库层上下文文件
执行如下命令创建您的数据库层上下文文件:

perl <RDBMS_ORACLE_HOME>/appsutil/bin/adbldxml.pl
注意: 若您建立运行在RAC上的实例的上下文文件, 当执行工具adbldxml时所有RAC实例必须都开起来. 此工具连接到所有的RAC实例以收集关于配置的信息.

 5. 在数据库层运行AutoConfig
执行如下命令在数据库层运行AutoConfig:

  * Unix:
<RDBMS_ORACLE_HOME>/appsutil/bin/adconfig.sh contextfile=<context_file>

  * Windows:
<RDBMS_ORACLE_HOME>\appsutil\bin\adconfig.cmd contextfile=<context_file>

 

第4部分: 自定义AutoConfig管理的配置

AutoConfig是简化和规范Oracle电子商务套件环境中的配置管理任务的一个工具. AutoConfig生成的配置可能并不总是满足您的特定需求, 它可能是需要为您的环境自定义AutoConfig.
你可能想自定义AutoConfig的例子, 包括:

 * 启动Oracle应用服务时, 启动额外的服务或进程
 * 定义您的OC4J配置
 * 扩展Oracle Forms以与第三方Java版本整合
 * 开发AutoConfig维护的自定义应用程序

从历史上看,Oracle没有文件说明如何实现自定义的过程. 如果您试图通过手动编辑自定义AutoConfig-生成的文件, 您的更改会在每次运行自动配置时丢失. 为了避免这种情况, Oracle技术支持可能指示您在配置文件的"Begin/End customizations"块之间添加自定义. 这种有限的和不灵活的方法现在已经被一个完全被支持的机制所取代, 它以最大的灵活性及每次运行AutoConfig后保存您的自定义来扩展AutoConfig-维护的环境.

4.1. AutoConfig自定义的先决条件

自定义AutoConfig之前, 必须满足某些先决条件.

 1. 查看当前的配置如第5.3部分中所描述的, 运行AutoConfig检查工具. 检查报告中的任何差异并确定要作为自定义实施的手动配置更改.

 2. 查看和迁移现有的自定义如果您过去在"Begin/End customizations"块之间实施了自定义, 您现在必须迁移这些设置. 执行如下命令:

平台层命令UNIX应用<AD_TOP>/bin/adcustomizer.sh contextfile=<CONTEXT_FILE>数据库<RDBMS ORACLE_HOME>/appsutil/bin/adcustomizer.sh contextfile=<CONTEXT_FILE>Windows应用<AD_TOP>\bin\adcustomizer.cmd contextfile=<CONTEXT_FILE>数据库<RDBMS ORACLE_HOME>\appsutil\bin\adcustomizer.cmd contextfile=<CONTEXT_FILE>adcustomizer 脚本:

  1. 检测所有包含 "Begin/End customizations" 块的