ADOP PATCHING PARAMETERS DETAILS:
| PARAMETER | DEFAULT VALUE | POSSIBLE VALUES | DESCRIPTION |
| phase | N/A | PHASE=PREPARE PHASE=APPLY PHASE=CUTOVER PHASE=CLEANUP PHASE=FINALIZE PHASE=ACTUALIZE_ALL PHASE=FS_CLONE PHASE=ABORT | These are the eight phases in which adop can run. It is most important and mandatory parameter that is used with adop. You can also club multiple phases in single command like ‘PHASE=PREPARE,APPLY’ although abort and fs_clone need to be run alone and can’t be clubbed.Standard phases: prepare – Prepare the instance for patch application. apply – Apply patches (to the patch edition). finalize – Ready the instance for cutover. It is run automatically. cutover – Make the patch edition the new run edition. cleanup – Drop obsolete objects and data from old editions. It is run automatically.
There are also three special phases, used as per requirement.
Special phases:
abort – Abort the current patching cycle. The abort phase can be run after either the prepare or apply phases have been run, but not after the cutover phase.
actualize_all – Create new copies of all code objects in the patch
edition. fs_clone – Copy the run file system to the patch file system. |
| loglevel | LOGLEVEL=EVENT | LOGLEVEL=STATEMENT LOGLEVEL=PROCEDURE LOGLEVEL=EVENT LOGLEVEL=WARNING LOGLEVEL=ERROR LOGLEVEL=UNEXPECTED | STATEMENT > for debugging. PROCEDURE > for debugging high level procedures. EVENT > to capture informational messages in normal processing. (default) WARNING > to capture any internal error that is handled by the system and does not affect processing. ERROR > indicates action failed, need to be reviewed, but the system continue processing. UNEXPECTED > indicates an unrecoverable error, requires user intervention before processing can continue. |
| cleanup_mode | CLEANUP_MODE=STANDARD | CLEANUP_MODE=FULL CLEANUP_MODE=STANDARD CLEANUP_MODE=QUICK | Cleanup processing needs to happen after adop finishes the patching work.Quick mode > shortest execution time, skips non-essential actions Standard mode > All quick mode action + drops covered objects Full mode > All quick mode action + remove all unused code, data, and old editions and takes much longer |
| finalize_mode | FINALIZE_MODE=QUICK | FINALIZE_MODE=QUICK FINALIZE_MODE=FULL | Quick mode > shortest execution, skips non-essential actions, no gather statistics. Full mode > Gather statistics, may improve performance after cutover, can take an hour extra to complete. |
| input_file | N/A | INPUT_FILE=<Absolute input_file path> | To specify the name of the input_file supplied to adop. (see details on input_file later in this post) |
| workers | N/A (depends on number of available CPU cores) | WORKERS=<User-specified-value> | Number of parallel workers used to execute tasks.In earlier released adpatch used to prompt for number of workers. With adop in R12.2, if you want to override the default formula that oracle uses now to calculation number of workers, use the WORKERS parameter. Take care that you don’t specify very high number of workers or else adop will fail. |
| maxworkers | N/A (depends on number of available CPU cores) | MAXWORKERS=<User-specified-value> | Maximum parallel workers that can be engaged. maxworkers should always be set to greater than the desired number of workers. |
| runcontextfile | $CONTEXT_FILE | RUNCONTEXTFILE=<Absolute context_file path> | To specify the non-default context file patch in RUN filesystem |
| patchcontextfile | Standard context file path in patch FS | PATCHCONTEXTFILE=<Absolute context_file path> | To specify the non-default context file patch in PATCH filesystem |
| patches | N/A | PATCHES=<User-specified-value>For Standard Patch:when>patch directory is a 6- to 8-digit numberPATCHES=<patch_number>
For Non-Standard Patch
when
> patch directory is not a 6- to 8-digit number example NLS patches <patch_number>_<language_code>. > patch driver files are not named *<patchnum>.drv example merged patchesPATCHES=<patch_number>:<driver_file>.drv | This parameter specifies the patches adop needs to apply.Remember the numbered-only patches (standard) and containing-a-colon categories of patch (non-standard) can be mixed.Like:PATCHES= <patch_number1>, <patch_number2>:<driver_file2>.drv |
| defaultsfile | $APPL_TOP/admin/<SID>_patch/adalldefaults.txt | DEFAULTSFILE=<Absolute defaults_file path> | Default file locations on both the run APPL_TOP and patch APPL_TOP is: $APPL_TOP/admin/<SID>_patch/adalldefaults.txtIn case you have created your own defaults file and want to use that instead, then use this parameter. |
| patchtop | $NE_BASE/EBSapps/patch | PATCHTOP=<Absolute patch_location_file path> | Default patch_top location is below.$NE_BASE/EBSapps/patchIf you want to keep your patches in some other lcoation, then you need to use this patrameter to let ADOP know where to search for patches pointed by ‘patches’ parameter.If you have a multi-node environment, you must download and unzip the patches (under $APPL_TOP_NE/EBSapps/patch) on the respective nodes. |
| merge | MERGE=NO | MERGE=NO MERGE=YES | In R12.2, oracle has integrated patch merging action in the patching command itself. In earlier releases we used to first merge patches using admrgpch command.By using MERGE=YES option ADOP will merge all the unified driver files into a single driver file. |
| abandon | ABANDON=NO | ABANDON=YES ABANDON=NO | If the patch you are applying went into error, you have two option when you start the adop utility again.1) you corrected error and want to continue with previous adop session:ABANDON=NO2) you decided that you don’t want to correct issue for now and want to abandon the previous adop session:ABANDON=YES |
| restart | RESTART=YES | RESTART=NO RESTART=YES | If the patch you are applying went into error and you corrected the issue and want to restart the previous patching session.It is just the reverse of ABANDON parameter.Remember ABANDON and RESTART will always have opposite value. |
| flags | N/A | FLAGS=AUTOSKIP | Use “flags=autoskip” in conjunction with the “abandon=no” parameter at the command-line to skip a failing patching step to “Continue as if a patch were successful”. You need to review the “autoskip” log that gets generated during the patching cycle in order to make sure that their were no errors and to take required actions in case of any errors |
| allnodes | ALLNODES=NO | ALLNODES=NO ALLNODES=YES | This parameter comes into picture when you have multi node setup. If you want to run adop on all nodes then use ALLNODES=YES. |
| action | ACTION=DB | ACTION=DB ACTION=NODB | Use this parameter to specify whether to perform database actions or skip. For example if you are in a multi-node environment and adop has already updated the database so when running on other node just use ACTION=NODB to save time.Remember when you are using ‘allnodes=yes’ in a multi-node ‘action=db’ must be specified. |
| apply | APPLY=YES | APPLY=YES APPLY=NO | To run adop in test mode (without applying any patches),specify apply=no |
| autoskip | AUTOSKIP=YES | AUTOSKIP=YES AUTOSKIP=NO | This parameter control whether the user is prompted about skipping actions in non-interactive patching. This is specifically useful when you are applying patches in multi node setup. |
| mtrestart | MTRESTART=YES | MTRESTART=YES MTRESTART=NO | This parameter specify whether to restart application tier services after cutover phase or not. |
| cm_wait | CM_WAIT=INFINITE (will wait forever) | CM_WAIT=<user_specified_number | Specifies the number of minutes to wait until the ICM will be forced down. |
| allowcoredump | ALLOWCOREDUMP=NO | ALLOWCOREDUMP=NO ALLOWCOREDUMP=YES | To specify that a core dump will be generated if adop crashes. |
| analytics | ANALYTICS=NO | ANALYTICS=NO ANALYTICS=YES | To specify that a report will be generated that can help debug certian adop issue. |
| preinstall | N/A | PREINSTALL=Y | This mode is used only if the patch readme instructs. Generally this mode is used during the upgrade process to update AD utilities, apply pre-upgrade patches, or work around other patching issues.It will Compares version numbers, Copies files, Relinks FND and AD executables, Saves patch information. It also runs autoconfig if required.The dual file system in Release 12.2 means that there is no need to shut down application tier services before running AutoConfig. |
| -help | N/A | N/A | Shows the help screen. |
| -status-status -detail | Latest Session | -STATUS (for latest session) -STATUS <SESSION_ID> (for specific session) | Display status of the latest adop session.Use ‘adop -status -detail’ for detailed info |
| -examples | N/A | N/A | Displays some commonly used adop ample commnads |
