Professional Documents
Culture Documents
2012 03 EBS Patching Overview
2012 03 EBS Patching Overview
North America:
1866 230 1938
International (UK):
+44 (0) 1452 562 665 Do you have any requests for future EBS - Technology
Conference ID : 39799161 Webcast Events? Please email your suggestions to
ruediger.ziegler@oracle.com ,subject: Topics of Interest.
• Q&A Session
maximum 15 minutes
3 Send
your question
Q&A panel
1
type your question here
Note:
You can view this info anytime using WebEx menu from your WebEx-Session :
Patching Overview
Patching Options Release 12
Troubleshooting Tips
Patch Wizard
New Patching features in Release 12.2
Q&A
Patching Overview
Patching Options Release 12
Troubleshooting Tips
Patch Wizard
New Patching features in Release 12.2
Q&A
1. Patch driver
The patch driver contains the necessary commands to change files and database objects and generate new objects
For Release 12 the patch driver is called u<Patch mum>.drv (Unified driver)
2. Metadata Files
The metadata files discribed the list of the bugs the patch is fixing and the list of the files provided.
- b<patch num>.ldt
The prerequisite patch checking feature loads the patch metadata .ldt files and
then checks if all prerequisite patches have been applied.
- f<patch num>.ldt
Manifest of all files in the patch with their version number.
Those 2 files are very important as all the OAM patching reporting is based on those informations
Patching Overview
Patching Options Release 12
Troubleshooting Tips
Patch Wizard
New Patching features in Release 12.1
Q&A
To perform an analysis of the effects of applying a patch, always apply it first to a test system.
Before applying the patch, use Patch Wizard perform a Patch Analysis and check the impact of the patch
Clone your Production System in order to have an exact copy of your Production environment :
Use OAM Timing Report to analyze the patch application
From OAM : Site Map > Maintenance > Timing Reports
Sharing The Application Tier File System in Oracle E-Business Suite Release 12 (Doc ID 384248.1
Converting To Shared Application Tier File System (Doc ID 1324602.1)
• Parallel Processing
– Run AutoPatch workers on the primary node and the secondary nodes
– Works only for Shared Application Tier Filesystem
• Time to complete AD tasks reduced
• Better utilization of system resources
For example : to run an AutoPatch session with a total of eight workers (three workers on the local node and five
workers on a remote node) :
Clone 1. Clone
Update 2. Apply Patches In Test
Database 3. Update Prod database
4. Synchronize File System
5. Transfer Patch History
Legend
Uptime
Synchronize
Downtime
files
Using a Staged Applications System (APPL_TOP) to Reduce Patching Downtime in Oracle E-Business Suite Release 12
If your system uses multiple languages, you can use AD Merge Patch to create merged patches in
the following ways:
For option 2 and 3 you can apply the US patches first during downtime.
Then, you can apply the merged NLS translation patches during uptime.
Patching Overview
Patching Options Release 12
Troubleshooting Tips
Patch Wizard
New Patching features in Release 12.2
Q&A
Your hardware configuration consists of your application and/or database machine and operating system. You need this
information to select the appropriate Oracle patch. To learn more about your hardware configuration:
– In the General section of Enterprise Manager home page -> click the link next to Host -> host_name page appears
– This page lists your operating system, hardware platform, IP address, number of CPUs, memory size, and disk space.
– In the Configuration section -> click the links to drill down to pages that describe your operating system, hardware
platform, and disk space.
• Tablespaces: we have seen issues where patch wizard fails because of lack of space in tablespaces. So, before applying
any patch you need to check the space you have in tablespaces.
• Memory - you need to make sure that you have sufficient system memory available to run the patch wizard as it can take
much longer to run with systems that do not have the proper memory available.
adrelink.log Relinking
In addition to the main log file (adpatch.log), AutoPatch also creates other log files for specific purposes, for example, to record all the actions
associated with parallel workers.
The log files are written to $APPL_TOP/admin/<SID>/log (UNIX), where <SID> is the value of your ORACLE_SID or TWO_TASK variable, or
in %APPL_TOP%\admin\<SID>\log (Windows), where <SID> is the value of ORACLE_SID or LOCAL. Review these files when the AutoPatch
session is complete.
The log directory contains adpatch.log and adpatch.lgi, and may contain one or more additional files as described in the above table.
Oracle Patching
Moving the patch software: First of all the database administrator must move the patch software to the server and unzip the
file.
Set up environment: Then the environment must be properly setup to run adpatch.
Shutdown: Shutdown the concurrent managers
Patching: Patch the APPL_TOP. This is often a time consuming and risky task and hence it should not fail. This step is
performed when the database is in ‘Maintenance Mode’ and unavailable for the users. Any problem in this step increases
the database outage and the database administrator must identify the problem and decide if the patch should be rolled back.
The gold copy Oracle home cloning eliminates this step by cloning.
Restarting: Enable the database by ending the ‘Maintenance Mode’ via adadmin
What to do if you
encounter any problem
while applying patches?
Check MOS for additional
Fix the issue and restart information regarding the
AutoPatch using the
adctrl command. patch you are applying and
Note: Some failed jobs are for the error you get.
deferred (not immediately
reassigned) by the manager.
These jobs do not cause the
manager or other workers to
stop.
Note: See “Monitoring and Controlling Parallel Processing”, Oracle E-Business Suite Maintenance Utilities for details on using the adctrl comm and “Managing Worker
Processes, Oracle E-Business Suite Maintenance Procedures.
1. In the most cases, the issue can be resolved and the patching process can be restarted at the point of failure.
Review the log files and the copy portion of the unified driver to
2. If there is no feasible method of determine the files copied by the patch and the update actions
resolving the issue performed.
Based on the actions recorded in the log file, you must decide which
files, if any, need to be relinked, restored, and generated.
Attempt to correct the problem and restart the failed job. AD Controller Menu
--------------------------------------------
1. Show worker status
-> To restart a failed job, run AD Controller and choose 2. Tell worker to restart a failed job
Option 2 to tell the worker to restart a failed job. Enter 3. Tell worker to quit
the worker number when prompted. 4. Tell manager that a worker failed its job
5. Tell manager that a worker acknowledges quit
6. Restart a worker on the current machine
7. Exit
• Check which worker is showing as failed state and then go to that worker log file in AD Controller Menu
--------------------------------------------
same location: $APPL_TOP/admin/$TWO_TASK/log.
1. Show worker status
• You will see log file like adworkXXX.log (ex: adwork001.log, adwork002.log, etc) so 2. Tell worker to restart a failed job
if your worker 01 failed open log file adwork001.log and fix the problem.
3. Tell worker to quit
4. Tell manager that a worker failed its job
5. Tell manager that a worker acknowledges quit
To review a worker status, perform these steps:
6. Restart a worker on the current machine
1. Start AD Controller. Set the environment and enter adctrl on the command line.
7. Exit
2. Review worker status. Select "Show worker status" from the AD Controller main menu.
Enter your choice [1] :
AD Controller displays a summary of current worker activity. The summary columns are:
Worker Status:
• Control Worker is the worker number ----------------------
• Code is the last instruction from the manager to this worker
Worker Code Context Filename Status
• Context is the general action the manager is executing ----------- --------- ---------------------------- ----------------- -------------
• Filename is the file the worker is running (if any) 1 Run Installing at R1211 afasdfa.dat Running
2 Run Installing at R1211 aftxt.drv Failed
• The next table describes the types of status that may be assigned to a worker and
reported in the Status column. 3 Run Installing at R1211 afatsaf2.sql Running
4 Run Installing at R1211 Wait
5 Run Installing at R1211 Wait
Status Meaning
Assigned The manager assigned a job to the worker, and the worker has not started.
Completed The worker completed the job, and the manager has not yet assigned it a new
job.
Fixed, Restart The worker should retry the failed operation now that the problem has been fixed.
Restarted The worker is retrying a job or has successfully restarted a job (note that the
status does not change to Running).
After fixing the error, execute adctrl and select option Restart Failed Worker & then give worker number you want to restart.
Note: If still you can’t fix or you don’t find any related error message in MOS, raise a Service Request to Oracle.
A worker usually runs continuously in the background and when it fails to complete the job it was assigned, it reports a status of
Failed. When the manager displays an error message, confirm the failed status of a worker by using AD Controller to review
worker status. If the job was deferred after the worker failed, no action may be required.
If a prerequisite patch for the patch you are applying is missing, you will receive a message telling you what prerequisite
patch(es) are missing. Then AutoPatch will exit. If the patch hasn't been applied, you'll need to apply it first or merge it
with the patch that depends on it.
If you have copied, cloned, or renamed your Oracle Applications system or changed the name of your APPL_TOP,
and applying a patch warns that prerequisites have not been applied even though they have been, you can fix the issue as
follows:
1. Run AD Administration and maintain snapshot information for the APPL_TOP on which the prerequisite checking issue occurs.
When it asks you the following question, answer "Yes“:
Refresh this APPL_TOP's snapshot with all bug fixes applied to all APPL_TOPs [No] ? Yes
Running the Maintain snapshot information task with this option lists all bug fixes applied to all APPL_TOPS in your Applications
system as having been applied to the current APPL_TOP.
2. Perform the above step for all APPL_TOPs in your Applications system.
You can correct this situation by providing the automatic patch prerequisite checking feature with updated patch metadata that
lists patch A as being superseded by patch B.
This updated metadata is contained in the OracleAppsPatches.ldt file in the Patch Information Bundle File used by Patch
Advisor (See Note 233039.1 Patch Information Bundle File (InfoBundle12i.zip) for more information about the Patch
Information Bundle File).
To make the updated patch metadata available, perform the following steps:
• Download InfoBundle12i.zip from MOS and extract OracleAppsPatches.ldt from the Zip file.
• Copy OracleAppsPatches.ldt to x <patch_number>.ldt and place it under the patch top directory where
b<patch_number>.ldt resides.
• Run the AutoPatch utility to apply the patch.
AutoPatch automatically loads patch metadata from files named b<patch_number>.ldt and x<patch_number>.ldt as the first
step in the automatic patch prerequisite checking feature. The information in x<patch_number>.ldt (OracleAppsPatches.ldt)
should cause the feature to understand that patch A is superseded by patch B, which should allow the patch to apply
successfully.
When running AutoPatch, there may be situations when a worker process appears to hang or stop processing. If this
occurs, you may need to terminate the process manually. If you do, you must also restart the process manually.
Attention: A process that appears to be hanging could be a valid long-running job. Be careful when terminating
processes. For step-by-step instructions for terminating a process, refer to:
There is no general method of backing out changes that a patch makes to the Oracle Application database. To avoid the
need to restore a database, you should always test the application of the patch several times on a test system,
particularly if the patch is a release update pack (RUP) or pre-upgrade patch.
Do not apply the patch in production until the patch has successfully applied in a test system !
Patching Overview
Patching Options Release 12
Troubleshooting Tips
Patch Wizard
New Patching features in Release 12.2
Q&A
• Displays the recommended EBS patches on your current code line and the latest
patchsets available.
• Determines the status of the patch: Applied, Not Applied, and Missing (indicates un-
applied hard prerequisites exist).
• Conducts an automatic patch impact analysis, showing the changes that the patch
will introduce to your system.
• Enables you to analyze specific patches and download/merge patches.
• Checks 11.5.10 baseline patches required for extended support.
• Provides an alert for changes that affect your customization via the Flagged Files
feature (R12).
•Additional Information
Patch Wizard Utility (Note976188.1)
Patch Wizard FAQ (Note976688.1)
Patch Wizard Training Videos (Note1085668.1)
Patch Wizard Overview Videos (Note1210479.1)
New ARU Access Protocol Requires Patches for Patch Wizard in Oracle E-Business Suite...
(Note 1267768.1)
How to Find E-Business Suite Recommended Patches (Note1400757.1)
Patching Overview
Patching Options Release 12
Troubleshooting Tips
Patch Wizard
New Patching features in Release 12.2
Q&A
For complete details on all upcoming Oracle Advisor Webcast Events, please see
Note 740966.1, Oracle Advisor Webcast Schedule.
Do you have any requests for future ATG Advisor Webcast Events ?
Please email your suggestions to me :