apps cloning

APPS

CLO

NIN

G

<Customer Name>

<Project Name>

Apps Cloning

Version 1.00 of 3 July 2007

Status: Draft

Company Name

/17

Apps CloningCustomer XYZ 03/07/2007

Document history:

Version Date Update origin Written by Verified by

/17


Summary:

1. INTRODUCTION 4

2. PREREQUISITES 4

3. COPY SOURCE SYSTEM TO TARGET 6

4. CONFIGURE TARGET SYSTEM 7

4.1. Configure the target system database server 7

4.2. Configure the target system application tier server. 7

5. POST CLONING ACTIVITY 9

6. POST CLONING ACTIVITY FOR EMPTY INSTANCE 13

7. referenceS 15

/17


1. INTRODUCTION

This document is to provide instruction for Oracle eBusiness suite cloning for <XYZ project>, which can be followed to refresh existing environment or to create new environment from clean instance.

Creating a clean eBusiness Suite instance using rapid install is very complex and time consuming process. Once we have one clean instance ready for our project, we can create another environment from that clean instance using this cloning document.

For this project, we have hardware technology difference in existing Development, Systest environment and UAT, Production environment. In Production we have separate Apps tier server and database is in RAC with data guard. In spite of this, we first need to build a non-RAC instance using this document and than convert it into RAC using APPLTOP production build document.

2. PREREQUISITES

Note: These prerequisites are based on Metalink Note 230672.1; please refer it for any new prerequisites.

Make sure target & source node has following software & utilities properly installed.

a) Oracle Universal Installer 2.2.0.19 b) Perl 5.005

c) JRE 1.1.8 d) JDK 1.3.1

e) Zip 2.3 f) OS utilities - make, ld, cc, ar

g) gcc version 3.2.3 (compat-oracle-rhel4-1.0-5 must be installed on Application tier)

Make sure target node has proper file system (one for Code & one for data files) with sufficient disk space. UAT environment was created from ebsdba1 backup from maree: /ora/u01/Stage11i/spl_backup/EBSDBA1/1110_do_not_delete, which needs following disk space, at time of installation.

APPL_TOP: /export/home/app/oracle/casu/casuappl (aprx. 20GB)

COMMON_TOP: /export/home/app/oracle/casu/casucomn (aprx. 6 GB)

8i Oracle Home: /export/home/app/oracle/casu/casuora/8.0.6 (aprx. 3 GB)

/17


iAS Home: /export/home/app/oracle/casu/casuora/iAS (aprx. 4 GB)

10g Oracle Home: /export/home/app/oracle/product/10.2.0ebs (aprx. 3 GB)

DATA_TOP: /export/home1/app/oradata/casu (aprx. 30 GB)

Note: Directories for 10g Oracle Home and Data_top are on database server cadbbe1, owned by dbuser “oracle” and rest of others are on application tier server appltop and owned by appsuser “oracle”.

Apply latest AutoConfig Template Patch, if it is not yet applied in source environment. We have already applied patch 5107107 - TXK (FND & ADX) AUTOCONFIG ROLLUP PATCH N (AUGUST 2006).

Apply other pre-req patch as per Note 230672.1. Currently they are 3453499 and 5225940, which are already applied in our environment.

Create cloning templates on source environment database tier

o cd $ORACLE_HOME/appsutil/scripts/<CONTEXT_NAME>

o perl adpreclone.pl dbTier

Create cloning templates on source environment apps tier

o cd $COMMON_TOP/admin/scripts/<CONTEXT_NAME>

o perl adpreclone.pl appsTier

Make sure in the target node, apps and db owner has write access to inventory location, otherwise adcfgclone.pl script will fail. Please run following command:

o chmod -R a+rw /etc/oraInventory

o chmod a+rw /etc/oratab

If your target system do not have graphic adapter, than make sure virtual X server process is running all the time. In our environment XVFB is configured, which can start using script /export/home/app/oracle/scripts/xvfb/runxvfb.ksh as root

o export DISPLAY=<server hostname>:1.0

o Xvfb :1 -screen 0 6x6x8 -pn -fp /usr/X11R6/lib/X11/fonts/misc -sp /export/home/app/oracle/scripts/xvfb/secpol.txt 2>&1 >/tmp/xvfb.log &

/17


Please save existing environment files (including custom, if any), database & appltop context file, ifile from dbs and network directory, oraInst.loc, defaults.txt, pwd etc.

Note down any custom top entry in topfile.txt and in application context file

o $APPL_TOP/admin/topfile.txt:

xxcf /ora/u06/ebsdev1/ebsdev1appl.

o application context file: $APPL_TOP/admin/${TWO_TASK}_hostname.xml

<XXCF_TOP oa_var="s_xxcftop" oa_type="PROD_TOP"

oa_enabled="FALSE">/ora/u06/ebsdev1/ebsdev1appl/xxcf/11.5.0</X

XCF_TOP>

Note down values for following parameter in application context file, if Forms Listener Servlet if enabled.

s_forms_servlet_serverurl, s_forms_servlet_comment, s_leastloadedhost

Note down existing apps user, if we need to recreate them and it is not available in source system.

o select a.USER_NAME, a.DESCRIPTION, c.RESPONSIBILITY_NAME from fnd_user a, fnd_user_resp_groups b, fnd_responsibility_tl c where a.USER_ID=b.USER_ID and b.RESPONSIBILITY_ID=c.RESPONSIBILITY_ID and a.END_DATE is null and a.USER_NAME not in ('GUEST','APPSMGR','SYSADMIN','AUTOINSTALL') order by USER_NAME;

Note down existing database user, if we need to recreate them and it is not available in source system.

3. COPY SOURCE SYSTEM TO TARGET

Log on to the source system & shutdown the source application along with database.

Disable source system’s cronjobs if they are going to run during code tree & datafile copy.

Disable target system’s cronjobs if they are going to run during this cloning.

/17


Copy APPL_TOP, COMMON_TOP, 8i Oracle Home, iAS Oracle Home from source apps tier to target apps tier and 10g Oracle Home and datafiles from source db tier to target db tier.

o cd /ora/u16/ebststc/ebststcdb/10.2.0

o ssh oraebsdba1@tilt 'cd /ora/u01/ebsdba1/ebsdba1db/10.2.0/; tar cf - * |gzip -c' | gunzip -c | tar xvf -

o Note: We can copy code tree when source application is up & running, but it is recommended to have application down while copying code tree. If you can’t shutdown source database, than you need to copy datafiles of source environment from latest backup.

Make sure softlink 6iserver in iAS home and jdk in Apache home points to correct location after copying code tree as below.

o 6iserver -> /export/home/app/oracle/casu/casuora/8.0.6

o jdk -> /export/home/app/oracle/casu/casucomn/util/java/1.4/j2sdk1.4.2_04

Start source database & application..

Enable source system’s cronjobs if you have disabled them during code tree & datafile copy.

Note: UAT environment was created from EBSDBA1 backup located under folder maree:/ora/u01/Stage11i/spl_backup/EBSDBA1/1110_do_not_delete. Take a help from Unix admin to restore it at appropriate location on target host.

4. CONFIGURE TARGET SYSTEM

4.1. Configure the target system database server

Log on to the target db tier as the db user, for UAT it is oracle, and set proper database environment.

Verify location for oraInventory from $ORACLE_HOME/oraInst.loc, modify if necessary. Also compare it with /etc/oraInst.loc. For UAT it is /export/home/app/oracle/oraInventory.

Run one of the following command (based on creating new environment or refreshing existing environment) to configure and start the database:

/17


a) If you are creating new environment,

o cd <RDBMS ORACLE_HOME>/appsutil/clone/bin

o perl adcfgclone.pl dbTier

Note: You will be prompted for APPS password, virtual hostname, database name, RDBMS ORACLE_HOME, utl_file_dir, DATA_TOP, Display variable, port pool etc. For UAT environment:

RDBMS ORACLE_HOME=/export/home/app/oracle/product/10.2.0ebs

utl_file dir = /usr/tmp/casu

DATA_TOP 1=/export/home1/app/oradata/casu

port pool number = 0

b) If you are refreshing existing environment,

o cd <RDBMS ORACLE_HOME>/appsutil/clone/bin

o perl adcfgclone.pl dbTier < target Database context file>

4.2. Configure the target system application tier server.

Log on to the target apps tier as apps owner. For UAT it is oracle

To avoid issue reported in Note: 391295.1, replace all environment files from backup (if you are refreshing) or modified all existing environment files manually (if you are creating new environment) and set apps environment variable properly.

To avoid issue reported in Note: 390901.1, if available, apply patch 5473858 (11i.ATG_PF.H.RUP5) OR modify context file and set port to any free range as below in apps context file.

o <fndcache_port_range oa_var="s_fnd_cache_port_range" oa_type="PORT">10448-10449</fndcache_port_range>

Run one of the following command (based on creating new environment or refreshing existing environment) to configure and start the application.

a) If you are creating new environment,

o cd <COMMON_TOP>/clone/bin

o perl adcfgclone.pl appsTier

/17


Note: You will be prompted for source APPS password, virtual hostname, database SID, database server node, database domain name, APPL_TOP, COMMON_TOP, 8.0.6 ORACLE_HOME, iAS ORACLE_HOME, Display variable, port pool, UTL_FILE_DIR etc. For UAT environment:

o APPS password [APPS]=APPS

o database SID= casu

o database server node= cadbbe1

o database domain name = <Domain Name>

o Display = <Hostname>.<Domain Name>:1.0

o APPL_TOP= /export/home/app/oracle/casu/casuappl

o COMMON_TOP= /export/home/app/oracle/casu/casucomn

o 8.0.6 ORACLE_HOME= /export/home/app/oracle/casu/casuora/8.0.6

o iAS ORACLE_HOME= /export/home/app/oracle/casu/casuora/iAS

o port pool number =0

b) If you are refreshing existing environment,

o cd <COMMON_TOP>/clone/bin

o perl adcfgclone.pl appsTier <target Appltop context file>

If you have cloned from different host, you may have incorrect values in FND_NODES table. Run below query, if you have multiple node name with value ‘O’ in node mode, than you need to cleanup FND_NODE table (with command: EXEC FND_CONC_CLONE.SETUP_CLEAN; ) as mentioned in note 260887.1.

SQL> select node_name, node_mode, support_cp, support_web, support_admin, support_forms from FND_NODES;

NODE_NAME N S S S S

------------------------------ - - - - -

TARGET O Y Y Y Y

SOURCE O Y Y Y Y

/17


5. POST CLONING ACTIVITY

Set tcp.validnode_checking to yes and update tcp.invited_nodes in sqlnet.ora with valid list of hosts or set tcp.validnode_checking to no.

Convert database in Archive log mode, if required. (For UAT, Production database)

For UAT/Production database, convert datafile in format $ORACLE_SID_xxx_01.dbf, where xxx is tablespace name.

Change system, sys and other db user password on Target system. Please use script /export/home/app/oracle/scripts/pwd/db_pwd.sql

Change Apps password on Target system. Please use script /export/home/app/oracle/scripts/pwd/apps_pwd.sh. You will be prompted to update $IAS_ORACLE_HOME/Apache/modplsql/wdbsvr.app, $APPL_TOP/admin/$TWO_TASK/default.txt, $ORACLE_HOME/reports60/server/CGIcmd.dat files and to recreate apps db links.

o drop database link APPS_TO_APPS.<DOMAIN NAME>;

o create database link APPS_TO_APPS.<DOMAIN NAME> connect to APPS identified by <appspass> using '<TNSNAME>' ;

Change other Application user password. Please use script /export/home/app/oracle/scripts/pwd/other_pwd.sh. You will be prompted to expire all unused seeded application user. Do not expire guest and sysadmin user. In our environment, we need to expire AME_INVALID_APPROVER, APPSMGR, ASGADM, ASGUEST, IBEGUEST, IBE_ADMIN, IBE_GUEST, IEXADMIN, IRC_EMP_GUEST, IRC_EXT_GUEST, MOBADM, MOBDEV, MOBILEADM, OP_CUST_CARE_ADMIN, OP_SYSADMIN, PORTAL30, PORTAL30_SSO, WIZARD, XML_USER

Update site profile “Site Name” to appropriate value. For UAT it is set to “CASU”.

Make sure APPLPTMP variable is set to /usr/tmp/$ORACLE_SID. If not, than update environment file and context file.

Modify all existing directories with correct path. Make sure directory exist at OS level.

/17


o CREATE OR REPLACE DIRECTORY WORK_DIR AS

'/export/home/app/oracle/product/10.2.0ebs/work';

o CREATE OR REPLACE DIRECTORY DATA_PUMP_DIR AS

'/export/home/app/oracle/product/10.2.0ebs/admin/casu_cadbbe1/dpdum

p';

Make sure we have following custom directories at OS level and database level.

o XXCF_INBOUND_DLCMS= /export/home/app/oracle/casu/inbound/DLCMS (Read, write grant to apps)

o XXCF_INBOUND_DLBRM=/export/home/app/oracle/casu/inbound/DLBRM (Read, write grant to apps)

o XXCF_INBOUND_DLGROS=/export/home/app/oracle/casu/inbound/DLGROS (Read, write grant to apps)

o XXCF_INBOUND_DLDNAG=/export/home/app/oracle/casu/inbound/DLDNAG (Read, write grant to apps)

o XXCF_INBOUND_IDI=/export/home/app/oracle/casu/inbound/IDI (Read, write grant to apps)

o XXCF_INBOUND_IGI=/export/home/app/oracle/casu/inbound/IGI (Read, write grant to apps)

o XXCF_INBOUND_ICI=/export/home/app/oracle/casu/inbound/ICI (Read, write grant to apps)

o APPS_OCO_LOG_FILES=/export/home/app/oracle/casu/casucomn/admin/log/casu_appltop (Read grant to apps)

o Create corresponding OUTBOUND directories i.e. XXCF_OUTBOUND_ICI =/export/home/app/oracle/casu/outbound/ICI (Read, write grant to apps)

o Note: for development environment, all above directories are under /ora/inbound/$ORACLE_SID and /ora/outbound/$ORACLE_SID.

Bounce Target Application.

Verify already scheduled jobs in the system with below script & make sure we have “Gather Schema Statistics” and “Purge Concurrent Request and/or Manager Data” are scheduled to run periodically.

/17


o select USER_NAME, REQUEST_ID, PARENT_REQUEST_ID, PHASE_CODE, STATUS_CODE, REQUESTED_START_DATE, USER_CONCURRENT_PROGRAM_NAME from fnd_concurrent_requests cr, FND_CONCURRENT_PROGRAMS_TL cpt, fnd_user fu where cr.CONCURRENT_PROGRAM_ID = cpt.CONCURRENT_PROGRAM_ID and cr.PHASE_CODE='P' and cr.REQUESTED_BY=fu.USER_ID;

If you can’t find above jobs then you can submit with following parameters as sysadmin.

a) Gather Schema Statistics: All:20:2:NoBACKUP::LASTRUN:GATHER::Y

b) Purge Concurrent Request and/or Manager Data : All, age, 30,,,,,Yes, Yes

Compile any invalid objects using

a) adadmin Compile/Reload Applications Database Entities menu Compile APPS schema

b) If you have any non-apps invalid objects then use utlrp.sql

Apply any missing Apps or Database patch with respect to Patching History document, which is located under “P:\Scottish Executive\Improvement Service\D7000 - Citizen's Account\Environment” folder. UAT environment was created from EBSDBA1’s backup, which includes all patches up to 10-Nov-2006. We need to apply all patches after this date.

Review following Workflow tables and make sure there is no source instance specific data in it, if there is any data, please update as suggested below. During UAT setup, we did not updated any table, as there were no source data.

Table Name Column Name Column Value DetailWF_NOTIFICATION_ATTRIBUTES

TEXT_VALUE Value starts with http://<old web host> : Update to new web host

WF_ITEM_ATTRIBUTE_VALUES

TEXT_VALUE Value starts with http://<old web host> : Update to new web host

WF_SYSTEMS GUID Create a new system defined as the new global database name using the Workflow Administrator Web Applications responsibility

/17


WF_SYSTEMS NAME Value needs to be replaced with the database global name

WF_AGENTS ADDRESS Update database link with the new database global name.

FND_FORM_FUNCTIONS WEB_HOST_NAME

Update with the new web host name

FND_FORM_FUNCTIONS WEB_AGENT_NAME

Update to point at the new PLSQL listener name

FND_CONCURRENT_REQUESTS

LOGFILE_NAME Update with the correct path to the logfile directory

FND_CONCURRENT_REQUESTS

OUTFILE_NAME Update with the new directory path on the target system

For UAT/Production environment, implement Forms Listener Servlet using Note 201340.1.

o Our setup met all pre-requisites. Enable this feature as per step 4 of this note.

o Run Autoconfig (using script $COMMON_TOP/admin/scripts/$CONTEXT_NAME/adautocfg.sh)

o Make sure profile “Viewer: Text” set to browser.

For UAT/Production environment, implement network encryption using Note 391248.1

o Apply 3584486 & 5050081 on 806 home

o Modify sqlnet.ora under 806_HOME, iAS HOME and Database HOME; make sure that all the files have the following entries defined.

SQLNET.ENCRYPTION_TYPES_SERVER= (RC4_40)

SQLNET.ENCRYPTION_TYPES_CLIENT= (RC4_40)

SQLNET.ENCRYPTION_SERVER = REQUIRED

SQLNET.ENCRYPTION_CLIENT = ACCEPTED

SQLNET.CRYPTO_SEED = ‘hdfg877y234jhbsdfiuyh38234uewr'

o Make sure Database context file has correct value of TNS_ADMIN

/17


o Update env_forms60.mk, env_reports60.mk and jserv.properties as suggested in note.

o Autoconfig process will overwrite sqlnet.ora and jserv.properties, so we need to take a backup before autoconfig and restore encryption parameter in new file.

o Relink application as suggested in note.

Recreate application and db user if there is any difference in source and target environment.

eBusiness Suite keeps environment specific files under <ORACLE_SID>_<host name> or <ORACLE_SID> format directory. In target server, find and delete all directory which named <source ORACLE_SID>_<source host name> or <source ORACLE_SID> as shown below. For UAT find and delete from cadbbe1 :/export/home/app/oracle/product/10.2.0ebs and /export/home/app/oracle/casu from appltop.

find . –name EBSDBA1_tilt

find . –name EBSDBA1

find . -name "*ebsdba1*" -exec rm -rf {} \;

find . -name "*EBSDBA1*" -exec rm -rf {} \;

– Please verify the output of above find command and delete directories and files, which are not needed.

Make sure environment has proper startup, shutdown and backup scripts. We have scripts in /export/home/app/oracle/scripts.

Run RMAN backup policy script /ora/u01/scripts/bpol.sh – For UAT, please refer TSG Backup documents.

Take full environment backup. - For UAT, please refer TSG Backup documents.

Enable target system’s cronjobs if you have disabled them during configuration. For new environment schedule cronjob to run daily code tree & database backup. Below is the example of backup on appltop. for UAT database backup, please refer TSG Backup documents.

o #Application Backup

/17


o 00 21 * * 1-5 /export/home/app/oracle/scripts/code_backup.sh casu 2>&1 > /export/home/app/oracle/backup/casu/log/code_backup.log

Update environment, cloning and patching history document as necessary; those documents are located under “P:\Scottish Executive\Improvement Service\D7000 - Citizen's Account\Environment” folder.

Test Application Self Service login, Forms login, OAM login etc.

6. POST CLONING ACTIVITY FOR EMPTY INSTANCE

If environment is created from the Backup of EBSDBA1 dated 10-Nov-06 (located at maree:/ora/u01/Stage11i/spl_backup/EBSDBA1/1110_do_not_delete), than it will be an empty EBS instance. UAT environment CASU was created from this backup. Please handover it to functional consultant for configuration as per BR100 document. When requested by functional consultant, perform following activities.

Multi-Org conversion:

o Make sure MO: Operating Unit profile set to “Customer First”

o Shutdown middle tier

o Run adadmin --> Maintain Applications Database Entities menu --> Convert to Multi-Org.

o Restart database and application

Create custom schema XXCF (Please review grants for Production environment).

o CREATE USER "XXCF" PROFILE "DEFAULT" IDENTIFIED BY <password> DEFAULT TABLESPACE "XXCF_DATA" TEMPORARY TABLESPACE "TEMP" ACCOUNT UNLOCK;

o grant connect, resource, UNLIMITED TABLESPACE to xxcf;

o grant AQ_ADMINISTRATOR_ROLE, create synonym, create database link to xxcf;

o grant ON COMMIT REFRESH, CREATE TABLE, CREATE VIEW, GLOBAL QUERY REWRITE to xxcf;

o grant EXECUTE ON "SYS"."DBMS_AQ" TO "XXCF" ;

o grant EXECUTE ON "SYS"."DBMS_AQADM" TO "XXCF" ;

/17


o grant EXECUTE ON "SYS"."DBMS_AQ_BQVIEW" TO "XXCF" ;

o grant EXECUTE ON "SYS"."DBMS_LOCK" TO "XXCF" ;

Create custom schema XXCF_COREID (Please review grants for Production environment).

o CREATE USER "XXCF_COREID" PROFILE "DEFAULT" IDENTIFIED BY <password> DEFAULT TABLESPACE "XXCF_DATA" TEMPORARY TABLESPACE "TEMP" ACCOUNT UNLOCK ;

o grant connect to XXCF_COREID

o grant CREATE VIEW TO "XXCF_COREID";

o grant select on ar.HZ_PARTIES to XXCF_COREID;

o grant select on ar.HZ_PERSON_PROFILES to XXCF_COREID;

Create custom schema XXHS: (Please review grants for Production environment).

o CREATE USER "XXHS" PROFILE "DEFAULT" IDENTIFIED BY <password> DEFAULT TABLESPACE "XXCF_DATA" TEMPORARY TABLESPACE "TEMP" ACCOUNT UNLOCK;

o grant connect, resource, UNLIMITED TABLESPACE to XXHS;

o grant AQ_ADMINISTRATOR_ROLE, create synonym to xxhs;

o grant ON COMMIT REFRESH, CREATE TABLE, CREATE VIEW, GLOBAL QUERY REWRITE to xxhs;

Extra grants to apps schema: (Please review grants for Production environment).

o grant execute, debug on DBMS_CRYPTO to apps;

o grant DEBUG CONNECT SESSION to apps;

o grant DEBUG ANY PROCEDURE to apps;

Database link to DNAG database:

o Collect information for target DNAG database SID, connect string, database username and password from DNAG administrator and create db link. In UAT, this link is as below:

/17


create database link EBS_TO_DNAG.<DOMAIN NAME> connect to casuser identified by <passwords> using '<TNSNAME>' ;

Init parameters:

o Make sure init parameters are set as per metalink note 216205.1 and as suggested by Oracle Consultant’s Site visit report dated 14-May-2007.

o Create any missing subdirectory under plsql_native_library_dir as suggested by Note 316758.1

Install all requested Releases as per CAS configuration management process.

7. REFERENCES

Oracle Applications Maintenance Procedures, Release 11i (11.5.10), Part No. B13587-01

Metalink Note 230672.1, Cloning Oracle Applications Release 11i with Rapid Clone

Metalink Note 277574.1, Running Configuration Wizards from the Command Line in Oracle Applications 11i

Bug No.: 1725012

Metalink Note 123718.1, 11i: A Guide to Understanding and Implementing SSL for Oracle Applications

Metalink Note 260887.1, Steps to Clean Nonexistent Nodes or IP Addresses from FND_NODES

Metalink Note 201340.1, "Using Forms Listener Servlet with Oracle Applications 11i "

Metalink Note 391248.1, “Encrypting EBS 11i Network Traffic using Advanced Security Option / Advanced Networking Option”

Metalink Note 216205.1, Database Initialization Parameters for Oracle Applications 11i

/17

apps cloning

Documents