letting go: a dba's guide to autoconfig and rapid clone

July 18, 2004

Letting Go: A DBA's Guide to Letting Go: A DBA's Guide to AutoConfig and Rapid CloneAutoConfig and Rapid Clone

Mark Morgan

siMMian systems, inc.

415-585-4242

morgan@simmian.com

July 18, 2004 Mark Morgan siMMian systems, inc.

AutoConfig and Rapid CloneAutoConfig and Rapid Clone

• Overview• Implementation and Operation• Troubleshooting, Tips, and Tricks

July 18, 2004 Mark Morgan siMMian systems, inc.

AutoConfig OverviewAutoConfig Overview

• 10.7 --> 2 config files• APPSORA.env• FNDENV

• 11.5.9 --> 100? config files• Database• DB Networking• Apache• Framework (jsp, AOL.J,pls,servlets, TCF)• Applications environment• Discoverer server• Portal

July 18, 2004 Mark Morgan siMMian systems, inc.

AutoConfig OverviewAutoConfig Overview

• Context file (XML)• Template files• File drivers

• lists of template files

• AD scripts• shell scripts, perl, SQL, java

July 18, 2004 Mark Morgan siMMian systems, inc.

AutoConfig ImplementationAutoConfig Implementation

• Doc 165195.1• Oracle Applications Maintenance

Procedures

July 18, 2004 Mark Morgan siMMian systems, inc.

AutoConfig ImplementationAutoConfig Implementation

• Patch Current• ADX E• TXK H• AD F+• 2873456 (Context Editor)• 2674529 (Apache pre 11.5.8)• OAM G (optional)• zip 2.3• JDK 1.3.1

July 18, 2004 Mark Morgan siMMian systems, inc.

Migrate to AutoConfigMigrate to AutoConfig

• Will need to migrate if• pre 11.5.7 installation• applied templates patch

July 18, 2004 Mark Morgan siMMian systems, inc.

Migrate to AutoConfigMigrate to AutoConfig

• Apps Tier• adbldxml.sh• adconfig.sh

• DB Tier• admkappsutil.sh• adbldxml.sh• adconfig.sh

• Always check logs after running scripts!

July 18, 2004 Mark Morgan siMMian systems, inc.

Maintaining AutoConfigMaintaining AutoConfig

• Apps Tier:• $COMMON_TOP/admin/scripts/<CONTEXT>/adautocfg.sh

• DB Tier:• $ORACLE_HOME/appsutil/scripts/<CONTEXT>/adautocfg.sh

July 18, 2004 Mark Morgan siMMian systems, inc.

Context FileContext File

• $APPL_TOP/admin/$SID/<CONTEXT>.xml

• 3 Ways to Change Configuration:• editcontext• OAM• vi

July 18, 2004 Mark Morgan siMMian systems, inc.

Context FileContext File

• XML

<web_port_pls oa_var="s_webport_pls" oa_type="PORT">8202</web_port_pls>

<url_protocol oa_var="s_url_protocol">http</url_protocol>

<local_url_protocol oa_var="s_local_url_protocol">http</local_url_protocol>

<oprocmgr_port oa_var="s_oprocmgr_port" oa_type="PORT">8102</oprocmgr_port>

July 18, 2004 Mark Morgan siMMian systems, inc.

Restoring an AutoConfig Restoring an AutoConfig ConfigurationConfiguration

• OAM

• restore.sh• $APPL_TOP/admin/<CONTEXT>/out/MMDDhhmm• $ORACLE_HOME/appsutil/out/<CONTEXT>/MMDDhhmm

July 18, 2004 Mark Morgan siMMian systems, inc.

Customizing ConfigurationsCustomizing Configurations

• Apps Tier:

# Begin customizations

...

# End customizations

• $APPL_TOP/custom<CONTEXT>.env• Doc 236618.1 Personalizing OA Framework• .profile

July 18, 2004 Mark Morgan siMMian systems, inc.

Customizing ConfigurationsCustomizing Configurations

• DB Tier:• tnsname.ora --> ifile• init.ora --> ifile

July 18, 2004 Mark Morgan siMMian systems, inc.

AutoConfig AutoConfig Troubleshooting, TipsTroubleshooting, Tips

and Tricksand Tricks• oprocmgr_prt• s_webport_pls• s_conctimeout• s_discostatus• JDK 131 setups• TCF Port

• CLASSPATH• AF_CLASSPATH• LD_LIBRARY_PATH• Followsymlinks• DISPLAY

July 18, 2004 Mark Morgan siMMian systems, inc.

AutoConfig AutoConfig Troubleshooting, TipsTroubleshooting, Tips

and Tricksand Tricks• Keep accessible backups of context file• Don't break out of adautocfg.sh• Use aoljtest.jsp to test configs• Updates some profile options• init.ora db_cache_size does not work (as of ADX D)• Use adautocg.sh to change apps password after

running FNDCPASS• Keep copies of db configs (init.ora, listener.ora,

tnsnames.ora)

July 18, 2004 Mark Morgan siMMian systems, inc.

Rapid Clone OverviewRapid Clone Overview

• Builds DB init.ora• Builds DB controlfiles• Creates DB networking config files• Creates all Apps config files for

AutoConfig• Updates Apps profile values• Updates/builds oraInventory

July 18, 2004 Mark Morgan siMMian systems, inc.

Rapid Clone ImplementationRapid Clone Implementation

• Doc 230672.1• Oracle Applications Maintenance

Procedures

July 18, 2004 Mark Morgan siMMian systems, inc.

Rapid Clone ImplementationRapid Clone Implementation

• Patch Current• ADX• OUI• Current AutoConfig patches

July 18, 2004 Mark Morgan siMMian systems, inc.

Running Rapid Clone -- Running Rapid Clone -- preclonepreclone

• Copies current configurations to templates• DB Tier:

• perl adpreclone.pl dbTier

• outputs to $ORACLE_HOME/appsutil//clone

• Apps Tier:• perl adpreclone.pl appsTier

• outputs to $COMMON_TOP/clone

July 18, 2004 Mark Morgan siMMian systems, inc.

Running Rapid Clone -- Running Rapid Clone -- copy filescopy files

• Apps Tier:• APPL_TOP• OA_HTML• OA_JAVA• COMMON_TOP/util• COMMON_TOP/clone• 806 ORACLE_HOME• iAS ORACLE_HOME

July 18, 2004 Mark Morgan siMMian systems, inc.

Running Rapid Clone -- Running Rapid Clone -- copy filescopy files

• DB tier:• Cold copy of database files*• ORACLE_HOME (9i/8i)

July 18, 2004 Mark Morgan siMMian systems, inc.

Running Rapid Clone -- Running Rapid Clone -- postclonepostclone

• DB Tier:• perl ./adcfgclone.pl dbTier

• control files• init.ora• tnsnames.ora• listener.ora• starts database and listener

July 18, 2004 Mark Morgan siMMian systems, inc.

Running Rapid Clone -- Running Rapid Clone -- postclonepostclone

• Apps Tier:• perl ./adcfgclone.pl appsTier

• applications configurations• profile values• starts all services

July 18, 2004 Mark Morgan siMMian systems, inc.

Running Rapid Clone -- Running Rapid Clone -- finishingfinishing

• Verify profile options• Verify printers• Update workflow• Verify APPLCSF• Change passwords• Update login user responsibilities

July 18, 2004 Mark Morgan siMMian systems, inc.

Rapid Clone -- optionsRapid Clone -- options

• ADX E allows all node cloning options

• multi --> single• multi --> multi• single --> multi

July 18, 2004 Mark Morgan siMMian systems, inc.

Rapid Clone Rapid Clone TroubleshootingTroubleshooting

• Always check postclone logfiles for 'ERRORCODE = 1'

• errors cause rollbacks• Verify utl_file entries in init.ora• Verify profile values• Verify dbc files• Verify GLOBAL_NAME

July 18, 2004 Mark Morgan siMMian systems, inc.

Rapid Clone Rapid Clone TroubleshootingTroubleshooting

• Verify data:• FND_NODES• FND_APPLICATION_SERVERS (desupporting)• AD_APPL_TOPS

• Verify context file entries for:• CLASSPATH• AF_CLASSPATH• LD_LIBRARY_PATH• hostname• DISPLAY

July 18, 2004 Mark Morgan siMMian systems, inc.

Rapid Clone Tips and TricksRapid Clone Tips and Tricks

• Set ORACLE_HOME/JRE to relative path

• If selectively refreshing environment, make sure to copy• $COMMON_TOP/clone• $ORACLE_HOME/appsutil/clone

• Before running postclone, verify /var/opt/oracle/oraInst.loc on target machine

July 18, 2004 Mark Morgan siMMian systems, inc.

Rapid Clone Tips and TricksRapid Clone Tips and Tricks

• Create script to display paths that will be entered in postclone

• APPL_TOP• COMMON_TOP• 806 ORACLE_HOME• iAS_HOME

July 18, 2004 Mark Morgan siMMian systems, inc.

Rapid Clone Tips and TricksRapid Clone Tips and Tricks

• To use online backup, follow Appendix A steps to manually create controlfiles

• After cloning, re-login to reset environment

• Truncate FND_CONCURRENT_REQUESTS before Apps Tier postclone

• Truncate WF_NOTIFICATIONS

July 18, 2004 Mark Morgan siMMian systems, inc.

Rapid Clone Tips and TricksRapid Clone Tips and Tricks

• Modify adcfgclone.pl to verify new context file:#print "\nsleeping for 10 minutes to allow fixes of context

file...\n";sleep 600;### run adclone#print "\nRunning Rapid Clone with command:\n";my $syscmd="perl $ADCLONE java=$JAVA_TOP mode=apply

stage=$STAGE_DIR component=$COMPONENT method=CUSTOM $CTX_ARG $MERGE_APPL showProgress ";if ($Config{osname} ne 'MSWin32') { $syscmd =~ s#\\#\/#g;}

July 18, 2004 Mark Morgan siMMian systems, inc.

Rapid Clone Tips and TricksRapid Clone Tips and Tricks

• Rather than add new record in WF_SYSTEMS:UPDATE wf_systems

SET name =

(SELECT global_name FROM global_name),

display_name =

(SELECT global_name FROM global_name);

July 18, 2004 Mark Morgan siMMian systems, inc.

Rapid Clone Tips and TricksRapid Clone Tips and Tricks

• To update WF_AGENTS

DECLAREv_gname global_name.global_name%TYPE;v_old_gname global_name.global_name%TYPE := '&1';

BEGINSELECT global_name INTO v_gname FROM global_name;UPDATE wf_agentsSET address =substr(address,1,instr(address,'@'))||v_gnameWHERE address LIKE '%@'||v_old_gname;

END;/

July 18, 2004 Mark Morgan siMMian systems, inc.

By letting it go it all gets done. The world is won by those who let it go. But when you try and try. The world is beyond the winning.

-- Lao Tzu