Cloning Oracle Applications Release 11i

Page 1 of 8

FAQ: Cloning Oracle Applications Release 11i [ID 216664.1] Modified 26-DEC-2011 View Change log Type FAQ Status PUBLISHED

Frequently Asked Questions Cloning Oracle Applications Release 11i

June 2005

Questions Cloning Concepts

1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16. 17. 18. What is cloning? How can I clone an Oracle Applications system? What are the differences between the two cloning methods? What is the AD Cloning utility? What is Rapid Clone? How do I determine whether my system is Rapid Clone enabled? What is AutoConfig? How do I determine whether my system is AutoConfig enabled? We are running Release 11.5.7 (or any prior release), which cloning method can we use? We are running Release 11.5.8 (or any later release), which cloning method can we use? Our Oracle Applications system is on Windows, which cloning method can we use? We have a Platinum installation of Oracle Applications. Can we clone our system? Can I clone from one operating system version to another? Can I clone from one platform to a different platform? Can I reclone just the database? Can I clone a single-node system to a multi-node system? Can I clone a multi-node system to a single-node system? What cloning options are available for each cloning method?

Rapid Clone concepts

19. 20. 21. 22. 23. 24. Does Rapid Clone modify the source system? How does adcfgclone.pl know the target system values? What is the port pool? What if I want to give a specific value to a Server Port? Does Rapid Clone preserve the patch history? Can I clone a clone ? Can I change the database dbfs layout while cloning?

Rapid Clone and the oraInventory

25. 26. 27. 28. 29. 30. 31. 32. What is the oraInventory? What is a binary oraInventory? Is my Inventory binary? What is a XML oraInventory? Is my Inventory XML? What is the Global (or Central) Inventory? What is the Local (or Home) Inventory? How does Rapid Clone deal with the oraInventory? Why don't I need to manually copy the oraInventory when cloning? What does OUISetup.pl do?

Rate this document

Questions and Answers

1. What is cloning? Answer: Cloning is the process of creating an identical copy of an already existing Oracle Applications system. [top]

1. How can I clone an Oracle Applications system? Answer: There are two cloning methods documented in the following white papers available off of Oracle MetaLink Note 230672.1 Cloning Oracle Applications Release 11i Cloning Oracle Applications Release 11i with Rapid Clone Note: The third Cloning method (Cloning Oracle Applications Release 11i with AutoConfig) has been fully replaced by Cloning with Rapid Clone, and is no longer supported. [top]

1. What are the differences between the two cloning methods? Answer: Cloning Oracle Applications Release 11i was originally published in conjunction with Release 11.5.5 and is applicable for all 11i releases up to 11.5.5 that are not AutoConfig enabled.

https://support.oracle.com/CSP/main/article?cmd=show&type=NOT&id=216664.1

1/24/2012

Cloning Oracle Applications Release 11i

Page 2 of 8

Cloning Oracle Applications Release 11i with Rapid Clone is applicable for all 11i systems that have migrated to AutoConfig and enabled Rapid Clone. This method contains steps to install AutoConfig and Rapid Clone. [top]

1. What is the AD Cloning utility? Answer: AD Cloning utility (adclone.pl) is the name of the cloning command line utility. This utility is used to preserve and apply configuration information to the cloned target system. [top] 1. What is Rapid Clone? Answer: Rapid Clone is the new cloning utility introduced in Release 11.5.8. Rapid Clone leverages the new installation and configuration technology utilized by Rapid Install. See OracleMetaLink Note 230672.1 (Cloning Oracle Applications 11i with Rapid Clone) for instructions on installing and enabling Rapid Clone. [top] 1. How do I determine if my system is Rapid Clone enabled? Answer: First, verify that your system is AutoConfig enabled. Then, verify that you have applied the latest Rapid Clone patch documented in OracleMetaLink Note 230672.1 (Cloning Oracle Applications 11i with Rapid Clone). See Searching the Patch History Database in the AD Procedures Guide for instructions on searching for patches applied to your system. [top] 1. What is AutoConfig? Answer: AutoConfig is a configuration tool that supports automated configuration of an Oracle Applications Instance. All of the information required for configuring an Applications instance is collected into a central repository, called the Applications Context. When the AutoConfig tool runs, it uses information from the Applications Context file to generate configuration files and update database profiles. See OracleMetaLink Note 165195.1 for details on installing and migrating to AutoConfig. [top] 1. How do I determine if my system is AutoConfig enabled? Answer: There are several identifiers for when the system is AutoConfig enabled. The following are two common indicators: Open the environment file APPSORA.env in your APPL_TOP. If the top of the file says that it is maintained by AutoConfig, then your system is probably using AutoConfig. Check if there is an Applications Context file in the APPL_TOP/admin directory. This file will typically be named <SID>.xml or <SID>_<HOSTNAME>.xml. Check if there is an Applications Context file in the RDBMS ORACLE_HOME under the appsutil directory. This file will typically be named <SID>.xml or <SID>_<HOSTNAME>.xml. See OracleMetaLink Note 165195.1 for more details on identifying if your system already uses AutoConfig. [top] 1. We are running Release 11.5.7 (or any prior release), which cloning method can we use? Answer: Due to the advancements in the cloning solution with Rapid Clone, all customers are now recommended to move to using Rapid Clone. if you are on release 11.5.7 or any release before 11.5.7, you will need to first enable AutoConfig on your system, if not already done, before you can use Rapid Clone as documented in the Cloning Oracle Applications Release 11i with Rapid Clone white paper. [top] 1. We are running Release 11.5.8 (or any later release), which cloning method can we use? Answer: In 11.5.8 AutoConfig is enabled on the middle tier out of the box. In 11.5.9 and any later release, AutoConfig is enabled by default on both the database tier and the middle tier. Update AutoConfig and Rapid Clone code to the latest code line and use Rapid Clone to clone your system. Full instructions are in Cloning Oracle Applications Release 11i with Rapid Clone document 230672.1 on OracleMetalink. [top] 1. Our Oracle Applications system is on Windows, which cloning method can we use? Answer: If your system is on a release prior to 11.5.7 and is not AutoConfig enabled, use the method documented in the Cloning Oracle Applications Release 11i white paper. If your system is on any AutoConfig-enabled 11i release, use the method documented in the Cloning Oracle Applications Release 11i with Rapid Clone white paper. [top]

https://support.oracle.com/CSP/main/article?cmd=show&type=NOT&id=216664.1

1/24/2012

Cloning Oracle Applications Release 11i

Page 3 of 8

1. We have a Platinum installation of Oracle Applications. Can we clone our system? Answer: Yes, cloning a Platinum system using the Rapid Clone method is no different than cloning a non -Platinum installed system. [top] 1. Can I clone from one operating system version to another? Answer: Yes, if the target system platform is binary compatible with the source system platform. For example, if you have an existing single-node Oracle Applications system on Solaris 2.6, you could clone it to a node running Solaris 8, but not to a node running HP-UX. Note that cloning from a higher version of a platform to a lower version is not supported, for example, from Solaris 8 to Solaris 2.6. Other examples of binary compatibility for Oracle Applications are: AIX 4.3.3 to AIX 5.1 (32-bit) HP-UX 11.0 to HP-UX 11i Windows NT to Windows 2000 Within a same platform you can also clone from a 32bit source system to a 64bit target system. Note (AIX only): when cloning from AIX 32bit to AIX 64bit, apply patch 2896876 (64bit kernel extension for Oracle) on the target system prior to running adcfgclone.pl. [top] 1. Can I clone from one platform to a different platform? Answer: Yes, you can clone or migrate the Applications middle tier from any platform to Linux or any supported Unix platform using the procedure described in document 238276.1 "Migrating to Linux with Oracle Applications Release 11i". [top] 1. Can I reclone just the database? Answer: Yes, if the source system has changed and you want to update the target system with these changes, you can reclone just the changed database. If Applications patches were applied to the source system, the APPL_TOP and the database must be cloned to keep the file system and database synchronized. See the Recloning section in the white papers for details. [top] 1. Can I clone a single-node system to a multi-node system? Answer: The Rapid Clone cloning method allows for cloning a single-node system to a multi-node system. See the Cloning Oracle Applications Release 11i with Rapid Clone white paper for details. [top] 1. Can I clone a multi-node system to a single-node system? Answer: You can use Rapid Clone to merge multiple APPL_TOP and COMMON_TOP file systems into a single APPL_TOP and COMMON_TOP file system. For more details about this procedure, see "Section 3: Merging existing APPL_TOPs into a shared APPL_TOP" in document 233428.1 on OracleMetaLink. [top] 1. What cloning options are available for each cloning method? Answer: The table below shows the cloning options that are currently available for each cloning method. Single Multinode node to Recloning to Single Multinode node Single node to Multinode Multinode With Windows to Oracle9i Platform Single Database node

Cloning Not Not Not Oracle Available Available Available Available Available Available Available Applications Cloning Oracle Applications Available Available Available Available Available Available Available with Rapid Clone

[top] 1. Does Rapid Clone modify the source system? Answer: No, Rapid Clone does not modify the source system. adpreclone.pl prepares the source system to be cloned by collecting information about the database and creating generic templates of files containing source specific hardcoded values. These templates are stored in the appsutil/template directory leaving the original files untouched. This process usually takes a few minutes to complete the first time. Migrating to Autoconfig on the database node (pre-req to Rapid Clone), however, will update the RDBMS init.ora and network listener files. See the instructions in the Autoconfig document

https://support.oracle.com/CSP/main/article?cmd=show&type=NOT&id=216664.1

1/24/2012

Cloning Oracle Applications Release 11i

Page 4 of 8

165195.1 (Section 4: Migrating to AutoConfig on the Database Tier) on how to preserve customizations to these files. [top]

1. How does adcfgclone.pl know the target system values? Answer: adcfgclone.pl will prompt for the values required to create the new context file used to configure the target system. A few values are calculated from the current target system (hostname, user and group). The rest of the target specific values are prompted for: Prompt Comment database SID Target database SID domain name Target system domain name Prompts specific to the DB Tier Target System database Target System database name name Target instance is a Real Answer yes if the target system is going to be part of a Application Cluster RAC instance. (RAC) instance (y/n) This prompt only appears when you answered "yes" to the previous question. Answer yes" to this question if the current host is the first node being configured in the target system RAC cluster. The tool will then ask for the number of nodes that will exist in the final RAC instance and gather, the following information for every node: - Hostname - Database Sid - Instance number Current node is the first - Listener port node in an N Node RAC - Private interconnect name Cluster (y/n) Answer "no" to this qstion if at least one node of the target RAC cluster has already been configured by Rapid Clone (i.e if you already replied "yes" to this question for any other node in the cluster). The tool will then prompt for the following information to connect to a life node (the answers must describe a node that has already been configured): - Hostname - Database Sid - Listener port RDBMS ORACLE_HOME Path to the Target system RDBMS ORACLE_HOME directory Number of DATA_TOP's: Database mount points. Enter the number of distinct DATA_TOP 1: directories containing the target database dbfs, then their DATA_TOP 2: paths. DATA_TOP 3: Prompts specific to the Apps Tier database server node hostname of the machine hosting the database server Answer yes if the target system is part of a multi-nodes configuration. The tool with then prompt for the hostnames Does the target system of: have more than one - concurrent processing node applications tier server - administration node node (y/n)? - forms server node - web server node Answer yes if the target system APPL_TOP is divided across multiple mount points. The tool will then prompt for each auxiliary mount (4 mounts): Is the target system - APPL_TOP mount point APPL_TOP divided into - APPL_TOP aux.1 multiple mount points - APPL_TOP aux.2 (y/n)? - APPL_TOP aux.3 Note: if your APPL_TOP is divided into 2 or 3 mounts only, you can specify identical mounts to the above prompts. APPL_TOP mount point APPL_TOP directory COMMON_TOP COMMON_TOP directory directory 8.0.6 ORACLE_HOME 8.0.6 ORACLE_HOME directory directory iAS ORACLE_HOME iAS ORACLE_HOME directory directory Location of JDK 1.3.1 Location of JDK 1.3.1 Prompt common to DB and Apps Tiers Enter the port pool that you want to use on the target system. Make sure to specify the same port pool on the Port pool number:[0-99] DBTier and the AppsTier. If the source and target machines are different, you have the option to preserve the source port values on the target system. [top]

1. What is the port pool? What if I want to give a specific value to a Server Port? Answer: If you are cloning on the same machine or want to redefine the server ports , you will be prompted for a port pool. The port pool provides a way to use a set of predefined server ports.

https://support.oracle.com/CSP/main/article?cmd=show&type=NOT&id=216664.1

1/24/2012

Cloning Oracle Applications Release 11i

Page 5 of 8

There are 100 port pools. For example, if you select 3, the default database port number (1521) becomes 1524. The following table lists all the server ports. To see how the port pool calculation works, enter a number between 0 and 99(both inclusive) in the form and click "Get Ports".

Port Name

Autoconfig Variable

(Custom) Port (Default) Numbers Port allocated for Numbers Port Pool: allocated for 1 Port Pool: 0 Get Ports 8000 1521 1626 7000 8100 8200 8800 9000 9100 9200 9300 9500 9600 9700 9800 10000 10100 10200 10300 15000 8001 1522 1627 7001 8101 8201 8801 9001 9101 9201 9301 9501 9601 9701 9801 10001 10101 10201 10301 15001

Web Listener Port Database Port RPC Port Reports Port OPROC Manager Port Web PLSQL Port Servlet Port Forms Listener Port Metrics Server Data Port Metrics Server Req. Port JTF Fulfillment Server Port iMeeting Collaboration Server Port iMeeting Recording Server Port iMeeting Monitor (iMon) Port Map Viewer Servlet Port OEM Web Utility Port VisiBroker OrbServer Agent Port MSCA Server Port MSCA Dispatcher Port TCF Port OACORE Servle Port Range Discoverer Servlet Port Range Forms Servlet Port Range XMLSVCS Servlet Port Range Forms Start Port Java Object Cache Port

s_webport s_dbport s_rpcport s_repsport s_oprocmgr_port s_webport_pls s_servletport s_formsport s_metdataport s_metreqport s_jtfuf_port s_imtsrvport s_imtrecport s_imtimonport s_mapviewer_port s_oemweb_port s_osagent_port s_mwaPortNo s_mwaDispatcherPort s_tcfport

s_oacore_servlet_portrange 16000-16009 16010-16019 s_disco_servlet_portrange s_forms_servlet_portrange 17000-17009 17010-17019 18000-18009 18010-18019

s_xmlsvcs_servlet_portrange 19000-19009 19010-19019 s_frmStartPort s_java_object_cache_port 20000 12345 20001 12346

If you want to give a specific value to a port on the target system, independently from the port pool, you must first complete the Target System configuration with adcfgclone.pl (temporarily select a value for the port pool). Once adcfgclone.pl completes successfully, edit the new target context file with editcontext or OAM and modify the corresponding Autoconfig variables. Run Autoconfig to refresh the system with the new values (see OracleMetaLink document 165195.1). [top]

1. Does Rapid Clone preserve the patch history? Answer: Yes, Rapid Clone preserves the patch history of the complete Applications Stack: [top] RDBMS ORACLE_HOME: preserve the OUI oraInventory. iAS ORACLE_HOME: preserve the OUI oraInventory. 806 ORACLE_HOME: preserve the patch level and ORCA inventory. APPL_TOP and Database: preserve the patch level and history tables.

1. Can I clone a clone? Answer: Yes, a cloned system created with Rapid Clone can then be used as the Source System in the next cloning. RapidInstall itself is now a clone of a clone using the Rapid Clone technology. [top]

1. Can I change the database dbf files layout while cloning? Answer: Yes, Rapid Clone allows to add or remove database mount points or redidtribute dbf files among mount points in the target system. As long as all the source system dbf files are present in the target system database mount points specified during the adcfgclone prompts (see question "How does adcfgclone.pl know the target system values?"), Rapid Clone will find them and recreate the database control file accordingly. [top]

https://support.oracle.com/CSP/main/article?cmd=show&type=NOT&id=216664.1

1/24/2012

Cloning Oracle Applications Release 11i

Page 6 of 8

1. What is the oraInventory? Answer: The oraInventory is the location for the OUI (Oracle Universal Installer)'s bookkeeping. The inventory stores information about: All Oracle software products installed in all ORACLE_HOMES on a machine Other non-Oracle products, such as the Java Runtime Environment (JRE) In a 11i Application system the RDBMS and iAS ORACLE_HOMEs are registered in the oraInventory. The 806 ORACLE_HOME, which is not managed through OUI, is not. On Unix/Linux, the location of the oraInventory is defined by the content of oraInst.loc, at: - /var/opt/oracle/oraInst.loc on Solaris, HP-UX and Tru64 - /etc/oraInst.loc on Linux and AIX On Windows, the location of the oraInventory is defined by the value of the registry key HKEY_LOCAL_MACHINE|Software\Oracle\INST_LOC or if this value is not defined, at C:\Program Files\Oracle\Inventory [top]

1. What is a binary oraInventory? Is my Inventory binary? Answer: Before OUI 2.X, the oraInventory was binary. A binary oraInventory centralizes, in a binary format, the location of every Oracle products on the machine and the detail of their patch level. The oraInventory location is defined by the content of oraInst.loc. You will have a binary inventory only if ALL of the following conditions are met: you are on 11.5.7 or earlier (11.5.8+ install XML inventory out of the box) you have never installed OUI 2.X or higher (Install converts the inventory to XML) you have never run Rapid Clone (Rapid Clone converts the inventory to XML) If the following file exists, the oraInventory is NOT binary: <oraInventory location as pointed by oraInst.loc>/ContentsXML/inventory.xml [top]

1. What is a XML oraInventory? Is my Inventory XML? Answer: Starting with OUI 2.X and 11.5.8, the information in the inventory is stored in Extensible Markup Language (XML) format. The XML format allows for easier diagnosis of problems and faster loading of data Rapid Clone requires the inventory to be in XML format in order to clone it, and will take care of performing the binary to XML convertion if necessary. Unlike the binary oraInventory, The XML inventory is divided into 2 distinct components: The Global inventory (or Central inventory) The Local inventory (or Home inventory) More information about these components is available under other questions in this FAQ The inventory is XML if the following file exists: $ORACLE_HOME/inventory/ContentXML/comps.xml [top]

1. What is the Global (or Central) Inventory? Answer: The Global Inventory is the part of the XML inventory that contains the high level list of all oracle products installed on a machine. There should therefore be only one per machine. Its location is defined by the content of oraInst.loc. The Global Inventory records the physical location of Oracle products installed on the machine, such as ORACLE_HOMES (RDBMS and IAS) or JRE. It does not have any information about the detail of patches applied to each ORACLE_HOMEs. The Global Inventory gets updated every time you install or de-install an ORACLE_HOME on the machine, be it through OUI Installer, Rapid Install, or Rapid Clone. Note: If you need to delete an ORACLE_HOME, you should always do it through the OUI deinstaller in order to keep the Global Inventory synchronized. [top]

1. What is the Local (or Home) Inventory? Answer: There is one Local Inventory per ORACLE_HOME. It is physically located inside the ORACLE_HOME at $ORACLE_HOME/inventory and contains the detail of the patch level for that ORACLE_HOME. The Local Inventory gets updated whenever a patch is applied to the ORACLE_HOME, using OUI. [top]

https://support.oracle.com/CSP/main/article?cmd=show&type=NOT&id=216664.1

1/24/2012

Cloning Oracle Applications Release 11i

Page 7 of 8

1. How does Rapid Clone deal with the oraInventory? Answer: Rapid Clone requires OUI 2.2 to be installed in the ORACLE_HOME as a prerequisite and will performs all the actions necessary to clone the inventory: Converts the Global inventory to xml format when it was binary on either the source system or the target system Registers the cloned ORACLE_HOME in the target system Global Inventory Updates the Local Inventory of the target ORACLE_HOME to reflect the new machine, paths, users, etc. [top]

1. Why don't I need to manually copy the oraInventory when cloning? Answer: The local inventory is automatically copied from the source system to the target system as part of copying the ORACLE_HOME itself. The Global Inventory is machine specifc and therefore should not be copied. If you are cloning from one machine to a different machine, Rapid Clone will simply register the target ORACLE_HOME in the target machine Global Inventory (This action will automatically create the Global Inventory if it did not exist on that machine). [top]

1. What does OUISetup.pl do? Answer: OUISetup.pl is shipped with the OUI patch, listed as a prerequisit to Rapid Clone (see Metalink Node 230672.1). It should be run as part of the OUI patch installation and will perform the following tasks: Register the OUI program in the Global Inventory Register the JRE in the Global Inventory Ensure that the ORACLE_HOME in which the patch is install is properly registered in the Global Inventory. In doing so, it will attempt to automatically fix Inventory corruptions that are known to cause problem whilie cloning, such as - Home indexes out of sync between the Global and Local Inventory - Duplicate Home Names entries - Duplicate Home Path entries [top]

Change Log Date June 15, 2005 Dec 16, 2004 Description Added RAC prompts to Q20 Added dbf layout Q24 Removed duplicated Q23, now covered by the inventory section Sync'ed up patch versions with Rapid Clone doc 230672.1 Added topics and re-ordered questions in them Modified wording in Q9 and Q10 Added Q25 to Q32 about Rapid Clone and the inventory Added Note about 32bit to 64bit cloning in Q13.

Dec 03, 2004

Sept 30, 2004 May 14, 2004 August 26, 2003 July 18, 2003 June 30, 2003 June 20, 2003

Added Q13 for Platform migration. Updated Q18 and Q19 for Merge APPL_TOP. Added custom Port Pool calculation feature. Clarified non-support for cloning from a higher version of a platform to a lower version. Updated binary compatible operating systems list Added Q19, Q20, Q21, Q22, Q23, Q24 FAQ Re-write

Note 216664.1 by Oracle Applications Development Copyright 2003 Oracle Corporation Last updated: June 15, 2005

Related

Products Oracle E-Business Suite > Applications Technology > Lifecycle Management > Oracle Applications Manager Keywords ADCFGCLONE.PL; ADPRECLONE.PL; APPL_TOP; AUTOCONFIG; CLONE; CLUSTER; CONTEXT; DATABASE TIER; FREQUENTLY ASKED QUESTIONS; HOSTNAME; MIDDLE TIER;

Back to top

https://support.oracle.com/CSP/main/article?cmd=show&type=NOT&id=216664.1

1/24/2012

Cloning Oracle Applications Release 11i

Page 8 of 8

Copyright (c) 2007, 2010, Oracle. All rights reserved. Legal Notices and Terms of Use | Privacy Statement

https://support.oracle.com/CSP/main/article?cmd=show&type=NOT&id=216664.1

1/24/2012