使用快速克隆方式克隆11i的应用系统 (ID 1594161.1)

使用快速克隆方式克隆11i的应用系统 (  ID 1594161.1)

使用快速克隆方式克隆11i的应用系统

九月 2013

克隆可以对一个已有环境创建一个一模一样环境。克隆的原因有很多，比如:

创建一个和生产环境相同的环境以便于测试、升级.

将已有的系统移植到新的硬件环境上.

创建舞台区以减少打补丁的停工期.

这篇文档描述了如何克隆11i应用环境的整个过程. 在My Oracle Support中，文档编号是 文档 230672.1 on My Oracle Support. 关于一些问题的问答，文档编号为 文档 216664.1.

注意: 快速克隆方式目前不支持在HP OpenVMS Alpha平台.

 

Attention: Windows用户请注意，这篇文档所使用的是UNIX平台的语法和目录，请用适合的Windows语法替换.

 

注意: 在这篇文档中所说的克隆的方法，必须要求全部遵循Autoconfig.

 

第一部分：前提条件 

使用快速克隆方式前需要执行的步骤.

第二部分：克隆11i版本的应用系统 

执行准备、拷贝、配置和确认已经克隆的应用环境.

第三部分：完成克隆 

执行完成克隆步骤.

第四部分：高级克隆方式 

执行高级克隆选项，例如刷新克隆和多节点克隆.

惯例（词汇表）

惯例（词汇表）

含义

源系统

被克隆的系统.

目标系统

克隆后产生的新系统.

APPLMGR

应用的文件系统用户(APPL_TOP和应用层)

ORACLE

数据库的文件系统用户(RDBMS ORACLE_HOME和数据库文件).

CONTEXT_NAME

CONTEXT_NAME是应用系统的环境文件。11.5.8或更早的版本，这个值通常被设置为[SID]。对于新的通过自动配置或者快速克隆的用户，CONTEXT_NAME将会被设置为[SID]_[HOSTNAME].

Monospace Text

表示命令行文本。按要求严格的输入.

[ ]

代表括弧内的变量。用变量值替换，不要带括弧.

第一部分：前提条件

克隆前，请对源系统进行打补丁和运行AutoConfig.

确认源系统和目标系统的软件版本

除了Oracle应用系统软件需求外 (参照Oracle Applications 版本 Installation Update Notes for your Platform), 以下的软件组建版本必须在源/目标系统上存在. “位置”列暗示软件组建必须出现的节点.

软件

最小满足版本

位置

细节

Oracle Universal Installer

2.2.0.19

源系统所有节点

在源系统的iAS以及RDBMS ORACLE_HOME上应用OUI22补丁 5035661 如果是数据库版本是Oracle 10g或更高版本的话，则不需要在RDBMS ORACLE_HOME上应用此补丁.

Perl

5.005

源系统和目标系统的数据库节点

如果iAS1022和数据库9i上可以使用Perl,或者从以下链接下载 Perl.com. Perl在克隆前需要在PATH中存在. Windows用户请注意：不要在MKSToolKit使用Perl.

JRE

1.1.8

源系统的数据库节点

如果通过快速安装方式未安装上RDBMS ORACLE_HOME的话，则需要安装JRE 1.1.8到[RDBMS ORACLE_HOME]/jre/1.1.8目录下.

JRE

1.3.1

源系统的数据库节点

仅适用于Windows用户：安装JRE 1.3.1到[RDBMS ORACLE_HOME]/jre/1.3.1目录下. 请见 Appendix A for installation instructions.

JDK

1.3.1

目标系统应用节点的中间层

参考 Upgrading to JDK 1.3 with Oracle Applications 11i on My Oracle Support.

Zip

2.3 

(或更高)

源系统所有节点

从InfoZip下载. ZIP必须在PATH中，如果使用文件大于2Gb，需要使用InfoZip ZIP 3.0或更高版本.

UnZip

5.52 

(或更高)

源系统所有节点

从InfoZip下载. UnZip必须在PATH中，如果使用文件大于2Gb，需要使用InfoZip UNZIP 5.52或更高版本.

OS utilities

N/A

目标系统所有节点

当运行adcfgclone.pl (Unix: make,ld,cc,ar - Windows: gnumake,link,cc,cmd) 命令时，OS utilities必须在PATH中

应用最新的AD Minipack

应用补丁 6502082 (11i.AD.I.6) 或更高版本. 

请参考 My Oracle Support 来获取最新的MiniPack补丁.

仅适用于Windows用户:

应用补丁 2237858 来获取对长文件名的支持.

应用最新的AutoConfig模板补丁

通过对应用系统的所有应用层节点使用TXK AutoConfig补丁来更新Oracle应用系统的文件系统. 

请参照My Oracle Support文档 165195.1 来获得最新的Autoconfig Template Rollup Patch.

应用最新的Rapid Clone补丁

通过在服务器节点的应用层上打以下的补丁来对应用系统的文件系统使用最新的快速克隆:

3453499 : 11i.ADX.F

9171650 : 11i RAPIDCLONE CONSOLIDATED FIXES JUL/2010

9874305 : ADMKAPPSUTIL.PL COMPLAINS ABOUT UNZIP VERSION

10182813 : Required if using 11gR2 version of the Database

8977646 : Required for Windows Platforms

15969486 : APPSST12C: RAPID CLONE LOOKING FOR OUI21 DIRECTORY IN ADPRECLONE.PL

16958392 : TCH12C: ADCFGCLONE.PL FAILURE BECAUSE OF DEPRACATED PARAMETERS

16872574 : TCH12C: ADCFGCLONE.PL FAILS TO REG DB 12C $OH ON SPARC/INTEL

19716864 : TCH12101:: BACKPORT OF 18991480 FOR EBS 11I

在应用层设置Rapid Clone

如果源系统是通过快速安装方法创建的，并且版本是11.5.5或更早的版本，并且没有安装AutoConfig的话，请参照My Oracle Support上的文档 165195.1 Migrating to AutoConfig on the Applications Tier ). 

所有用户都需要在应用层上运行AutoConfig (请参照My Oracle Support文档165195.1，第五部分: 维护系统配置).

在数据库层设置Rapid Clone

在RDBMS ORACLE_HOME上执行AutoConfig(以下指导内容请参照My Oracle Support文档165195.1 Migrating to AutoConfig on the Database Tier).

注意: 每次当在APPL_TOP上运行一个新的快速克隆或者AutoConfig，RDBMS ORACLE_HOME都会被更新. 

请参照My Oracle Support文档165195.1 Maintaining System Configuration 来同步在RDBMS ORACLE_HOME中Rapid Clone和Autoconfig文件.

 

维护快照信息

以APPLMGR用户登录到每一个应用层，通过ADADMIN运行维护快照信息.

参考 Oracle Applications Maintenance Utilities获取更多信息.

第二部分：克隆11i版本的应用系统

在源系统上使用快速克隆方式创建模板文件。再将源系统文件拷贝到目标系统后，快速克隆将会更新这些包含新的目标系统配置的模板。快速克隆不会改变源系统的任何配置.

克隆的过程分为3个部分:

准备源系统

执行以下的命令用来准备源系统用于克隆.

准备源系统数据库层 

以ORACLE用户登录源系统运行以下命令:

cd [RDBMS ORACLE_HOME]/appsutil/scripts/[CONTEXT_NAME]

perl adpreclone.pl dbTier

准备源系统应用层 

以APPLMGR用户登录源系统并且在每一个包含APPL_TOP的节点上运行以下命令:

cd [COMMON_TOP]/admin/scripts/[CONTEXT_NAME]

perl adpreclone.pl appsTier

拷贝源系统到目标系统

通过执行以下命令列表的步骤来拷贝源系统文件到目标系统文件。确保应用层文件用APPLMGR用户拷贝的，数据库层文件是用ORACLE用户拷贝的.

拷贝应用层文件系统

用APPLMGR用户登陆到源系统的应用层节点.

关闭应用层服务

从源系统节点拷贝以下应用层目录到目标系统:

[APPL_TOP]

[OA_HTML]

[OA_JAVA]

[OA_JRE_TOP]

[COMMON_TOP]/util

[COMMON_TOP]/clone

[COMMON_TOP]/_pages (如果路径存在)

[806 ORACLE_HOME]

[iAS ORACLE_HOME]

拷贝数据库层文件系统

用ORACLE用户登陆到源系统的数据库层节点.

对源系统数据库执行normal shutdown

从源系统拷贝数据库文件（DBF）到目标系统上

拷贝源系统的ORACLE_HOME到目标系统上

启动源系统的数据库和应用

注意: UNIX/Linux用户，请确保拷贝时软链接被拷贝。 另外，确认在ORACLE_HOME/bin路径下的以下可执行程序是所属root用户的(例如 nmo, nmhs, nmb, etc).

 

配置目标系统

执行以下命令来配置目标系统。将会有一些目标系统的相关值的提示输入（SID, PATH, Ports等等）.

配置目标系统的数据库服务器

以ORACLE用户登陆到目标系统，并输入以下命令配置并启动数据库:

cd [RDBMS ORACLE_HOME]/appsutil/clone/bin

perl adcfgclone.pl dbTier

配置目标系统的应用服务器

以APPLMGR用户登录到目标系统，并运行以下命令:

cd [COMMON_TOP]/clone/bin

perl adcfgclone.pl appsTier

注意: 对于Windows用户: 

运行本步骤之前，请添加[806 ORACLE_HOME]\bin到系统路径.

第三部分：完成克隆

本章节列举的步骤可能不是必须的，得根据您的执行情况以及克隆的系统而定.

更新配置选项

快速克隆只会更新地点层的配置选项选项。如果任何的配置选项选项有任何特殊的设置，必须手动更新他们.

更新打印机设置

如果一个新的克隆环境需要使用不同的打印机，则需要更新目标系统的打印机设定.

更新工作流配置设置

克隆一个应用系统不会更新工作流相关的信息。浏览下面的表格确认在目标系统上没有工作流所影响的环境制定数据.

表名

列名

列值描述

WF_NOTIFICATION_ATTRIBUTES

TEXT_VALUE

http://[old web host]，更新为新的web host

WF_ITEM_ATTRIBUTE_VALUES

TEXT_VALUE

http://[old web host]，更新为新的web host

WF_SYSTEMS

GUID

通过Workflow Administrator Web Applications职责，创建新的全局数据库名称.

WF_SYSTEMS

NAME

此值被新的全局数据库名称替换

WF_AGENTS

ADDRESS

用全局数据库名更新数据库链接.

FND_FORM_FUNCTIONS

WEB_HOST_NAME

更新为新的web host name

FND_FORM_FUNCTIONS

WEB_AGENT_NAME

更新为指向新的PLSQL监听者

FND_CONCURRENT_REQUESTS

LOGFILE_NAME

更新为正确的日志目录

FND_CONCURRENT_REQUESTS

OUTFILE_NAME

在目标系统上更新为新的目录

 

确认APPLCSF变量的设置

运行环境文件并检查变量APPLCSF指向一个可接受的目录。如果要修改，请修改contextfile中的s_applcsf后运行AutoConfig.

在ICX_PARAMETERS中修改 SESSION_COOKIE_DOMAIN 

如果目标系统在另外一个域名中，并且在源系统中SESSION_COOKIE_DOMAIN的值不为空，请根据新域名修改这个值.

重新执行SSL和SSO的设置

如果源系统有SSL或SSO，目标系统也希望使用SSL或者SSO，需要按照SSL/SSO文档重新配置。否则，如果目标系统不希望使用SSL或者SSO，这时，也需要按照SSL/SSO文档重新回退SSL/SSO设置.

Windows用户需要重启目标系统

一旦克隆完成，重启机器并启动服务.

 

第四部分：高级克隆方式

这部分描述高级克隆.

刷新一个目标系统

你可能需要定期的刷新一个目标系统用来同步源系统上的更改.

注意: 在刷新目标系统的数据层和应用层之前请在目标系统上备份目标系统的上下文文件.

执行以下步骤来刷新目标系统:

准备源系统

拷贝源系统到目标系统

如果APPL_TOP, 806 ORACLE_HOME 或者 iAS ORACLE_HOME需要刷新，则拷贝应用层文件系统。拷贝那些被更新了的应用层文件系统.

如果RDBMS ORACLE_HOME 或者 Database需要刷新，则拷贝数据库层文件系统。如果需要刷新数据库，ORACLE_HOME也同时需要刷新.

配置目标系统

当运行adcfgclone.pl命令时，指定已存在的目标系统的上下文文件:

cd [RDBMS ORACLE_HOME]/appsutil/clone/bin

perl adcfgclone.pl dbTier [Database Target Context File]

当数据库上下文文件是:

[RDBMS ORACLE_HOME]/appsutil/[Target CONTEXT_NAME].xml

cd [COMMON_TOP]/clone/bin

perl adcfgclone.pl appsTier [Appltop Target Context File]

当应用层上下文文件是:

[APPL_TOP]/admin/[Target CONTEXT_NAME].xml

完成克隆

从单节点克隆到多节点

这个过程允许原单节点系统克隆到多节点系统。一个应用系统由以下5种服务组成:

数据库服务器 (数据库层)

Forms 服务器 (应用层)

Web 服务器 (应用层)

并发请求服务器 (应用层)

Administration 服务器 (应用层)

从单节点到多节点的克隆过程中，每一个服务都会看作是自己的节点.

执行前提条件

在原系统和目标节点上都执行以下步骤.

克隆应用系统 11i

准备、拷贝和配置应用环境。当从单节点克隆到创建多节点的过程中，拷贝和配置的步骤需要在每一个目标系统的节点上执行。在配置的步骤时，你可以为每一个目标节点指定提示的服务类型。数据库ORACLE_HOME和数据库只是拷贝到运行数据库的节点上.

完成克隆

注意: 另一个修改由单节点到多节点的方式是共享APPL_TOP。请参照My Oracle Support文档233428.1

 

从多节点克隆到多节点

一个多节点系统可以克隆到另外一个多节点目标系统上.

从一个多节点克隆到一个多节点系统，在每一个节点都需要执行克隆步骤。例如：如果源系统包含3个节点，则需要执行3次克隆步骤.

克隆源系统节点1到目标系统节点1.

克隆源系统节点2到目标系统节点2.

克隆源系统节点3到目标系统节点3.

注意: 需要先克隆数据库节点.

 

在已存在系统上增加个节点

你可以使用快速克隆方式克隆一个节点，也可以将这个节点添加到已有的系统中。新节点将会正常运行或者座位一个子集. 遵循以下说明 Clone Oracle Applications 11i:

准备源系统，拷贝到新节点上并配置.

当adcfgclone.pl命令完成后，运行应用层环境文件并在目标系统中运行以下命令:

cd [COMMON_TOP]/clone/bin

perl adaddnode.pl

 

注意: 如果在已存在系统上SQL*Net访问安全是可用的，你需要先授权新节点通过SQL*Net访问数据库. 参见My Oracle Support文档281758.1 Managed SQL*Net Access from Hosts关于如何通过OAM归档的介绍.

 

减少多节点的节点数（合并APPL_TOP）

你可以使用快速克隆方式克隆一个多节点系统到一个单节点系统（或者多节点到更少节点的克隆），使用合并APPL_TOP方式. 参照My Oracle Support文档 233428.1 Merging existing APPL_TOPs.

克隆RAC系统

你可以使用快速克隆方式克隆一个RAC系统。当在克隆的过程中，你有可能需要在目标RAC系统中添加或移除节点.

注意: 以下步骤仅用于9i的RAC集群。对于10g和11g的RAC环境, 请参考文档 760637.1.

 

注意: 关于认证过的RAC系统和EBS的克隆，请参考文档783188.1.

请执行以下步骤来克隆一个RAC系统:

确认前提条件

应用TXK 补丁 3571388 (AutoConfig对于RAC环境也是支持的)

合并源系统集群ORACLE_HOMES到AutoConfig，在My Oracle Support文档165195.1 中描述。

准备源系统

在源系统集群中选择一个ORACLE_HOME。这个ORACLE_HOME将被主要用来创建目标系统的ORACLE_HOME。在上面运行"perl adpreclone.pl dbTier".

注意: 你也可以从源系统上克隆每一个ORACLE_HOME到目标系统上。在这种情况下，在每一个ORACLE_HOME上运行"perl adpreclone.pl dbTier".

 

拷贝源系统到目标系统

拷贝主ORACLE_HOME到目标系统集群的每一个节点上。例如：如果你的源系统的RAC集群有2个节点，你想克隆到目标集群上变为3个节点，这时你需要拷贝源系统的ORACLE_HOME到目标系统的3个节点上.

从源系统拷贝数据库文件到目标系统.

配置目标系统

登陆到目标集群的任何一个ORACLE_HOME上运行

cd [RDBMS ORACLE_HOME]/appsutil/clone/bin

perl adcfgclone.pl dbTier

这个步骤配置目标系统的RAC集群的第一个节点并且重新创建数据库控制文件。提示信息将收集关于目标RAC集群的每一个节点信息，并在随后的步骤中，数据将会被重新创建.

对于目标系统上每一个保留RDBMS ORACLE_HOME的，以ORACLE登录运行以下命令:

cd [RDBMS ORACLE_HOME]/appsutil/clone/bin

perl adcfgclone.pl dbTier

 

克隆应用层

跟随章节2中的步骤来准备、拷贝和配置应用层。当提示输入数据库SID的时候，指定任何一个RAC服务名字.

注意: 从一个RAC克隆到非RAC，跟随以上的步骤进行，除了拷贝主ORACLE_HOME到一个目标系统节点，并且在对于问题"Target instance is a Real Application Cluster (RAC) instance (y/n)"时回答”No”.

 

在RAC集群中增加节点

你可以使用快速克隆方式增加一个或多个节点到一个已经存在的RAC集群中.

注意: 以下步骤仅用于9i的RAC集群。对于10g和11g的RAC环境，请参照文档 760637.1.

 

Note: 关于认证过的RAC系统和EBS的克隆，请参考文档783188.1.

执行以下步骤:

在已经存在的集群中选择任何一个ORACLE_HOME，并运行以下命令:

cd [RDBMS ORACLE_HOME]/appsutil/clone/bin

perl adcfgclone.pl dbTier

这个ORACLE_HOME将被做为主的ORACLE_HOME来创建新节点.

拷贝主ORACLE_HOME文件系统到新节点.

在init.ora文件中，设置变量"cluster_Database_instances"来匹配新节点数量.

注意: 当RAC转换完后，上下文变量%s_dbClusterInst%需要在数据库上下文文件中被设置为相应的新的节点数.

从OAM的上下文编辑器中，设置新的值并在每一个ORACLE_HOME上运行AutoConfig.

 

重新配置包含新节点的RAC集群:

登录到新节点，或任何一个新增的节点（即使增加多个节点），运行以下命令:

cd [RDBMS ORACLE_HOME]/appsutil/clone/bin

perl adcfgclone.pl dbTier

 

Note: 你将会被提示对新集群所有节点的格式和被问及在这个节点执行下一步以完成adcfgclone.pl.

 

登录到原集群的每一个节点上运行如下命令:

cd [RDBMS ORACLE_HOME]/appsutil/clone/bin

perl adcfgclone.pl addracNode [Context File]

回到第一个节点完成adcfgclone.pl

如果你在一个原始集群上增加多于一个节点的时候登录到每一个节点上并运行

cd [RDBMS ORACLE_HOME]/appsutil/clone/bin

perl adcfgclone.pl dbTier

克隆共享文件系统

你可以使用快速克隆方式克隆一个共享APPL_TOP系统。自从所有的节点共享一个单独的APPL_TOP，你只需要克隆源系统中的一个到它的目标机上，并且可以在目标系统上直接增加更多的可共享的APPL_TOP。在源系统上选择一个共享的APPL_TOP节点并执行以下步骤:

执行前提条件

在节点A上和每一个目标节点上执行这些步骤.

克隆应用系统11i

在数据库层和A节点（应用层）上执行一次全克隆（准备、拷贝和配置）.

添加共享文件系统节点到目标系统中

在目标系统中, 遵照My Oracle Support文档233428.1 adding a Node to a shared APPL_TOP System在共享文件系统上增加更多的节点来吻合原系统的拓扑结构.

附录 A： 在RDBMS ORACLE_HOME上安装JRE1.3.1

Windows用户需要执行以下步骤:

从 Sun MicroSystems下载JRE 1.3.1 .

运行安装可执行程序

当提示安装JRE路径时，点击浏览并数据路径: [RDBMS ORACLE_HOME]\jre\1.3.1

接受安装的缺省选项.

JRE 1.3.1将被安装到： [RDBMS ORACLE_HOME]\jre\1.3.1 .

附录 B：在快速克隆的过程中手动重新创建数据库控制文件.

这个附录说明了在快速克隆过程中手工创建目标数据库控制文件的过程. 当使用裸设备热备份数据库的时候，需要用以下步骤替换掉2.3a:

以ORACLE用户登陆到目标系统上

配置 [RDBMS ORACLE_HOME>

cd [RDBMS ORACLE_HOME]/appsutil/clone/bin

perl adcfgclone.pl dbTechStack

手工创建目标数据库的控制文件

在open模式下启动目标系统数据库

在数据库上运行程序库更新脚本

cd [RDBMS ORACLE_HOME]/appsutil/install/[CONTEXT NAME]

sqlplus "/ as sysdba" @adupdlib.sql [libext]

在HP-UX机器上[libext]需要设置为’sl’，对于其他UNIX平台，设置为’so’，对于Windows平台，需要设置为’dll’.

配置目标数据库（数据库模式必须是open）

cd [RDBMS ORACLE_HOME]/appsutil/clone/bin

perl adcfgclone.pl dbconfig [Target Context File]

目标上下文环境文件在:

[RDBMS ORACLE_HOME]/appsutil/[Target CONTEXT_NAME].xml 

NOTE:281758.1 - Oracle Applications Manager in 11.5.10 - Additional Features

NOTE:216664.1 - FAQ: Cloning Oracle Applications Release 11i

NOTE:233428.1 - Sharing the Application Tier File System in Oracle Applications Release 11i

NOTE:230672.1 - Cloning Oracle Applications Release 11i with Rapid Clone

NOTE:760637.1 - Manually Cloning Oracle Applications Release 11i with 10g or 11g RAC

NOTE:783188.1 - Certified RAC Scenarios for E-Business Suite Cloning

BUG:3361161 - ADGENTOPFILE.SH USES S_CONTEXTFILE - BUT IT'S NOT DEFINED IN ADXMLCTX.TMP

NOTE:165195.1 - Using AutoConfig to Manage System Configurations with Oracle Applications 11i