It is important to keep track of the patching status of your system. This chapter describes how to identify patches that have not been applied to your system, and how to maintain any customized files.
This chapter covers the following topics:
- * 14-day Download Free Trial* - Pro. Buy Pro Edition. A tool used for hacking purposes such as a software crack/patch or an activation key generator. SUPERAntiSpyware can safely remove RUP_3.1. The file RUP_3.1.X_REGISTRATOR.EXE should be immediately removed from your system using SUPERAntiSpyware if the file is found to be harmful after.
- MultiPatch is an all-in-one file patching solution. With this one program, you can apply BPS, IPS, UPS, PPF, XDelta, BSDiff or RUP (Ninja2) patches to files. You can also create BPS, IPS, XDelta or BSDiff patches.
Filehash kzR ՀAB _ length 130742667. Name ec_patch_47-51.rup. Name.utf-8 ec_patch_47-51.rup. Piece length 131072. Publisher [ʱ] publisher-url http://www.rwpd.com.
Patch Wizard
With Patch Wizard, you can determine patches that have not been applied to your system. It does not report on all available patches. It compares the patches you have already applied against a list of all recommended Oracle E-Business Suite patches. Recommended patches can include high-priority patches or patches that update to a new codelevel, such as release update packs (RUPs), product family RUPs, and pre-upgrade patches.
How Patch Wizard Works
Patch Wizard supplies you with an interface from which you can:
- Set preferences, both site-specific and general, that include the staging directory and various defaults that will apply to the patches you download.
- Set up filters that report only those patches that may affect your system.
- Submit a request for a report of recommended patches, based on the filter(s) you set up.
- Analyze the impact of specific patches from a list you supply to Patch Wizard.
- Download patches, specify the language of the patches to download, and merge patches.
Before running any of the Patch Wizard tasks, set up your My Oracle Support (Metalink) credentials on the OAM Update Metalink Credentials page. To access this page, go to the Patch Wizard main page, click Setup in the title bar. Alternatively, click the Setup link at the top right of any page of the OAM interface.
The Dashboard Setup page appears. Click the Metalink Credentials link on the left side. The Update Metalink Credentials page appears.
OAM Update Metalink Credentials Page
Update your My Oracle Support credentials by providing your user ID, password, email address, proxy server host name, proxy server port, proxy bypass domains, proxy user name, and proxy password. The recommend, analyze, and download patches features typically require that your My Oracle Support user ID and password are set on the OAM Update Metalink Credentials page. However, the recommend and analyze features can also be used when Patch Wizard does not have access to a direct Internet connection. If this is the case, you can leave the Metalink user ID and password empty.
The Patch Information Bundle
The Patch Information Bundle file contains the zip files of recommended patches, the list of recommended patches (Recommended.xml), the latest codelevel patches (Codelevels.xml), and information on products and product families (ProductInfo.xml). Each patch zip file contains a readme file, a patch LDT file, and a patch metadata file (patch_metadata.xml).
The Patch Information Bundle file is updated daily. When you submit a patch analysis request, this file is automatically downloaded (if it is not specified otherwise in your Metalink credentials.)
Patch Wizard loads the Patch Information Bundle data, including LDT files and readme files, into the Oracle E-Business Suite database. It uses the metadata to provide patch recommendations.
Concurrent Programs
When you submit a request for patch analysis, Patch Wizard performs the following tasks using a set of concurrent programs:
- Uploading patch information from the Patch Information Bundle to Patch Wizard tablesPatch Wizard loads the Patch Information Bundle metadata, including LDT files and readme files, into the Oracle E-Business Suite database.
- Recommending patches based on the current environment and the Patch Information BundlePatch Wizard reports which patches update Oracle E-Business Suite at the current codelevel and which update to a new codelevel.
- Downloading patches (ad hoc or based on the list of recommended patches)Patch Wizard can download patches from My Oracle Support, and then merge the patches in the Patch Wizard staging directory.
- Analyzing lists of patches after downloading them from My Oracle SupportPatch Wizard uploads the metadata for a specific patch or set of patches for you to view information reported from the metadata. For example, you can submit a request for patch analysis, and then view any recommended patches that have not yet been applied and the impact of applying this new patch.
Running Patch Wizard Without Access to an Internet Connection
You can run Patch Wizard without access to an Internet connection, if necessary, by downloading the Patch Information Bundle to a system which has Internet access. Once the download is complete, copy the Patch Information Bundle file to the Patch Wizard's staging directory. Then run Patch Wizard as you normally would, to recommend and analyze patches, based on the files you copied to the staging directory.
The Patch Wizard Interface
Patch Wizard is a Web-based utility in Oracle Applications Manager (OAM). The OAM interface gives Patch Wizard pages a uniform look and feel. See: OAM Interface, Oracle E-Business Suite Maintenance Utilities.
Main Page
From this page, you have access to task icons used to set up the Patch Wizard staging directory, manage patch filters, submit concurrent requests, and view recommended patches. In addition, the Recommended Results section of this page displays a list of patches based on submitted requests.
Task Icons
From the main page, access the other Patch Wizard pages by clicking on Task icons. The icons provide links to the following pages: Patch Wizard Preferences, Define Patch Filters, Recommended/Analyze Patches, Download Patches, and Aggregate Patch Impact.
Details Icons
On many Patch Wizard pages, you can drill down to see more detail. For example, from the Recommended Patches Results section of the main page, click the Details icon for a specific recommended patch request to view the recommended patch results
Accessing Patch Wizard
To access Patch Wizard, log in to Oracle Applications Manager (OAM) and choose Patch Wizard from the Navigator pane.
- Enter the following URL in your browser:The Welcome page appears.Oracle E-Business Suite Welcome PageEnter your user name and password, and click Login. The Oracle E-Business Suite Home page appears. Click the System Administration link in the Navigator pane. Another Navigator pane appears to the right.
- Go to the Patch Wizard main page.Scroll down to the Oracle Applications Manager section of the right-hand Navigator pane, and click Patch Wizard to go to the main page.
Patch Wizard Main Page
Use the main page to access all features of Patch Wizard and to view the results of your requests for recommended patches. The Select Feature drop-down list at the top of the page provides access to the Applied Patches, File History, Timing Reports, and Register Flagged Files features.
Patch Wizard Main Page
Patch Wizard Tasks Table
The Patch Wizard Tasks table lists the tasks available in Patch Wizard. The table contains the following columns of information for each task:
- Task Name: Name of the Patch Wizard task.
- Description: Describes the task.
- Tasks: Link to the page associated with the Patch Wizard task.
- Job Status: Link to the request submission status of the task where you can review warnings or errors for your request.
From the Patch Wizard Tasks table, choose the Tasks icons to view:
- The Patch Wizard Preferences pageFrom the Preferences page, set the staging directory, merge patch defaults, the languages and platform defaults for downloading patches, and whether to display or hide hidden patches. You must define the values on this page before you use any other Patch Wizard feature. You can also use this page to modify existing preferences at a later date.
- The Define Patch Filters pageTypically, you see only those patches that are recommended for your system. Use this page to set up filters that report only those patches that may affect your system.
- The Recommend/Analyze Patches pageOnce you have selected values for a filter, submit the request to create a report of recommended patches based on that filter. You can also analyze specific patches by entering a comma-separated list of patch numbers.
- The Download Patches pageYou can download patches, specify the language of patches to download, and merge patches from this page.
Recommended Patches Results
The Recommended Patches Results section of the Patch Wizard main page lists all in-progress and completed requests for patch recommendations, based on the information you entered in the Filter Criteria section of the main page. For example, you can view only the results that contain a certain text string in the filter name, or only the results of requests completed on a certain date.
Patch Wizard Main Page - Recommended Patches Results
Clicking the icon in the Details column of a specific recommended patch request accesses the Recommended Patches Results page. After setting up and submitting a request, view the details of the recommended patches on this page.
Patch Wizard Preferences
The site-specific information you set on the Patch Wizard Preferences page applies to other functions of Patch Wizard, such as Recommend/Analyze, Download Patches, and Codelevels Summary. From the Patch Wizard main page, click the Tasks icon for Patch Wizard Preferences.
The top portion of the page contains these sections: Staging Directory, Merge Option Defaults, and Language and Platform Details.
Patch Wizard Preferences Page - Top
The bottom portion of the page contains the In Use Products Defaults and the Display Option Defaults sections.
Patch Wizard Preferences Page - Bottom
Staging Directory
Depending on the product type (AD or non-AD), Patch Wizard downloads patches to a subdirectory under the staging directory. If the patch that ADOAM is trying to download is an AD product patch, it will be downloaded to the 'ad' subdirectory under the stage directory. Non-AD Patches will be downloaded to “nonad' subdirectory.
The staging directory is also used by Patch Wizard to create temporary files and subdirectories for patch recommendation requests. These temporary files and directories are deleted after processing.
Note: Oracle recommends you use the same staging directory each time you run Patch Wizard.
Merge Option Defaults
Merging patches reduces patch application time by eliminating redundant tasks (such as responding to prompts and linking executables) for each individual patch.
Note: AD product patches cannot be merged with other product patches.
Patch Wizard screens allow you to merge AD and non-AD patches by specifying the appropriate options as discussed below. You can choose to automatically merge patches that you download.
The following merge options can be set:
- Metalink Credentials: This link accesses the OAM Update Metalink Credentials page, which allows you to set your My Oracle Support user ID and password. The recommend, analyze, and download patches features typically require that your My Oracle Support user ID and password are set in the OAM Update Metalink Credentials page. The recommend and analyze features can also be used when Patch Wizard does not have access to a direct Internet connection. If this is the case, leave the Metalink user ID and password empty.The patches will be downloaded to the relevant subdirectory for the patch's product. If the patch that ADOAM is trying to download is an AD product's patch, it will be downloaded to 'ad' subdirectory under the stage directory. Otherewise, it will be downloaded to the 'nonad' subdirectory.
- Automatically merge downloaded patches: This check box tells Patch Wizard to automatically merge all downloaded patches.
- Merging Strategy: The following merging strategies when are available when downloading translation patches:
- One merged patch: If the list of patches contains a single AD product patch or a single non-AD product patch, a single merged patch containing US and non-US patches will be generated. If the list of patches contains both AD and non-AD product patches, two merged patches will be generated: one for the merge of all the AD product patches, and the other for the merge of all non-AD product patches.For example, if 'mrg_2009072781642' is the merged patch name provided in the Downloads page, the merged AD patch directory name will be mrg_2009072781642_A, and the merged non-AD patch directory name will be mrg_2009072781642_N.
- Two merged patches: If the list of US patches includes both AD and non-AD product patches, the patches will be merged separately for AD and non-AD product patches. One merged patch will contain all US patches, and a second merged patch will contain all non-US patches.For example, if 'mrg_2009072781642' is the merged patch name provided in the Downloads page, the merged AD US patch directory name will be mrg_2009072781642_US_A, and the merged non-AD US patch directory name will be mrg_2009072781642_US_N.
- Multiple merged patches: If the list of US patches includes a combination of AD products, non-AD products, AD language patches, and non-AD language patches, the patches will be merged separately for each of these categories.For example, if 'mrg_2009072781642' is the merged patch name provided in the Downloads page, the merged AD US patch directory name will be mrg_2009072781642_US_A, the merged non-AD US patch directory name will be mrg_2009072781642_US_N, the merged AD NLS patch directory name will be mrg_2009072781642_<lang_abbr>_A, and the merged non-AD NLS patch directory name will be mrg_2009072781642_<lang_abbr>_N.
Language and Platform Details
You can select the languages (one or more) of patches that Patch Wizard will recommend and download. You can also select the platform of the patches you want recommended and downloaded.
In Use Products Defaults
Selecting the Patch Recommendation for In Use Products Only check box directs Patch Wizard to display on the Recommended Patch Results page only patches for the products marked as in use (active) in your system.
Both Patch Wizard and AutoPatch look at the In Use flag to determine what products you are using. To review the products currently marked as being in use in your system, click the Codelevels Summary Page link. See: Codelevels Introduced by the Patch.
Display Option Defaults
Hidden patches are patches that you choose not to see in your reports. For example, if Patch Wizard recommends patches for products you do not need for your system, you can choose to hide these patches.
However, checking the Show Hidden Patches box in the Patch Wizard Preferences page overrides the hidden patch setting, and all patches, even hidden patches, are reported.
After you have made all your selections on the Patch Wizard Preferences page, click OK to save them or click Cancel to discard.
Define Patch Filters
The Patch Information Bundle file contains information for all recommended patches for all products. If Patch Wizard were to compare patches in the patch information database against all metadata in the Patch Information Bundle file, the number of recommended patches in the report might be too large to be useful for an individual system. Patch Wizards provides filters so that only those patch types and products in the metadata that apply to your system are included in the comparison.
From the main page, click the Tasks icon for Define Patch Filters to see all filters created for the current system. Patch Wizard provides three pre-seeded filters. In addition, you can create your own custom filters.
Define Patch Filters Page
Note that the pre-seeded filters are marked 'Oracle' in the Type column, and filters you create are marked 'Custom.' You cannot edit or delete the pre-seeded filters, but you can use any of them as a template to create a new filter.
The pre-seeded filters are:
- New Codelevels: Determines recommended patches for release update packs (RUPs), product family RUPs, and pre-upgrade patches. These patches update versions of a product, family, or the entire Oracle E-Business Suite system.
- Recommended Patches: Determines recommended patches for the current codelevel.
- Recommended Patches and New Codelevels: Determines recommended patches for both the current and new codelevels.
Creating a New Custom Patch Filter
From the Define Patch Filters page, click Create New to create a new custom filter.
Create Patch Filters Page
On the Create Patch Filters page, enter a unique name and a description for each new custom filter. All licensed product families are listed in the Licensed Product Families section. Non-licensed product families are listed at the bottom of the page. There are two columns for each product family: Recommended Patches and New Codelevel. Select a box for each product family you want to include in the new filter.
By choosing the Create Like button on the Define Patch Filters page, you indicate you want to use an existing filter as a template to create a new filter. The system supplies the filter criteria from the existing filter for the new filter. Edit the criteria by checking or clearing the boxes. Click Continue to create the new filter.
Recommend/Analyze Patches
After setting up the Patch Wizard staging area (and optionally creating custom filters) on the main page, you can submit requests for processing. Click the Tasks icon for Recommend/Analyze Patches.
Recommend Patches Page - Top
The Options section of the Recommend Patches page contains the following actions:
- Create RecommendationThis generates recommendations based on the patch filter you selected. Choose one of the pre-seeded filters or any custom filter you created on the Define Patch Filters page. Patch Wizard uses the filter and compares the patch information database against the patch metadata to recommend which patches you should apply. For more information on Aggregate Patch Impact, refer to Oracle E-Business Suite System Administrator's Guide - Maintenance.
- Analyze Specific PatchesThis generates recommendations for specific patches. After downloading specific patches from My Oracle Support and placing them in the staging area, you can analyze these patches to determine their affect on your system by entering the patch numbers in this section. (Enter either bug numbers (for example, 1234567) or full patch names (for example, 1234567_R12.AD.A).) Check the 'Analyze Aggregate Patch Impact' box to analyze Aggregate Patch Impact. For more information on Aggregate Patch Impact, refer to Oracle E-Business Suite System Administrator's Guide - Maintenance.
You can enter a date and time in the Schedule section of this page to run the request at a later time. The default setting is to run the job immediately. You can also schedule automatic recurring requests by entering the information in the Recurrence section.
Recommend Patches Page - Bottom
Click OK to submit the request.
When the request is submitted, Patch Wizard looks in the specific directories under the stage directory for the patches. If the patches are not present, or if there are newer versions available, Patch Wizard downloads them from My Oracle Support before creating recommendations or analyzing patches.
Note: If you want to create recommendations or analyze specific patches without using an Internet connection, refer to Creating Patch Recommendations Without an Internet Connection or Analyzing Patches Without an Internet Connection.
Each time you submit a request to analyze specific patches or to recommend patches, Patch Wizard creates a Request Set ID. The Request Set ID is shown in the Results section of the Patch Wizard main page. To check the status of your request, click on the Request Set ID corresponding to your request in the Recommended Patches Results section.
Download Patches
You use the Download Patches page to request a download of specific patches from My Oracle Support. From the main page, click the Download Patches tasks icon. From the Download Patches page, enter the patch numbers in the input field, separated with commas. Enter either bug numbers (for example, 1234567) or full patch names (for example, 1234567_R12.AD.A). You can also choose to analyze the patches while downloading, or analyze and compute aggregate patch impact while downloading.
Download Patches Page - Top
The Merge Options section is where you define how patches should be merged after downloading. The defaults for merging are set on the Patch Wizard Preferences page. If you choose to automatically merge patches while downloading, you can modify the merged patch name and specify the merging strategy in this section. The default merged patch name is 'merged_YYYYMMDDhhmmss', where 'hh' is in 24-hour format.
The Languages and Platform section allows you to select the languages and platform of the downloaded patches. The defaults for languages and platform are set on the Patch Wizard Preferences page. However, you can modify the information on this page. When you provide information in this section, Patch Wizard downloads only patches that match the languages and platform you select.
Download Patches Page - Bottom
You can also provide information in the Schedule section about downloads you want to perform at a later date.
Recommended Patches Results
From the main page, click the Details icon associated with a patch request in the Results section to access the Recommended Patches Results page. This page presents a set of recommended patches based on the results of the selected Recommend Patches request that you submitted.
The first section lists the recommended patches.
Recommended Patches Results Page
The second section lists patches that introduce new codelevels.
Recommended Patches Results - Patches that Introduce New Codelevels
Both sections display the following columns:
- Select: Select this check box and click the Download button if you want the patch number sent to the Download Patches page for submission. You can select any number of patches.
- Patch: The patch number of the recommended patch.
- Product: The product to which patch applies.
- Prerequisites: Specifies the codelevel required before you can apply this patch.
- Codelevel Introduced: Indicates whether the patch introduces a new codelevel for that product. If a new codelevel is introduced, the Yes indicator contains a link the Codelevels Introduced by the Patch page.
- Status: Indicates whether the patch is applied, unapplied, missing, or obsolete.
- PAA: This indicates whether there are manual steps you have to perform if you apply the patch.
- Reason Recommended: The reason the patch is recommended, for example, it is a high-priority patch, or part of a maintenance release pack (RUP) or a product family pack (RUP).
- Patch Description: Describes the patch.
- Hide Patch: Select this check box to hide the patch from the list of recommended patches. Use this feature to hide patches that you do not want to apply to your system. To hide or show selected patches, use the Show Hidden Patches check box at the top of the page and click Redisplay Data to refresh the page. The default values are set in the Patch Wizard Preferences page.
- Included in Aggregate Patch Impact: For more information on Aggregate Patch Impact, refer to Oracle E-Business Suite System Administrator's Guide - Maintenance.
- Impact: (For unapplied or missing patches only) Click this icon to access the Patch Impact Analysis page. If you submitted a specific patch to analyze, click the Impact icon on the Recommended Patches Request page to view this report.
Click the Download button to transfer the selected patch number(s) to the Download Patches page for submission.
Codelevels Introduced by the Patch
If new codelevels are introduced by the patch, the Yes indicator in the Codelevel Introduced column of the Recommended Patches Results page is a link that takes you to the Codelevels Introduced by the Patch page.
Codelevels Introduced by the Patch Page
This page contains the following information.
Patch Information
This section includes the following information:
- Product: Product name associated with the patch.
- Description: Describes the selected patch.
- Reason Recommended: The reason for which the patch is recommended.
Codelevels Information
This section includes the following information:
- Abbreviation: The abbreviation for the product, product family, or feature to which this patch applies.
- Name: The full name of the product, product family, or feature to which this patch applies.
- Type: Indicates whether this patch applies to a product, product family, or feature.
- Codeline: Indicates the codeline of the product, product family, or feature in your current system.
- New Codeline: Indicates whether this patch introduces a new codeline.
- Codelevel Introduced: The new codelevel that this patch introduces for the product, product family, or feature.
To view the codelevels of all the products and product families available and in use in your system, click the Codelevels Summary link in the Patch Information section.
Codelevels Summary Page
This page summarizes available products. For each product, it indicates the current Codeline and Codelevel and whether it is in use (active) in your system. Patch Wizard and AutoPatch look at the In Use flag to determine active products.
Caution: If you use this page to update your In Use products list, be sure you do not uncheck any products that are active in your system, or are required for system operation.
Patch Impact Analysis
From the Recommended Patches Results page, click an icon in the Impact column to view the Patch Impact Analysis page for that patch.
This page displays a list of summary information about which files are new, which files are changed, and which files are ignored when you apply the patch. Prerequisite patches and the readme file for this patch are also shown. Each of the summary items is a link to more complete information.
The key information on this page is separated into these sections.
General Patch Information
General patch information includes:
- Patch Description: Describes the patch.
- Patch Readme: Click this icon to see the readme file for the patch.
- Total Files in Patch: The total number of files in the patch. Click the number link to access the Patch Impact Details page, which lists each file in the patch.
- Files to Install: The number of files the patch will install.
Summary Information
There are two types of summary information: Direct Impact and Indirect Impact. Each summary item is a link to a page that lists the details for the summary count. For example, if you the number of Existing Files Changed, the details might look similar to this:
Direct patch impact includes:
- Applications Patched: The number of products that will have files updated. Click the number link to see details of each product affected, and how.
- File Types Installed: The number of different file types in the patch. Click the number link to see the file types and how they impact the system.
- New Files Introduced: The number of new files that will be introduced by the patch. Click the number link to details about each new file introduced.
- Existing Files Changed: The number of existing files in the system that will be changed by the patch. Click the number link to see the existing files changed and the new version numbers.
- Flagged Files Changed: The number of custom files that will be changed by this patch. Click the number link to identify the custom files changed by this patch.
- Existing Files Unchanged: The number of files unchanged because the version in the patch is older than the version in the system. Click the number link to see the files in the patch that are of the same or of earlier versions than those currently in the system.
- Non-US Language Patches Required: If the patch supports multiple languages, click the number link to identify the other languages available.
Indirect summary information includes:
- Unchanged Files Affected: The number of system files with dependencies on patched files.
- Menu Navigation Trees Affected: The number of menu navigation trees that will be updated by the patch.
Register Flagged Files
With the Register Flagged Files tool, you can record any files in which you have made customizations. In previous releases of Oracle E-Business Suite, the applcust.txt file contained the records for all customized files. You had to maintain your custom files records in this file. In this release, information about customized files is still written to the applcust.txt file. However, with the Register Flagged Files tool you can download the files and maintain them in a web-based interface.
The Register Flagged Files tool displays the following information about customized files:
- Product abbreviation
- Directory where the files are located
- Name of modified file
- Comments
The Register Flagged Files Interface
The Register Flagged Files tool is a Web-based utility in Oracle Applications Manager. From the Register Flagged Files home page, you can import, export, add, delete, and view records of customized files.
Accessing Register Flagged Files
To access the Register Flagged Files tool, log in to Oracle Applications Manager (OAM) and choose Register Flagged Files from the Site Map.
Step 1: Log in to Oracle Applications Manager
Follow the instructions in Accessing Patch Wizard to access OAM. From the Applications Dashboard, click the Site Map tab.
Step 2: Go the Register Flagged Files home page
On the Site Map page, Register Flagged Files is included on the Maintenance tab under the Patching and Utilities heading. Click the Register Flagged Files link to go to the home page.
Step 3: Select filter criteria
From the Register Flagged Files home page, you can search the records of customized files by product abbreviation, directory, file name, or a combination of product abbreviation, and directory or file name.
Register Flagged Files Home Page
This section describes the Register Flagged Files home page.
Register Flagged Files Home Page
Use the following buttons to:
- Import: Import a list of customized files from the applcust.txt file in csv format. Use this option to import a local applcust.txt file to the current system or from another system to the current one.
- Export: Export a list of customized files in csv format. The default name of the exported file is oamreport.csv. You can use this function to export a list of customized files for import into another system.
- Add: Add a record of a customized file.
- Cancel: Return to the Applications Dashboard home page.
- Apply: Apply and save any changes made to the Comments field of the list of customized files.
You can filter results either by product abbreviation, by directory/file name, or by a combination of product abbreviation, and directory or file name.
- Product Abbreviation: To search by product abbreviation, enter the abbreviation of the product for which the customization is made.
- Directory/File Name: You can filter the results by directory or file name. Enter the directory or file name for which the customization is made.
List of Customized Files
The list of customized files appears at the bottom of the Register Flagged Files home page. Each line item represents a customized file.
The details provided for each line item are:
- Select: Select and delete the corresponding customized file. You can select and delete one file or multiple files at a time.
- Product Abbreviation: The abbreviated name of the Oracle E-Business Suite product family for which there is a customization.
- Directory: Directory path of the customized file.
- File Name: Name of the modified file.
- Comments: Use this area to add any comments associated with the customization. Oracle recommends using this area to record the exact location of the customized file.
Adding a Flagged File
Click the Add button on the Register Flagged Files main page to access the Add Flagged Files page. From this page, you can add customized files. Use the Filter Criteria section to search for files you want to add.
Add Flagged Files Page
You can filter results either by product abbreviation, by directory/file name, or by a combination of product abbreviation, and directory or file name.
- Product Abbreviation: To search by product abbreviation, enter the abbreviation of the product for which the customization is made.
- Directory/File Name: You can filter the results by directory or file name. Enter the directory or file name for which the customization is made.
From the Search Results section, select a file, then click the Add button. The files you select appear in the Selected Data section. Use this section to add any comments you have for each file. Then click the Apply button to confirm your selection.
Importing a Flagged File
Click the Import button on the Register Flagged Files main page to access the Import Flagged File page. From the this page, you can import one file or a list of customized files in csv format.
You can import an existing applcust.txt file or a file from another system to the current one. This features saves you the time of using the Add button to add flagged files individually.
Import Flagged File Page
In the Select File field, enter the name of the file you want to import or click the Browse button to navigate to the file. Then click Import. Click Cancel to return to the Register Flagged Files main page.
This chapter describes how to install release update patches in Oracle Fusion Applications.
This chapter contains the following topics:
5.1 Introduction to Oracle Fusion Applications Release Update Patches
This section provides an introduction to the following concepts related to release update patches:
5.1.1 Release Update Patches
A RUP is a set of cumulative patches and changes for the entire Oracle Fusion Applications Suite, for a base release. A RUP can sometimes introduce new functionality, and should be applied when suitable. You install RUPs with Oracle Fusion Applications RUP Installer. To install a certain version of a RUP you must have successfully installed the previous version.
5.1.2 Oracle Fusion Applications RUP Installer (RUP Installer)
RUP Installer is a Java-based installer that enables you to install a group of patches across all product families, to upgrade Oracle Fusion Applications to the next release. RUP Installer can patch existing content and can also copy and deploy new artifacts, depending on the contents of the RUP. You run RUP Installer in interactive mode and proceed through the installation by providing information in the user interface when prompted.
5.1.3 RUP Installer User Interface
RUP Installer provides a graphical user interface which allows you to control the behavior of the installer by the use of buttons, in cases where it encounters a failure. Note that the behavior of these buttons may vary, depending on whether it is a task, or a step within a task, that fails. The behavior also depends on whether a task is mandatory. All mandatory configuration tasks must complete successfully before proceeding to the next configuration task. For information about which tasks are mandatory, see Section 5.1.4, 'RUP Installer Configuration Tasks'.
You can exit RUP Installer in the event of a failure and restart from the point of failure. If a non-mandatory task fails, and you continue to the next task, you must restart RUP Installer after it completes with incomplete tasks. When you restart, RUP Installer retries all failed configuration tasks and steps. For more information about what to do when a configuration action fails, see Section 5.5.3, 'General Troubleshooting During the Configuration Phase'.
An explanation of the usage of each button follows.
5.1.3.1 Abort Button
The Abort button allows you to skip a failed task or step within a task, and records the failure so it can be rerun when you restart the installation. For mandatory tasks, after you abort the task, RUP Installer does not proceed and only the Cancel button is enabled. You must then resolve the cause of the failure and start RUP Installer from this failure point. For non-mandatory tasks, RUP Installer proceeds to the next configuration task after you abort the task. This button is enabled only after a failure.
5.1.3.2 Cancel Button
The Cancel button allows you to stop a RUP Installer session after a failure. This button is enabled only after a failure.
5.1.3.3 Close Button
The Windows Close button allows you to stop a RUP Installer session after a failure. This button is enabled only after a failure.
5.1.3.4 Continue Button
The Continue button allows you to skip a failed step within a task that is not mandatory, or a non-mandatory task, and records the failure. RUP Installer then proceeds with the next step. When you rerun this RUP Installer session, the failed configuration actions are attempted again.
Note that this button is enabled only for configuration tasks that contain steps and is not enabled in the case of failure for configuration tasks that do not contain steps.
5.1.3.5 Next Button
The Next button allows you to proceed to the next screen. This button is enabled only when all tasks complete successfully in the current screen.
5.1.3.6 Retry Button
The Retry button allows you to attempt to run a failed configuration task, or a step within a task, again. Use Retry when you know the cause of the failure and can resolve the issue during the current RUP Installer session.
5.1.4 RUP Installer Configuration Tasks
During the installation phase, RUP Installer copies all files from the RUP to the appropriate location, such as Oracle Fusion Middleware home and Oracle Fusion Applications Oracle home. After the file copy is completed, RUP Installer performs the Policy Store Analysis, as described in Table 5-4. Upon successful completion of the Policy Store Analysis, RUP Installer calls Configuration Assistants to perform the remaining tasks required to update and deploy the artifacts included in the RUP. Depending on the contents of the RUP, not all tasks run.
If any tasks fail during the installation phase, refer to Section 5.5.2, 'Troubleshooting Failures During the Installation Phase'.
All mandatory configuration tasks must complete successfully before proceeding to the next configuration task. For more information, see Section 5.5.3, 'General Troubleshooting During the Configuration Phase'.
Table 5-1 provides a complete list of possible configuration tasks. The Retry Behavior column describes what RUP Installer does after a configuration task fails and you use the Retry button. If available, links are provided to the relevant troubleshooting sections.
Table 5-1 Configuration Tasks Run by Oracle Fusion Applications 11g Release 1 (11.1.3.0.0) RUP Installer
Name | Mandatory | Description | Retry Behavior |
---|---|---|---|
Configure Patch Manager | Yes | Configures Oracle Fusion Applications Patch Manager | Starts from the beginning of the task |
Bootstrap Patch Manager | Yes | Updates the data model for Oracle Fusion Applications Patch Manager by running the fapmgr bootstrap command. | Starts from the beginning of the task See Section 5.5.6, 'Error During Bootstrapping Patch Manager'. |
Verify Middleware PSA Schema Credentials | Yes | Verifies users and logins for schema. | Starts from the beginning of the task. |
Apply Middleware Patch Sets | Yes | Applies Oracle Fusion Middleware patch sets, which include schema changes and installers. | Starts from the beginning of the task. See Section 5.5.8, 'Failure During Applying Middleware Patch Sets'. |
Apply Pre-PSA Middleware Patches | Yes | Applies WebLogic Server Smart Update patches and Opatch based patches. See Section 5.1.4.1, 'Installers Invoked by the Apply Pre-PSA Middleware Patches Tasks' and Section 5.1.4.2, 'Patches Not Supported by the Apply Pre- and Post-PSA Middleware Patches Tasks'. | Applies the failed patches. See Section 5.5.7, 'Troubleshooting Applying Middleware Patches'. |
Upgrade Middleware Schemas | Yes | Runs Oracle Fusion Middleware patch sets assistants. | Starts from the beginning of the task. |
Apply Post-PSA Middleware Patches | Yes | Applies patches that update Oracle Fusion Middleware Extensions for Applications objects. See Section 5.1.4.2, 'Patches Not Supported by the Apply Pre- and Post-PSA Middleware Patches Tasks' | Applies the failed patches. Section 5.5.7, 'Troubleshooting Applying Middleware Patches'. |
Offline Preverification | Yes | Performs the following validation checks while all servers are shutdown:
| Runs failed steps Section 5.5.11, 'LdapServerCheck Failure'. |
Load Database Components | Yes | Uploads the database content packaged in the RUP to the database, such as database objects, seed data, and package headers and bodies. | Runs failed database commands. See Section 5.5.10, 'Troubleshooting Loading Database Components'. |
Upgrade OPSS | Yes | Upgrades the OPSS DIT and schema in the security store. Upgrades the configuration on each domain. Adds Delegated Administration policies to the policies in the security store. | Starts from the beginning of the task. See Section 5.5.11, 'LdapServerCheck Failure'. |
Deploy Applications Policies (jazn-data.xml) | Yes | Performs the deployment of the updated applications policies, based on your selections during the Policy Store Analysis task. This task does not run if you installed a Language Pack and chose to override the base English strings in the policy store by using the J-DupdateJAZNPolicyStore option set to true. | Deploys the failed stripes. See Section 5.5.12, 'Troubleshooting Deployment of Applications Policies'. |
Deploy Data Security Grants | Yes | Performs GUID reconciliation in LDAP. | Starts from the beginning of the task. |
Generate ADF Domain Configuration Plan | Yes | Generates Oracle ADF domain configuration in Metadata Service (MDS) to be used by Expression Language (EL) expressions in connections.xml . | Starts from the beginning of the task. |
Generate ESS Connections File | Yes | Generates adf-domain-config.xml in MDS to be used by EL expressions in ESS connections.xml . | Starts from the beginning of the task. |
Generate SOA Configuration Plan | Yes | Generates the configuration plan to be used for deploying SOA composites. | Starts from the beginning of the task. |
Update Flexfield Configuration | Yes | Updates the required configuration file for supporting new flexfields, new flexfield usages, and flexfield view links added by Oracle Fusion Application products. | Starts from the beginning of the task. |
Deploy BPM Templates | Yes | Deploys BPM Templates to the MDS repository. | Deploys failed templates. |
Deploy BI Publisher Artifacts | Yes | Deploy Copies captions and deploys Webcat to the Oracle Business Intelligence repository using Catalog Manager. | Starts from the beginning of the task. See Section 5.5.15, 'Failure During Deployment of BI Publisher Artifacts'. |
Import Oracle Data Integrator Repository | Yes | Imports ODI related changes to the ODI repository. | Imports failed data. |
Apply Offline Setting Changes | Yes | Applies Oracle Fusion Applications environment configuration setting changes during the offline phase. | Starts from the beginning of the task. |
Verify Node Manager and OPMN Status | Yes | Checks for access to the Node Manager and the Oracle Process Manager and Notification Server (OPMN) control process, and should fail because you manually shut these processes down prior to starting RUP Installer. You must manually start both the Node Manager for all domains and the OPMN control process at this time. You must not exit out of RUP Installer during this task. | Runs failed steps. |
Start all servers | No Discover and download the best Sims 4 Custom Content and Mods at The Sims Catalog. With over 50,000 Mods and CC creations to choose from, you're bound to found what you're looking for! Most Popular in Game Mods. You are currently viewing all Sims 4 Mods. You can refine results by subcategories: Poses Traits CAS. No Mosaic / Censor Nude Mod. Sims 4 pc nude mods patch download. | Starts all servers in all domains, including the BI servers. | Restarts failed servers. See Section 5.5.16, 'Failures During Starting All Servers' |
Online Preverification | Yes | For more information, see Section 5.1.4.3, 'Validation Steps Performed During Online Preverification Task'. | Runs failed steps. See Section 5.5.9, 'EditTimedOutException Error During Online Preverification' and Section 5.5.18, 'Merging SOA Composite JDeveloper Customizations While Installing a RUP'. |
Generate OHS Reference Configuration File | No | Generates Oracle HTTP Server (OHS) configuration files for installed product families in this directory: APPLICATIONS_BASE/ fusionapps/applications/admin/OHS/patched_moduleconf . You must manually modify the related properties file in order for this task to be successful. For more information, see Section 5.2.12, 'Update Oracle Fusion Middleware Schema Credentials'. | Starts from the beginning of the task. |
Apply OAM Configuration | No | Applies changes to the Oracle Access Manager configuration. You must manually modify the related properties file in order for this task to be successful. For more information, see Section 5.2.12, 'Update Oracle Fusion Middleware Schema Credentials'. | Starts from the beginning of the task. See Section 5.5.13, 'Failure during Applying OAM Configuration'. |
Deploy Flexfields | No | Deploys flexfields to the domain that hosts the FndSetup application. | Starts from the beginning of the task. |
Import Image Routing (IPM) Artifacts | No | Deploys IPM artifacts to the IPM server. | Retries only failed IPM artifacts. See Section 5.5.17, 'Failure During IPM Import'. |
Deploy B2B Metadata | No | Deploys B2B Metadata. | Deploys failed B2B artifacts. |
Deploy SPE Inline Service Artifacts | No | Deploys SPE Inline Service Artifacts. | Retries the deployment. |
Deploy Data Role (RGX) Templates | No | Deploys RGX Template artifacts to the Common Domain. | Deploys failed templates. |
Import Group Space Templates | No | Imports Group Space Templates | Deploys failed templates. |
Deploy SOA Shared Repository Artifacts | No | Deploys SOA shared repository artifacts to SOA servers available in the environment. | Deploys failed SOA shared repository artifacts. |
Deploy SOA Composites | No | Deploys SOA composites to the corresponding SOA servers and performs server management steps. | Deploys failed SOA composites. See Section 5.5.19, 'Troubleshooting SOA Composite Deployment Failures'. |
Deploy SOA Resource Bundles | Yes | Deploys SOA Resource Bundles to the corresponding SOA servers. | Deploys failed SOA resource bundles. |
Restart All SOA Servers | No | Restarts all SOA servers in the environment. | Starts at the beginning of the task. |
Applying Online Setting Changes | No | Applies Oracle Fusion Applications environment configuration setting changes during the online phase. | Starts from the failed task. |
Apply BI Metadata Updates | Yes | Applies Oracle Business Intelligence Metadata Updates. | Applies failed patches.Section 5.5.20, 'Failure During Applying BI Metadata Updates'. |
5.1.4.1 Installers Invoked by the Apply Pre-PSA Middleware Patches Tasks
The following installers are installed by the Pre-PSA Middleware Patches configuration task:
- Oracle Business Intelligence
- Oracle Common
- Oracle Data Integrator (ODI)
- Oracle Database Client
- Oracle Enterprise Content Management
- Oracle HTTP Server (OHS) - Note that this is the embedded OHS. OHS may also be installed in the DMZ. Patching OHS in the DMZ is a manual process not supported by RUP Installer.
- Oracle Fusion Middleware Extensions for Applications
- Oracle Global Order Promising
- Oracle Secure Enterprise Search (SES)
- Oracle SOA Suite
- Oracle WebCenter Suite
- Oracle WebLogic Server
- Oracle Web Tier
5.1.4.2 Patches Not Supported by the Apply Pre- and Post-PSA Middleware Patches Tasks
The following patches are not supported by these configuration tasks:
- Patching Integrated Development Environment (IDE)
- Patching OHS installed in the DMZ. For more information, refer to Oracle Fusion Applications release notes for information about mandatory OHS patches.
- Patching your Database Server. For more information, see Section 5.3.2, 'Apply Mandatory Prerequisite Patches'.
- Patching your Oracle Identity Management Server. For more information, refer to 'Oracle Identity Management Patches for Oracle Fusion Applications' in Oracle Fusion Applications release notes.
5.1.4.3 Validation Steps Performed During Online Preverification Task
The following validation steps are performed during this task:
- Taxonomy URL
- Flexfield: Checks if the flexfield deployed Managed Server is up
- OAM Configuration
- SOA Shared Repository: Verifies the taxonomy, checks if the Administration Server is up, and if the SOA platform is ready
- SOA Resource Bundle: Verifies the taxonomy, checks if the Administration Server is up, and if the SOA platform is ready
- SOA Composite: Performs the following validation steps:
- Verifies the taxonomy
- Checks if the Administration Server is up
- Checks if the SOA platform is ready
- Checks if the base composite is deployed
- Checks if the default revision is deployed
- Checks if the new revision is not deployed
- Checks whether the SOA composites that will be affected by the patch have JDeveloper customizations. For more information, see Section 5.5.18, 'Merging SOA Composite JDeveloper Customizations While Installing a RUP'.
- Image Routing (IPM): Checks if the IPM server is up
- B2B Metadata: Checks if the Common Domain SOA Managed Server and the LDAP Server are up
- SPE Inline Service: Checks if the Oracle CRM Performance application is deployed. If it is, the OracleRTD application must be deployed and at least one BI server must be running where the OracleRTD application is deployed.
- Data Role (RGX) Template: Checks if the Administration Server for the Common Domain is up
- Group Space Template: Checks if the following Managed Servers are up:
WC_Spaces, WC_Collaboration, ucm_server1
5.2 Prepare to Install a RUP - Pre-Down Time
This section describes the following preparation steps for installing a RUP, all of which can be performed before your scheduled down time.
5.2.1 Before You Begin
Before you begin the upgrade, you should have access to the following documentation:
- RUP Installer documentation from the previous release
- Oracle Fusion Applications release notes from the previous release
- Oracle Fusion Applications release notes from the release you are upgrading to
You should also have a clear understanding of the following host and directories:
- Primordial host: The primordial host is where the Administration Server for the Common Domain runs
- APPLICATIONS_CONFIG: The top-level directory for the Oracle Fusion Applications configuration files
- APPLICATIONS_BASE: The top-level directory for the Oracle Fusion Applications binaries
- FA_ORACLE_HOME: Directory named
applications
, located under thefusionapps
Oracle Fusion Applications Middleware home
For more information, see 'Provisioned Oracle Fusion Applications Home Directories' in the Oracle Fusion Applications Administrator's Guide.
5.2.2 Confirm Installation of Oracle Fusion Applications RUP1 (11.1.2.0.0)
Ensure that you have successfully installed RUP1 and followed all post installation tasks in the RUP2 documentation and in the 'Applying Patches' section of Oracle Fusion Applications Release Notes. For more information, see Oracle Fusion Applications Release Notes, 11g Release 1, Update 1 (11.1.2.0.0) Document 1382781.1.
5.2.3 Download the RUP Repository
The RUP repository contains RUP Installer and Oracle Fusion Middleware patches that are required to install a RUP in an existing Oracle Fusion Applications environment. You download the repository from the Oracle Fusion Applications Product Media Package to a location of your choice. This directory is referred to as
REPOSITORY_LOCATION
.5.2.3.1 Obtaining the Software
Oracle groups its software releases by product area. A Product Media Pack refers to those groupings. Each media pack may also include a zipped file containing electronic documentation files or 'Quick Install' files, which facilitate the initial installation of the software.
Once you have completed the software licensing agreements, you can obtain the Oracle Fusion Applications software using one of these two methods:
- Oracle Software Delivery Cloud Portal: Provides you with a readme document that helps you to determine which media you need to fulfill the license you have purchased. You download only the media you need. This is the default delivery method.
- Oracle Store: Provides a complete set of the software in DVD format. You use only the DVDs covered by your software licensing agreement.
Using either method, you can obtain the Oracle Fusion Applications RUP repository and gain access to the Oracle Fusion Applications documentation library.
5.2.3.2 Downloading from the Oracle Software Delivery Cloud Portal
Go to http://edelivery.oracle.com/ and follow these instructions:
- Complete the Export Validation process by entering basic identification information using the online form.
- On the Media Pack Search page, specify the product pack and platform to identify the media pack you want to download. If you do not know the name of the product pack, you can search for it using the license list.
- Choose the appropriate media pack from the search results and download the Release Update Patch repository (in zipped format). You can download the repository to a location of your choice.
- Extract the contents of all zipped files to the same target directory. The directory must be on a networked drive or shared disk so that it will be accessible to all the hosts in your new environment. The installers are normally located in the
installers
subdirectory underREPOSITORY_LOCATION
.
Note:
You should avoid creating the repository in a deeply nested directory on Windows. The Windows PATH variable has a limited size, and long directory names may cause it to overflow. For example,
c:workmy_repository
is a better choice than c:WorkWorkInProgressFusionAppsFusionAppsv1Nov2011tempfilesmy_repository
.5.2.3.3 Release Update Patch Installers
Table 5-2 lists the installers in the RUP repository.
Table 5-2 RUP Installers
Media Label Name | Staging Destination |
---|---|
RUP Installer | (Unix) REPOSITORY_LOCATION /installers/fusionapps/Disk1/runInstaller (Windows) REPOSITORY_LOCATION installersfusionappsDisk1setup.exe |
5.2.4 Configure Oracle Metadata Services (MDS)
Confirm that DBMS_STATS has recently been run on the MDS schema in the Oracle Fusion Applications database. This step optimizes the performance of starting servers. For more information, see 'Collecting Optimizer Statistics' in the Oracle Fusion Applications Administrator's Guide.
Then follow the steps in 'Configuring Oracle Metadata Services' in the Oracle Fusion Applications Post-Installation Guide.
5.2.5 Verify Your OPatch Version
Follow this step only if you have updated OPatch in the FA_ORACLE_HOME outside of what Oracle Provisioning and RUP Installer installs.
Oracle Fusion Applications is compatible with a specific version of OPatch instead of the generic version of OPatch. If an incompatible version of OPatch exists in FA_ORACLE_HOME, errors can occur while applying patches and running RUP Installer. The compatible version of OPatch is available on My Oracle Support under patch 14044793.
If the file,
FA_ORACLE_HOME/
OPatch/ocm/lib/emocmclnt.jar
exists, then you have an incompatible version of OPatch, and you must contact Oracle Support to fix this issue. On Windows, look for FA_ORACLE_HOME
OPatchocmlibemocmclnt.jar.
5.2.6 Confirm Memory Settings
Confirm that memory requirements are met on the primordial host that the RUP installer is launched from. The primordial host is where the Administration Server for the Common Domain runs.
RUP Installer requires at least 6GB of free RAM on the 64-bit domains to be up during the installation. RUP installer also requires at least 6GB of free RAM on the 64-bit primordial host that the installer is launched from, for the duration of the RUP installation. This 6GB of free memory requirement is in addition to the memory requirement for all servers, including the Administration Servers on the primordial host that is already up and running. Oracle also recommends at least 1GB of additional free memory on the primordial host during the RUP installation as a safety net.
For example, if the BI domain is provisioned on the primordial host, then RUP Installer requires this 64-bit primordial host to have a minimum of 12GB of RAM. If you have two 64-bit hosts with the BI domain provisioned on a different host from the primordial host, then one host runs the Administration Server and the BI servers, while the other host runs RUP Installer, which requires a connection to the Administration Server that is running. If you run RUP installer and the Administration Server on the same primordial host with insufficient memory, then the Administration Server and Managed Servers may fail.
5.2.7 Confirm Host Name (Unix)
For Unix platforms, confirm that the host names are correctly formatted in the
/etc/hosts
file, and that this file contains entries for all hosts used by Oracle Fusion Applications to ensure that all hosts are visible from the primordial host. The /etc/hosts
file is a network configuration file that associates IP addresses with host names and host alias names, if used. Every hosts file in Unix platforms should have an entry for the IP address 127.0.0.1
, with the name localhost
following it.For more information, see 'Edit Host Names (Linux)' in the Oracle Fusion Applications Installation Guide.
5.2.8 Add -d64 Option to JRE_MEMORY_OPTIONS (Solaris X64 and Solaris Sparc)
Add the
-d64
option to JRE_MEMORY_OPTIONS
in the following file:APPLICATIONS_BASE/
fusionapps/applications/oui/oraparam.ini
Adding this option prevents OPatch from failing with this error:
5.2.9 Confirm the Local Port Range Value
Check the local port range value in
/proc/sys/net/ipv4/ip_local_port_range
before starting the installation. The recommended value is 32768 61000
. If the range is set to any value below 32768
, a system process could potentially use a port that was assigned to one of the Managed Servers. Since RUP Installer requires all domains to be down, those ports are available for the system to use.To set the correct local port range, log in as the root user and run the following command:
5.2.10 Confirm Database Settings
Perform the following steps to confirm that your database settings are optimized for the installation:
- Refer to Oracle Fusion Applications release notes for information about database tuning parameters, to avoid time out conditions during the installation.
- Confirm that the open file limit is set properly.RUP Installer uses multiple workers for uploading database content. The number of workers used dictates the open file limit setting for the machine where you run the RUP Installer. To understand how the number of workers are calculated and the requirement for the open file limit setting for the workers, see Section 3.1.2, 'Patching Database Artifacts'. For more information, see 'Increase the Open Files Limit' in the Oracle Fusion Applications Installation Guide
- Confirm that the SQL*Net Timeout Configuration is set properly.The exact setting in your environment depends on your network configuration and machine resources. Refer to 'SQLNET.EXPIRE_TIME Parameter' and 'INBOUND_CONNECT_TIMEOUT Parameter' in the Oracle Fusion Applications Performance and Tuning Guide to determine the parameters that need to be set.
5.2.11 Confirm All Oracle Homes Are Registered in the Central Inventory
Oracle Provisioning records information about the following Oracle homes separately from information about other products: Oracle Business Intelligence (Oracle BI), Oracle Global Order Promising (GOP), Web Tier, and Web Tier Common Oracle home installation information. RUP Installer expects information about all products to be recorded in the same place. To transfer information about the Oracle BI, GOP, and Web Tier installations to the same location as information about other products, perform the following steps. For more information about home directories, see 'Provisioned Oracle Fusion Applications Home Directories' in the Oracle Fusion Applications Administrator's Guide.
- Verify that the default Inventory Pointer file points to the central inventory on the primordial host on which RUP Installer runs. The default Inventory Pointer is in the following locations:
- Unix: /etc/oraInst.loc
- Solaris:
/var/opt/oracle/oraInst.loc
- Windows: located in the registry key,
HKEY_LOCAL_MACHINESoftwareOracleinst_loc
- Run
attachHome
from the BI Oracle home, for example,APPLICATIONS_BASE
/fusionapps/bi
. - Run
attachHome
from the GOP Oracle home, for example,APPLICATIONS_BASE
/fusionapps/gop
. - Run
attachHome
from the Web Tier Oracle home, for example,APPLICATIONS_BASE
/webtier_mwhome/webtier
. - Run
attachHome
from the Web Tier Common Oracle home, for example,APPLICATIONS_BASE
/webtier_mwhome/oracle_common
. - Run
attachHome
from the Oracle Common Oracle home. - Register the dependency between the BI Oracle home and Oracle Common Oracle home.Run Oracle Universal Installer with the
-updateHomeDeps
option and pass a dependency list. The syntax for the dependency list is:Example for Business Intelligence: - Register the dependency between Web Tier Oracle home and Web Tier Common Oracle home.
- Verify that the central inventory now contains the correct GOP, BI, and Web Tier information. Open the
inventory.xml
file from theContentsXML
subdirectory in your central inventory directory using a text editor. You can find your central inventory directory by looking in the default Oracle Inventory pointer file mentioned in Step 1. Verify that there are entries for GOP and for BI, and that the BI entry lists the Oracle Common dependency you specified in Step 6. Do the same for Web Tier information. Ensure that you do not modifyinventory.xml
in any way, as this may corrupt your system.Example entries in inventory.xml:Note:Rerunning theATTACH_HOME
command does not cause any issues.
5.2.12 Update Oracle Fusion Middleware Schema Credentials
Run the
preRupSeeding.py
script to perform updates to seed several Oracle Fusion Middleware schema credentials for the schema upgrade. This script updates the rup2-preupg-parameters.property
properties file.- Unzip the script and properties file.The script and properties file are located in the
companionCD.zip
, located underREPOSITORY_LOCATION/
installers/companionCD.zip
. These two files must be unzipped toAPPLICATIONS_BASE/
fusionapps/applications/
admin/preupg
, as shown in the following command. - Enable write permission on the
rup2-preupg-parameters.property
file. - Ensure that the Administration Server on the Common Domain and a WLS server are running, and run the following command.This script connects to the Administration Server and prompts you for the following values. You can press Enter to accept default values. Note that you must accept the default values for the Oracle Access Manager domain name and Oracle Access Manager authorization parameters.
- WLST credentials, including the user name, password and server URL for the CommonDomain Administration server.
- Oracle Fusion Applications database credentials, including the Oracle Database host name, port number, and sid or service. These values can be found in the
DB_CONNECT_STRING
row ofFA_ORACLE_HOME
/adminFUSION_env.properties
. - SYSDBA user name and password.
- Various schema credentials including:
- CRM_FUSION_MDS_SOA Schema Owner
- CRM_FUSION_SOAINFRA Schema Owner
- FIN_FUSION_MDS_SOA Schema Owner
- FIN_FUSION_SOAINFRA Schema Owner
- FUSION_ACTIVITIES Schema Owner
- FUSION_APM Schema Owner
- FUSION_BIPLATFORM Schema Owner
- FUSION_OCSERVER11G Schema Owner
- FUSION_ORA_ESS Schema Owner
- FUSION_WEBCENTER Schema Owner
- HCM_FUSION_MDS_SOA Schema Owner
- HCM_FUSION_SOAINFRA Schema Owner
- OIC_FUSION_MDS_SOA Schema Owner
- OIC_FUSION_SOAINFRA Schema Owner
- PRC_FUSION_MDS_SOA Schema Owner
- PRC_FUSION_SOAINFRA Schema Owner
- PRJ_FUSION_MDS_SOA Schema Owner
- PRJ_FUSION_SOAINFRA Schema Owner
- SCM_FUSION_MDS_SOA Schema Owner
- SCM_FUSION_SOAINFRA Schema Owner
- SEARCHSYS Schema Owner
- SETUP_FUSION_SOAINFRA Schema Owner
- Oracle Access Manager Administrator user name and password.
- Oracle Access Manager Resource Webgate Administrator user name and password.
- Oracle Access Manager Administration Server host name.
- Oracle Access Manager Administration Server port number.
- Oracle Access Manager administrator user name.
- Oracle Access Manager mode, valid values are open, simple, and cert. There is no default value. Your OAM administrator should know this value.
- Oracle Access Manager domain name, you must accept the default value of
OraFusionApp
. - Oracle Access Manager primary server name, the default value is
oam_server1
. - Oracle Access Manager version number, the default value is
11
. - Oracle Access Manager authorization scheme, you must accept the default value of
FAAuthScheme
. - Presence of a load balancer, valid values are true and false. The default value is false.
- Oracle HTTP Server host name.
5.2.13 Maintain Versions of Customized BI Publisher Reports
Ensure that you have your own versions of any customized BI Publisher reports. If a RUP includes an update to a catalog object that was delivered with an Oracle Fusion application, the patch will overwrite any customizations applied to the original report. For more information, see 'Before You Begin Customizing Reports' in the Oracle Fusion Applications Extensibility Guide.
5.2.14 Confirm That JDeveloper Customizations Can Be Merged
If you performed JDeveloper customizations to a SOA composite and then you deployed the composite to the SOA runtime, you must perform manual steps to merge your customizations. To ensure that your customizations can be merged successfully, review the recommendations in 'Merging Runtime Customizations from a Previously Deployed Revision into a New Revision' in the Oracle Fusion Applications Extensibility Guide before you start RUP Installer.
You will merge your customizations during the RUP Installation, after the Online Verification configuration task fails. For more information, see Section 5.5.18, 'Merging SOA Composite JDeveloper Customizations While Installing a RUP'.
5.2.15 Verify Credentials in Oracle Directory Services Manager (ODSM)
Verify that the following credentials are present in ODSM by performing the following steps:
- Log in to Oracle Internet Directory using ODSM:
http://
ldap_host:
port/odsm
, for example,http://
IDM_HOST
:7005/odsm.
(Note that you cannot do this usingjexplorer
.) - Connect to a directory. Use the OID-OID connection, for example, where the User name is
cn=orcladmin
and the Password ispassword
. - Go to the Data Browser tab. Go to
cn=oracle
internet directory and within thecn=oracle
internet directory, go tocn=DirectoryAdminGroup
. - Verify that this user entry is present in the Members section:
- If the entry is not present, click the add [+] button in the Members section and add the entry. Then apply the changes.
5.2.16 Verify the Default Realm Name is myrealm
RUP Installer expects the default realm name to be
myrealm
for the Common Domain. Verify that you have not changed this value to any other name, because changing the name to anything other than myrealm
causes RUP Installer to fail. Log in to the WLS Console for the Common Domain and click Security Realms on the domain structure pane. A list of realms displays, where you can verify that there is an entry for myrealm
and that it is the default realm.5.2.17 Save WebLogic Configuration Changes
RUP Installer makes WebLogic configuration changes using WebLogic Scripting Tool (WLST), which may overwrite any unsaved changes. Ensure that any pending WebLogic configuration changes are either activated or discarded. For more information, see 'Configuring Existing WebLogic Domains' in Oracle Fusion Middleware Oracle WebLogic Scripting Tool.
5.3 Prepare to Install a RUP - During Downtime
This section describes the following preparation steps for installing a RUP, all of which must be performed during your system down time.
5.3.1 Upgrade Identity Management Domain to the RUP2 Level
Perform the following steps to upgrade your Identity Management environment to the RUP2 level.
- Stop all servers and processes in the Oracle Fusion Applications domain, except the OPSS Security Store and the database, before starting the Identity Management upgrade. If you want to use the
fastartstop
utility to do this, see 'Starting and Stopping the Oracle Fusion Applications Middle Tier Using the fastartstop Utility' in the Oracle Fusion Applications System Administrator's Guide. Also confirm that the BI presentation servers are shut down. - Fallout 4 1.10.98 torrent. Shut down the Oracle Enterprise Scheduler Service (ESS) server by performing the following steps:
- Stop the ESS request processor and dispatcher to prevent new requests from being processed. For more information, see 'Starting and Stopping Oracle Enterprise Scheduler Service Components' in the Oracle Fusion Applications Administrator's Guide.
- Cancel any in-progress requests. For more information, see 'Cancelling Oracle Enterprise Scheduling Server Job Requests' in the Oracle Fusion Middleware Administrator's Guide for Oracle Enterprise Scheduling Service.
- Shutdown the ESS WebLogic Server Managed server. For more information, see the 'Starting and Stopping' table, specifically the 'Managed Server for an application' row, in the Oracle Fusion Applications Administrator's Guide.
- Refer to Document ID 1435333.1 on My Oracle Support and follow the remaining mandatory Identity Management upgrade steps.
5.3.2 Apply Mandatory Prerequisite Patches
Perform the following steps to apply mandatory prerequisite patches before installing the RUP.
- After you complete the Identity Management upgrade, confirm that all servers and processes in the Oracle Fusion Applications domain, except the OPSS Security Store and the database, are down before applying the prerequisite patches. If you want to use the
fastartstop
utility to do this, see 'Starting and Stopping the Oracle Fusion Applications Middle Tier Using the fastartstop Utility' in the Oracle Fusion Applications System Administrator's Guide. Also confirm that the BI presentation servers are shut down. For Windows, see Section 5.3.2.1, 'Stop Services on Windows Before Applying Mandatory Patches'. - Apply mandatory Oracle Database patches mentioned in the 'Oracle Database' section of Oracle Fusion Applications release notes.
- Apply any additional prerequisite patches mentioned in the 'Oracle Fusion Middleware' section of Oracle Fusion Applications release notes.
- Apply all prerequisite patches mentioned in the 'Applying Patches' section of Oracle Fusion Applications release notes.
- If you have Oracle Business Intelligence Applications installed and configured, refer to Oracle Fusion Applications release notes for information about mandatory patches that need to be applied before installing the RUP. For additional information about patching Oracle Business Intelligence Applications, see 'Oracle BI Applications Patching' in the Oracle Fusion Middleware Reference Guide for Oracle Business Intelligence Applications.
- If additional ODI components, such as ODI SDK or ODI Studio are installed, you must run ODI Installer in UI mode to upgrade ODI to 11.1.1.6.0 before running RUP Installer. To determine if these additional ODI components are installed you can either use OPatch or you can look at the directories included under the ODI_HOME.To use OPatch, run
ODI_HOME
OPatchopatch lsinventory
to get a list of installed products.Alternatively, you can look for the following directories underODI_HOME
:ODI_HOME
oraclediclient
will be present if ODI Studio was installedODI_HOME
oracledi.sdk
will be present if ODI SDK was installed
Note:You must follow the steps described in 'Starting the Installer' and 'Following the Installation Instructions for the 'Developer' Installations' in the Oracle Fusion Middleware Installation Guide for Oracle Data Integrator. You must install and upgrade your ODI Studio in an Oracle home other than Oracle Fusion Middleware Oracle homes and Oracle Fusion Applications Oracle home.
5.3.2.1 Stop Services on Windows Before Applying Mandatory Patches
For a Windows platform, the following services must be stopped:
- OracleOraDb11g_home1TNSListenerLISTENER_<SID>
- OracleOraDb11g_home1ClrAgent
- OracleDBConsole<SID>
- OracleJobScheduler<SID>
- OracleService<SID>
- OracleMTSRecoveryService
- Windows Management Instrumentation
- Distributed Transaction Coordinator
- Oracle <SID> VSS Writer Service
From the Control Panel, select Administrative Tools, then Services. Right click on each service and choose the Stop option.
5.3.3 Verify the Status of Servers and Processes
This section contains steps to follow for all platforms. For Windows platforms, also follow the steps in Section 5.3.3.10, 'Steps for Windows Platforms'.
To prevent locks on patched objects and other data issues during patching of database artifacts, review and perform the following checklist before installing the RUP.
5.3.3.1 Stop Running SES Schedules
Perform the following steps related to Oracle Secure Enterprise Search (SES).
- Stop all running schedules.Get a list of running schedules by running the following command. The schedules with a status of EXECUTING are the running schedules.Stop a running schedule by running the following command:Note:To get a list of all schedules defined in Oracle SES, execute the following command:
- Deactivate the schedules that may start running during the RUP installation.The schedules that may start running during the RUP installation, such as daily schedules, must be deactivated. Execute the following command to deactivate such schedules:
- Stop the Index Optimizer.Run the following command to stop the Index Optimizer:
- Deactivate the Index Optimizer if it may start running during the RUP installation.If the time at which the Index Optimizer is scheduled to run overlaps with the time period of the RUP installation, then the Index Optimizer must be deactivated before starting the RUP installation. Run the following command to deactivate the Index Optimizer:
5.3.3.2 Stop the Node Manager and the OPMN Control Process
Stop the Node Manager and the OPMN control process. All OHS and Web Tier processes, including the Apache processes, must also be stopped if you are not running OHS from a separate installation (DMZ or otherwise). (On Windows, stop the Node Manager and OPMN services and follow steps 1 and 2 in Section 5.3.3.10, 'Steps for Windows Platforms'.) Note that you must start the Node Manager for all domains and the OPMN control process during the Verifying Node Manager and OPMN Status configuration task, before proceeding to the next step in the RUP installation.
For more information, see 'Stopping Node Manager' in Oracle Fusion Middleware Node Manager Administrator's Guide for Oracle WebLogic Server.
Use the following procedure to stop the OPMN control processes for Oracle Business Intelligence, GOP, and Web Tier (OHS). This procedure also stops all BI server processes, all GOP processes, and the OHS process.
Note:
There should be no Web Tier processes on this installation if you are running OHS from a separate installation (DMZ or otherwise). In this case, you do not need to stop the Web Tier processes.
- Set
ORACLE_INSTANCE
to the location of the target Oracle instance directory. - Go to the
bin
directory under the target Oracle instance directory. - Run the
opmnctl
program from the current directory with thestopall
command.
The following example is for Oracle Business Intelligence, where BIInstance is the location of
BIInstance
. Depending on whether Local Applications Config is enabled for your setup, BIInstance
is located under either the Applications Config directory or the Local Applications Config directory of the BI host.Example for GOP:
Example for Web Tier (OHS):
For more information about the location of
APPLICATIONS_CONFIG
, see Section 5.2.1, 'Before You Begin'.For more information about concepts related to ORACLE_HOME and ORACLE_INSTANCE, refer to the 'Understanding Oracle Fusion Middleware Concepts' chapter in the Fusion Middleware Administrator's Guide.
5.3.3.3 Start the OPSS Security Store
Start the OPSS Security Store if it is not already running. The OPSS Security Store used here is an Oracle Internet Directory LDAP server instance. Before proceeding with the RUP installation, the designated Oracle Internet Directory server instance must be up and running. If this server is not running prior to starting the installation, the related configuration tasks will fail. For more information, see Section 5.5.11, 'LdapServerCheck Failure'.
For more information about starting, see 'Starting and Stopping Oracle Internet Directory' in the Oracle Fusion Middleware Enterprise Deployment Guide for Oracle Identity Management (Oracle Fusion Applications Edition).
5.3.3.4 Confirm the First Node is Running in a RAC Database
If you are running on a RAC database, ensure that the first node (host and port) in the TNS descriptor is up and running prior to running RUP Installer. If this is not running, the Upgrading Middleware Schemas configuration task will fail.
5.3.3.5 Start Servers That Were Added After Provisioning
If you added any servers, you must start the new servers at least once before you run RUP Installer. This step is not required for a server that has previously been started at least once since you initially installed Oracle Fusion Applications.
5.3.3.6 Confirm the Database is Running and in Idle State
Confirm there are no active jobs or processes running against the database. If you stop all servers, including ESS servers, most Oracle Fusion Applications processes are shut down. However, some database jobs could still be running or scheduled to start. These processes must be stopped so that they do not start while patching is in progress. Stop all background jobs, including jobs in the database and active processes.
To confirm if the database is running in idle mode, you can follow the steps below:
- Start SQL*Plus and connect as the SYS user and run the following SQL*Plus queries.
- To retrieve a list of active SQL processes:
- To retrieve a list of scheduler jobs that are currently running:
- To retrieve a list of scheduled jobs for the next 24 hours:
If all the queries return no rows, that indicates the database is in Idle mode for the next 24 hours and you can safely proceed with the upgrade.
5.3.3.7 Confirm All Oracle Fusion Applications Patch Manager Processes Are Complete
From your operating system, check for processes that are running
fapmgr, javaworker, adpatch, adadmin
, and adworker
. If an fapmgr
session was interrupted, you may need to forcefail
and abandon the session as follows:- Use the
fapmgr forcefail
command to update the patching tables.If the forcefail command returns 'There are no active Oracle Fusion Applications Patch Manager sessions which can be forcibly failed', then skip the next step. - Use the
fapmgr
abort
command to abandon the session, only if a session is active.
5.3.3.8 Confirm All Oracle Fusion Applications AutoPatch Processes are Complete
If an Oracle Fusion Applications AutoPatch session is running, you must abandon the session as follows.
Run the following command from
ATGPF_ORACLE_HOME:
(This is the directory under MW_HOME that contains the Applications Core code. For more information, see Section 7.1.2, 'Running Oracle Fusion Applications AutoPatch'.)The TWO_TASK value can be obtained from the
ATGPF_env.properties
file.The LOCAL value can be obtained from the
FUSION_env.properties
file.5.3.3.9 Confirm All AD Administration Sessions Are Complete
If an AD Administration session is running, you must abandon the session as follows:
- From
FA_ORACLE_HOME:
The TWO_TASK and LOCAL values can be obtained from theFUSION
_env.properties
file. - From
ATGPF_ORACLE_HOME
The TWO_TASK and LOCAL values can be obtained from theATGPF_env.properties
file.
5.3.3.10 Steps for Windows Platforms
Follow these steps before you install a RUP on a Windows platform.
- Change the service type from Automatic to Manual for the following services: Node Manager, Web Tier, GOP, and BI. Restore the service type back to Automatic after RUP installation completes.
- Stop the following services: Node Manager, Web Tier, GOP, and BI.
- Reboot the Oracle Fusion Applications host.
- Release Java Archive File Handles on System Process ID (PID) 4On the Windows WebLogic Server, the Node Manager runs as a service. Since, the
APPLICATIONS_BASE
of Oracle Fusion Applications is in a symbolic folder, some of the jar file handles are loaded by Microsoft Windows System Process ID (PID) 4. The loaded file handles eventually cause Middleware patch application to fail when running the RUP Installer. Before starting the RUP Installer, make sure the Windows System Process ID (PID) 4 does not have handles to Oracle Fusion Applications jar files.Check for file handles using the Windows utility Process Explorer. If file handles exist, make sure the Node Manager service is not running. If the file handles remain even after shutting down the Node Manager service, switch the Node Manager service from Automatic to Manual and reboot the machine to release the file handles. - Ensure that the
Server
service is up and running. - Increase the s
hared_pool_size
in theinit.ora
file. If it seems large enough then improve segmentation in the shared pool by reserving part of the shared pool for large objects using theSHARED_POOL_RESERVED_SIZE
parameter. The recommended value to start tuning is one third of the shared pool size. You can allow for large objects by using theSHARED_POOL_RESERVED_MIN_ALLOC
parameter.
5.3.4 Perform Required Backups
The following backups must be performed before you install a RUP:
5.3.4.1 Back Up Oracle Fusion Applications
Back up your entire Oracle Fusion Applications environment by following the steps in 'Backing Up and Recovering Oracle Fusion Applications' in the Oracle Fusion Applications Administrator's Guide. For additional back up steps that are specific to Windows, refer to Section 5.3.4.5, 'Back Up Steps for Windows Platforms'. You should also back up your central inventory.
5.3.4.2 Back Up the OPSS Security Store
RUP Installer upgrades all WLS domains to the 11gR1 PS5 MLR1 (11.1.1.6.1) level so you must perform the following backups. Make sure you perform your backups in directories that you can restore from. You can use any directory to back up the data, as long as you know where to restore the backup from.
- OPSS Security StoreBack up all data under the root node of the OPSS Security Store. To identify the root node in the Oracle Internet Directory hosting the OPSS Security store, use Fusion Applications Control and look at the Root Node Details pane under the Security Provider information. For more information, see 'Reassociating with Fusion Middleware Control' in the Oracle Fusion Middleware Application Security Guide.In case of an upgrade failure, restore this node entirely. The
ldifwrite
andbulkload
operations that follow must be performed on the system where the Oracle Internet Directory hosting the OPSS Security store resides.- Set the following environment variables.Example:
- Follow this step to create the backup.In the system where the Oracle Internet Directory is located, produce an LDIF file by running
ldifwrite
as illustrated in the following line:Example:This command writes all entries under the nodecn=FAPolicies
to the filesrcOid.ldif
. Once generated, move this file to the directory that was identified earlier, to hold all backup data. - Follow these steps to restore the backup.
- In the Oracle Internet Directory system, verify that there are no schema errors or bad entries by running
bulkload
as illustrated in the following line:If duplicate DNs (common entries between the source and destination directories) are detected, review them to prevent unexpected results. - Load data into the Oracle Internet Directory by running
bulkload
as illustrated in the following line:
For more information about thebulkload
command, see 'Performing Bulk Operations' in the Oracle Fusion Middleware Administrator's Guide for Oracle Internet Directory.For more information about migrating Oracle Internet Directory, see 'Migrating Large Volume Policy and Credential Stores' in the Oracle Fusion Middleware Application Security Guide. - Bootstrap WalletBack up the
cwallet.sso file
in theDOMAIN_HOME/
config/fmwconfig/bootstrap
directory for each WLS domain in an Oracle Fusion Applications installation. You must take backups of eachcwallet.sso
file for each domain and when you restore, you must be careful to restore the correct file. For example, if you back upcwallet.sso
from the Common Domain, then you must restore it in the Common Domain upon failure. If you back upcwallet.sso
from the BI domain, you must restore it in the BI Domain upon failure.
5.3.4.3 Back Up Applications and System Policies
Back up applications and system policies for each stripe supported by Oracle Fusion Applications. System policies are global and not by stripe. Applications policies are stored by stripe and must be backed up and restored by stripe. If you do not back up the policies by stripe, you cannot restore the policies from your backup. Oracle Fusion Applications supports the following stripes:
fscm_system-jazn-data.xml
: FSCM stripecrm_system-jazn-data.xml
: CRM stripehcm_system-jazn-data.xml
: HCM stripebip_jazn-data.xml
: OBI stripe
The following steps explain how to back up the system policies and the four application stripes from an Oracle Internet Directory (OID) OPSS security store to individual XML files. These steps must be performed on the Common Domain.
- Copy the existing
jps-config-jse.xm
l file (that has configured thepolicystore.ldap
service) to a new file,myFile-migrate-jps-config.xml.
This is thejps-config-jse.xm
l file that is referenced in theFUSION_env.properties
file. - Open
myFile-migrate-jps-config.xml
for editing and add the followingjpsContexts
: - Add the following service instances to
myFile-migrate-jps-config.xml
. You must create abackup_directory
to hold the exported policy XML files before following this step. - Remove or comment out the entry
<serviceInstanceRef ref='idstore.ldap'/>
which exists in<jpsContext name=
'default'>
..</jpsContext>
. - Create five XML files,
fscm-policies.xml, crm-policies.xml, hcm-policies.xml, obi-policies.xml
(one for each application stripe), andglobal-policies.xml
(for system policies), each containing the following framework: - Use the migrateSecurityStore OPSS WLST command to backup each application stripe:Where:
jpsConfigFileLocation
is the location of the file,myFile-migrate-jps-config.xml
.srcAppName
is the stripe being backed up, such asfscm
.dstJpsContext
is the name of the context that refers to the XML store, such as,MyDestinationContextFscm
. - Use the OPSS WLST command
migrateSecurityStore
to backup system policies. Run the following command fromORACLE_COMMON_HOME
, which is defined in theFUSION_env.properties
file:Where:jpsConfigFileLocation
is the location of the filemyFile-migrate-jps-config.xml
.srcJpsContext
is the name of the context that refers to the OID security store, such as, MySourceContext.dstJpsContext
is the name of the context that refers to the XML policy store, such as MyDestinationContextGlobal.
For more information, see 'Migrating with the Script migrateSecurityStore' in the Oracle Fusion Middleware Application Security Guide.
5.3.4.4 Back Up Oracle Business Intelligence RPD Customizations
If you made customizations to the content of the Oracle Business Intelligence Repository (Oracle BI RPD), perform the following steps:
- Ensure that you have a backup of the original version of the Oracle Fusion Applications 11g Oracle BI RPD. If you do not have a backup created before making customizations, then use a version of the RPD in the following instance directory after provisioning:
- Back up your existing customized version of the Oracle Fusion Applications 11g Oracle BI RPD by copying the file from your runtime location to a safe place of your choosing for later use. To find out what the current, custom Oracle BI RPD file is called, use Oracle Fusion Middleware Control and locate the file in the following directory:
For information about how to resolve conflicts related to your customizations after RUP installation, see Section 5.5.20, 'Failure During Applying BI Metadata Updates'.
5.3.4.5 Back Up Steps for Windows Platforms
Back up the Oracle Fusion Applications environment, including
APPLICATIONS_BASE
, inventory, registry entries, Oracle Identity Management, the database and the System environment PATH variable of the Oracle Fusion Applications host machine.APPLICATIONS_BASE
has many files whose path is more than 256 characters. The Microsoft Windows Copy function is limited to copying only those files with a path of less than 256 characters. Therefore, many files fail to copy.Use Robust File Copy (Robocopy), which is available as part of the Windows Resource Kit, to copy the APPLICATIONS_BASE. Use the following command:Sample output from therobocopy
command:Total Copied Skipped Mismatch FAILED Extras Dirs:112640112640000Files:787114787114000Bytes:63.822 g63.822 g000Times:2:22:202:19:000:00:000:03:19- Back up the inventory.Back up the inventory location referenced in the registry
HKEY_LOCAL_MACHINESOFTWAREORACLEinst_loc
. - Back up the registry.Use
Regedit.exe
to back up the following registries related to Oracle Fusion Applications.- HKEY_LOCAL_MACHINESystemCurrentControlSetServices
- Web Tier service
- BI Service
- Node Manager service
- HKEY_LOCAL_MACHINESOFTWAREORACLE
- HKEY_LOCAL_MACHINESOFTWAREWow6432NodeOblix
- Ensure that the System PATH has the following values:Add any of the previous values that are missing to the system PATH. Missing values cause failures in launching the Oracle Process Manager and Notification Server (OPMN) services and Oracle Business Intelligence Presentation Services Web Catalog (Webcat) deployment tasks in RUP Installer.
- Save the system PATH variable.
5.4 Install a RUP
RUP Installer must run during down time. Oracle recommends that you run RUP Installer from a machine that is co-located in the same subnetwork as the database server to maximize performance. You must run RUP Installer from the primordial host.
This section contains the steps to install a RUP with RUP Installer. It contains the following topics:
5.4.1 Perform the Installation
Ensure that the steps in Section 5.2, 'Prepare to Install a RUP - Pre-Down Time' and Section 5.3, 'Prepare to Install a RUP - During Downtime' are successfully completed before installing the RUP.
Note:
If you encounter errors during the RUP installation, refer to Section 5.5, 'Troubleshoot RUP Installer Sessions' before clicking any buttons in the RUP Installer User Interface.
5.4.1.1 Start RUP Installer
Start RUP Installer from the command line, using specific options to further define the necessary actions. You must run RUP Installer from the primordial host.
- Set the
JAVA_HOME
environment variable as follows: - Confirm the registration of the network location of FA_ORACLE_HOME.If the Oracle Fusion Applications Oracle home directory (FA_ORACLE_HOME), which is
APPLICATIONS_BASE/
fusionapps/applications
, is registered in the central inventory with a/net
path, then provide theoraInst.loc
location including/net
when starting RUP Installer. An example follows:If not triggered with/net
path, RUP Installer copies the-invPtrLoc
file to FA_ORACLE_HOME. In the example, this results in a copy of the file to itself, which results in a zero byte file. This causes failure during the copy phase whenoracle_common
patches are applied. For more information, see Section 5.5.2.3, 'Inventory Pointer File is Empty'. - Start RUP Installer.
Table 5-3 shows valid options that can be used when running RUP Installer.
Table 5-3 RUP Installer command options
Argument | Description | Mandatory |
---|---|---|
-jreLoc | Path where the Java Runtime Environment is installed. This option does not support relative paths, so you must specify the absolute path. | Yes. |
-invPtrLoc | The location of an overriding inventory pointer file. If Oracle Fusion Applications Oracle home directory (FA_ORACLE_HOME), located under the APPLICATIONS_BASE/fusionapps directory, is registered in inventory with a /net path, then provide the oraInst.loc including /net in the path. | Recommended, use to override the default location of the inventory pointer file, located in /etc/oraInst.loc. This option can be used only on Unix platforms. |
-J-Dworkers ( -Dworkers for Windows) | The number of workers to use for uploading database content. If you provide a value for the number of workers that is outside the calculated range, you are prompted to provide a value that is within the optimal range. If you do not use this option, a calculated optimal value is used. | No, overrides the default number of workers calculated by RUP Installer. See 'Worker Calculation' in Section 3.1.2, 'Patching Database Artifacts'. |
-J-DlogLevel ( -DlogLevel for Windows) | Records messages in the log file at the level you specify. Enter a value to override the default log level of INFO . See Section 11.1, 'Oracle Fusion Applications Patch Manager Logging'. | No, default value is INFO . |
-debug | Retrieves the debug information from RUP Installer. | No. |
Example:
Example when
FA_ORACLE_HOME
is registered with a /net
path:5.4.1.2 Run RUP Installer
Table 5-4 illustrates the tasks that RUP installer runs. For information about troubleshooting RUP Installer sessions, see Section 5.5, 'Troubleshoot RUP Installer Sessions'. For information about log files generated during RUP installation, see Section 5.5.1, 'RUP Installer Log File Directories'.
Table 5-4 RUP Installer Screen Sequence
Screen | Description and Action Required |
---|---|
Welcome | Appears when you start RUP Installer. This screen does not appear if you restart RUP Installer after a failure. The standard Welcome screen is read-only. It contains a navigation pane on the left-hand side that summarizes the tasks the installer will take. Each item in the pane represents an installer screen, which contains prompts for the necessary information. Click Next to continue. |
Installation Location | Specify the location of the existing Oracle Fusion Applications home ( FA_ORACLE_HOME) where you want to install the RUP.Click Next to continue. |
Installation Summary | Summarizes the selections you made during this installation session. It includes the Oracle home, required and available disk space, and the version of the RUP to be installed. Review the information displayed to ensure that the installation details are what you intend. To make changes before installing, click Back to return to previous screens in the interview. Click Install to accept this configuration and start the installation. |
Installation Progress | Displays a progress indicator that shows the percentage of the installation that is complete and indicates the location of the installation log file. The installation task consists of copying files from the RUP to the appropriate Oracle homes. The configuration process starts when the installation progress indicator shows 100 percent. Click Next to continue. |
Policy Store Analysis (Note that if you installed a Language Pack and chose to override the base English strings in the policy store, then this screen no longer displays during RUP installation.) | Analysis is available for the following policy store stripes: hcm, crm, fscm, and obi. Select the stripes to be analyzed and then click Run Analysis to identify any conflicts or deletions. Only the stripes that will be updated are enabled for analysis and the analysis could run for several minutes. After the analysis runs, review the results of the analysis to determine which deployment method RUP Installer will use for policy store changes to each stripe. Oracle recommends that you select Apply safe changes only. This is the safest method unless you have read and totally understood the consequences of the other three options. If you decide to resolve the conflicts or deletions before the actual JAZN upload from RUP Installer, you should run the Policy Store Analysis step again to get the most accurate analysis report. The choices for deployment method are:
If you choose Apply safe changes only or Append additive changes, then you must review the results of the analysis to manually upload any changes not applied by RUP Installer with the choice you selected, after the installation is complete. If you choose Apply all changes and overwrite customizations, then you may need to reapply the customizations that are overwritten after the installation is complete. If you choose one of these options, click Next after you make your selection. If you choose Manually resolve conflicts and upload changes using Authorization Policy Manager (APM), you must pause the upgrade while you bring up the APM application and upload the changes. For more information, see the 'Upgrading Oracle Fusion Applications Policies' chapter in the Oracle Fusion Middleware Oracle Authorization Policy Manager Administrator's Guide (Oracle Fusion Applications Edition). Note the location of the following files:
When you complete this task in APM, shut down the APM application, return to RUP Installer, and click Next. |
Configuration Progress | Displays a progress indicator that shows the percentage of the configuration phase that is complete. It displays each task, including steps within tasks, in the message pane as it is performed. Tasks that could be included in the configuration phase are described in Section 5.1.4, 'RUP Installer Configuration Tasks'. Before the Starting All Servers task, the Verifying Node Manager and OPMN Status configuration task checks for access to the Node Manager and the OPMN control process. This should fail because you manually shut down these processes prior to starting RUP Installer. Do not cancel and exit out of RUP Installer in response to this task. |
Configuration Progress (continued) | After this task fails, follow these steps:
No additional user action is required in the Configuration Progress screen unless a failure occurs. For more information, see Section 5.5.3, 'General Troubleshooting During the Configuration Phase'. |
Installation Complete | Summarizes the installation just completed. If you want to save this configuration to a response file, click Save. For more information, see 'How Response Files Work' in the Oracle Database Installation Guide 11g Release 2 (11.2) for Linux. To complete a successful installation, click Finish. The Finish button is activated only if all mandatory configuration tasks completed successfully. If you want to rerun this session to resolve failed configuration tasks, click Cancel. |
5.4.2 Complete the Post Installation Tasks
Perform the following required manual steps after RUP Installer completes successfully:
- Copy the generated OHS configuration
<location>
elements. If your OHS is scaled out, then the following steps must be repeated for each additional OHS server.- The generated OHS configuration snippets are under
FA_ORACLE_HOME
/admin/OHS/patched_moduleconf
. For each product family file under that directory, identify all<location>
elements. Copy and paste these elements to the corresponding file underAPPLICATIONS_BASE
/instance/CommonDomain_webtier/config/OHS/ohs1/moduleconf
.Further customization of the generated OHS configuration<location>
is needed if any of your Oracle Fusion Applications domains are scaled out. For more information, see 'Oracle HTTP Server Configuration' in the Oracle Fusion Applications Enterprise Deployment Guide. The generated OHS configuration snippet only contains one server. If there are additional servers in the cluster, you must add the additional server host and port. For example, the following example shows one server.The following example has been updated for two servers. - Stop and start the OHS server.
- Verify that the new context roots are accessible through an internet browser. The context roots in the location elements indicate that requests are rerouted to the host and port specified in the location element. The URL that can be used to verify the context root depends on the application that hosts the context root. No standard pattern can be followed.
- Follow these steps to manually deploy
sca_UpdateSOAMDS_rev1.0.jar
SOA composite to every domain:- Access the WLST shell.
- Deploy the composite using the
sca_deployComposite
WLST command to the SOA server of each domain. This composite is located underAPPLICATIONS_BASE
/fusionapps/atgpf/pcbpel/composite/sca_UpdateSOAMDS_rev1.0.jar
.Where:- serverURL is the URL of the server that hosts the SOA Infrastructure application (for example,
http://hostname:8001
). - sarLocation is the absolute path of the SAR file or the ZIP file that bundles multiple SAR files, MAR files, or both. Since the installer copies the
UpdateSOAMDS
composite toAPPLICATIONS_BASE
/fusionapps/atgpf/pcbpel/composite/
in the target system, thesarLocation
argument should be set to the absolute path of the composite at that location, as shown in the example. - overwrite specifies whether to overwrite a currently deployed SOA composite.
Example: - You must run
UpdateSOAMDS
composite if you made any flexfield changes. For more information, see 'Task: Synchronizing Customized Flexfields in the SOA MDS Repository' in the Oracle Fusion Applications Extensibility Guide.
- Update the
essbase.cfg
file by performing the following steps:- Back up
essbase.cfg
toessbase.cfg.copy.
- Shut down the agent
essbaseserver1
using the following commands: - Add the line
JAVAMAXOUTLINES 128
toessbase.cfg
.- Go to this directory to FA_MW_HOME/
localdomain/BIInstance/Essbase/essbaseserver1/bin
- Edit
essbase.cfg
to add a line that contains JAVAMAXOUTLINES 128.
- Start the agent
essbaseserver1
using the following commands:.
- Perform the following steps to move the
userpref_currencies.xml
file.- Review the following file:
- Check if the file contains the following element:
- If this element is not available, perform the following steps in this section. If this element is available, no further action is required.
- Back up the file,
APPLICATIONS_BASE/
instance/BIInstance/config/OracleBIPresentationServicesComponent/coreapplication_obips1/userpref_currencies.xml
touserpref_currencies.xml.backup
. - Copy the file,
BI_ORACLE_HOME
/bifoundation/admin/config/OracleBIPresentationServicesComponent
toBI_INSTANCE_HOME
/config/OracleBIPresentationServicesComponent/coreapplication_obips1/userpref_currencies.xml
.For example, copy from:/u01/APPTOP/fusionapps/bi/bifoundation/admin/config/OracleBIPresentationServicesComponent/userpref_currencies_OTBI.xml
to:/u01/APPTOP/instance/BIInstance/config/OracleBIPresentationServicesComponent/coreapplication_obips1/userpref_currencies.xml
.If you are using local domains, replaceAPPTOP
with the local domain directory. - Bounce the
coreapplication_obis1
server.
- Confirm that all deployments were successful by reviewing the Diagnostics report and log files. For more information, see Section 3.5.5, 'Diagnostics Report'.
- Confirm there are no unresolved errors or exceptions in the log files. For information about resolving errors, see Section 5.5, 'Troubleshoot RUP Installer Sessions'.
- Confirm that all relevant Managed Servers have a RUNNING status.
- Verify that all deployed applications are up and running. You can check this from Fusion Applications Control, or by reviewing the server side log files. For more information, see 'Starting Fusion Applications Control' in the Oracle Fusion Applications Administrator's Guide or Section 5.5.1, 'RUP Installer Log File Directories'.
- Perform the following steps to start or stop the GOP processes. Note that the
opmnctl
process forgop_1
should only be started on the host machine which contains the AdvancedPlanning Managed server. Do not start it on the primordial host.- Proceed to Step b if your GOP processes have been previously configured and have run before.If you are starting GOP processes for the first time, confirm that a datasource exists, in the form of XML files, under the
APPLICATIONS_BASE
/instance/gop_1/GOP/GlobalOrderPromisingServer1/datasource
directory. Then run theRefreshOpDatastore
ESS job. - Log in to Fusion Applications Control. For more information, see 'Starting Fusion Applications Control' in the Oracle Fusion Applications Administrator's Guide.
- Access GOP by navigating to Oracle Fusion Supply Chain Management, then Global Order Promising, then GlobalOrderPromisingServer1.
- Click GlobalOrderPromisingServer1 to open the GlobalOrderPromisingServer1 page.
- Select Control from the menu, then Start Up.
- Follow this step if you have customized BI Publisher reports.Reload custom templates for BI Publisher reports on Oracle-delivered BI Publisher reports by following the steps in 'Task: Upload the Template File to the Report Definition' in the Oracle Fusion Applications Extensibility Guide.
- Review the JAZN Analyze report for potential conflicts and deletions that are not patched automatically by RUP Installer.
FA_ORACLE_HOME
/admin/JAZN/
stripe
/delta/report.txt
The stripe is crm, fscm, hcm, or obi.Review the Modification section of the report to see the roles that RUP Installer did not update. For each conflict that displays in this report, you must evaluate and manually patch the role by using APM. For more information, see 'Upgrading Oracle Fusion Applications Policies' in the Oracle Fusion Middleware Oracle Authorization Policy Manager Administrator's Guide (Oracle Fusion Applications Edition).The following example shows a typical Application Role conflict that has been modified by both the patch and production, therefore it is not applied by RUP Installer.Note the location of the following files for reference when using APM:- Location of baseline files, where stripe is crm, fscm, hcm, or obi:
- Location of patch files for fscm, crm, and hcm stripes:
- Location of patch files for the obi stripe:
- If the RUP contains ODI artifacts, you must manually drop the work tables from the schema, FUSION_ODI_STAGE.
- Connect to the Oracle Fusion Applications database with the correct privilege.
- Drop all tables that begin with E$ from the FUSION_ODI_STAGE schema.
- Apply all mandatory post installation patches and follow any post installation steps mentioned in the 'Applying Patches' section of Oracle Fusion Applications release notes.
- Run the script
enable_partition_attr_val.sql
to improve the query and crawl performance. This step is optional.The scriptenable_partition_attr_val.sql
may take several hours to complete, depending on the number of documents that have been previously indexed, and the number of custom attributes. This script can be run ONLINE.Follow these steps to run the scriptenable_partition_attr_val.sql:
- Start SQL*Plus and connect as the
SYS
user. - Run the following script:
- Activate the schedules by running the following commands.The variables, ses_Admin_Host and ses_Admin_Port, refer to the host and port of the search_server1 Managed Server or SES clusterThe variable, ses_Admin_Password, is the
SEARCHSYS
database schema password, which is the same as the SES Admin screen.The-p
on the command line is optional. If you do not use it, you will be prompted for it. - For security, you must perform the following tasks in the IDM domain:
- Disable anonymous binds to Oracle Virtual Directory's LDAP ports
- Disable Oracle Virtual Directory ACLs
You perform both tasks at the same time by running theidmConfigTool
with the-disableOVDAccessConfig
option. Proceed as follows:- Set the environment variables
MW_HOME
,IAM_HOME,JAVA_HOME
, andORACLE_HOME
as shown in the following examples: - Stop Oracle Virtual Directory as described in 'Starting and Stopping Oracle Identity Management Components' in the Oracle Fusion Middleware Enterprise Deployment Guide for Oracle Identity Management (Oracle Fusion Applications Edition).
- Create a properties file called
disableOVDAcces.prop
, with the following contents:Where:ovd.host
is the name of the host that the Oracle Virtual Directory server runs on.ovd.port
is the Oracle Virtual Directory https port.ovd.binddn
is the name of the Oracle Virtual Directory administrative user.ovd.ssl
indicates that you are communicating with Oracle Virtual Directory using the https protocol.
- Disable Oracle Virtual Directory ACLs and anonymous binds to Oracle Virtual Directory LDAP ports using the command
idmConfigTool
which is located in theIAM_ORACLE_HOME
/idmtools/bin
directory.Note:When you run theidmConfigTool
, it creates or appends to the fileidmDomainConfig.param
. This file is generated in the same directory that theidmConfigTool
is run from. To ensure that the same file is appended to each time the tool is run, always run theidmConfigTool
from theIAM_ORACLE_HOME
/idmtools/bin
directory.For example: - Check the log file for any errors or warnings and correct them. Output is saved in a file named
automation.log
, which is created in the directory where you run the tool. - Restart Oracle Virtual Directory as described in 'Starting and Stopping Oracle Identity Management Components' in the Oracle Fusion Middleware Enterprise Deployment Guide for Oracle Identity Management (Oracle Fusion Applications Edition).
Repeat Steps a through f for each Oracle Virtual Directory instance, changing the values in the property file as necessary. - In Oracle Fusion Applications 11.1.3.0.0, Oracle moved some tables and indexes from the FUSION schema into different tablespaces. Starting with 11.1.3.0.0, those tables that are seeded with rows by Oracle reside in the FUSION_TS_SEED tablespace and those that are not seeded with rows do not reside in the FUSION_TS_SEED tablespace. This was done to leverage the Transportable Tablespace database feature.Run the following script to move these objects into new tablespaces so that the tablespace assignment of FUSION objects in your database matches those of a freshly installed RUP2 database.From the operating system, run the following command:If you have not customized the FUSION tablespaces, you must run this script as it is delivered by Oracle. If you customized the tablespaces in which the FUSION-owned objects reside, then you may edit this script before running it to match the customizations that you implemented regarding tablespace assignment for FUSION objects.Oracle recommends that you save the output of the script and review it for any errors. For example, you may run out of space in one or more tablespaces, in which case you must refer to the Oracle Database Administrators Guide, rectify the situation, and rerun the script.
- If you are deploying Oracle Business Intelligence Applications, then you must perform the post-installation or upgrade steps specified in 'Roadmap for Installing, Upgrading, and Setting Up Oracle BI Applications' in Oracle Fusion Middleware Installation and Configuration Guide for Oracle Business Intelligence Applications.
- If you have installed any languages in addition to US English, you must upgrade each installed language using Language Pack Installer. For more information, see Chapter 6, 'Maintaining Oracle Fusion Applications Languages'.
5.5 Troubleshoot RUP Installer Sessions
This section provides information to assist you in troubleshooting RUP Installer sessions. It contains the following topics:
RUP Installer calls Oracle Fusion Applications Patch Manager during the Load Database Components task. For additional information about troubleshooting Oracle Fusion Applications Patch Manager sessions, see Chapter 11, 'Monitoring and Troubleshooting Patches'.
5.5.1 RUP Installer Log File Directories
Table 5-5 contains a list of log directories for RUP Installer activities.
Table 5-5 Log Directories for RUP Installer Activities
Log directory name | Generated from.. |
---|---|
oracle_inventory /logs | Installation phase |
FA_ORACLE_HOME /admin/FUSION/log/fapatch/fapatch_11.1.3.0.0/timestamp | Top level log directory which contains the main RUP installer log file |
FA_ORACLE_HOME /admin/FUSION/log/fapatch/fapatch_11.1.3.0.0/ARCHIVE/timestamp | Top level log directory where log files are moved when you retry the RUP installation session |
FA_ORACLE_HOME /admin/FUSION/log/fapatch/fapatch_11.1.3.0.0/PatchManager_DBPatch | Database upload configuration task after failure or completion. |
FA_ORACLE_HOME /admin/FUSION/log/fapatch/fapatch_11.1.3.0.0/StartStop | StartStop utility. Note that server logs are located under respective domains. For example, the AdminServer log for CommonDomain is under APPLICATIONS_BASE/ instance/domains/ hostname/ CommonDomain/servers/AdminServer/logs . |
FA_ORACLE_HOME /admin/FUSION/log/fapatch/fapatch_11.1.3.0.0/soalogs | Processing SOA artifacts. Note that SOA server logs are located under respective domains. For example, the SOA server logs for CommonDomain are under APPLICATIONS_BASE /instance/domains /hostname /CommonDomain/servers/soa_server1/logs. For more information, see Section 5.5.19.1, 'SOA Composite Log Files'. |
During the execution of configuration tasks, log files are created under the
FA_ORACLE_HOME/
admin/FUSION/log
/fapatch/fapatch
_releasenumber
directory. During the execution of the database upload configuration task, log files are created under FA_ORACLE_HOME/
admin/FUSION/log
. Upon completion or failure of the database upload, the log files move to the FA_ORACLE_HOME/
admin/FUSION/log/
fapatch/fapatch
_releasenumber/
PatchManager_DBPatch
directory. The current releasenumber
is 11.1.3.0.0 for RUP2.5.5.2 Troubleshooting Failures During the Installation Phase
RUP Installer backs up the contents of the
FA_ORACLE_HOME/
patchsettop
directory after it completes the installation phase. The backup directory is FA_ORACLE_HOME/
patchsettop/
backup/
version/language/timestamp
. For RUP3, the directory is FA_ORACLE_HOME/
patchsettop/
backup/
11.1.3.0.0/en_US/
timestamp
. When RUP Installer restarts after a failure, it ensures that the contents in the FA_ORACLE_HOME/
patchsettop
directory are relevant for the current session. When RUP Installer exits the installation phase, it deletes any existing content in the FA_ORACLE_HOME/
patchsettop
directory.Follow these steps when an error occurs during the installation phase:
- Click Cancel to exit RUP Installer.
- Review the log files to determine the cause of the failure. The log files reside in
oracle_inventory/logs/install
timestamp
.log
. - Resolve the cause of the failure.
- Start RUP Installer using the same command syntax that you used for the previous incomplete installation. For more information, see Section 5.4.1, 'Perform the Installation'. After canceling the previous installation and starting again, you must choose to continue with the previous failed installation by clicking Yes on the Checkpoint Dialog. If the error is not recoverable, you can restore and restart from backup.
- If you choose to continue with the failed installation, RUP Installer opens at the screen where it was canceled. When canceled during the copy action, it relaunches in the Installation Summary screen. Click Next to navigate through the Installation Summary screen. When the Installation Progress screen displays, click Install to start the installation again.
Troubleshooting steps are described for the following specific failures that may occur during the installation phase:
5.5.2.1 Invalid Oracle Home
In the Installation Location page, you receive a message about entering an invalid Oracle home, even though the location displayed on the page is correct. RUP Installer reads
/etc/oraInst.loc
to determine the location of the central inventory. Review the following settings:- Ensure that the
/etc/oraInst.loc
file on the machine where you are running RUP Installer is pointing to the correct central inventory location. - Ensure that the
FA_ORACLE_HOME
matches the values provided during provisioning. If a/net/location
was provided as the Oracle home location during provisioning, the same/net/location
that corresponds to FA_ORACLE_HOME should be provided during the RUP Installation.
5.5.2.2 Error in Writing to File, Text File Busy
During the installation phase of RUP Installer, you receive the following message on a Unix platform.
To resolve this issue, perform the following steps.
- Run the
lsof
command using the full directory path of the file that is busy. - You should receive a list of process ids that are using the file. Kill each process using the appropriate command for your operating system.
- After all processes are no longer running, click Continue in RUP Installer.
5.5.2.3 Inventory Pointer File is Empty
After running RUP Installer, the contents of
oraInst.loc
were removed.RUP Installer always tries to copy the inventory pointer file specified by the
-invPtrLoc
option to the Oracle home on which the RUP is to be installed. If you specify an incorrect path for the -invPtrLoc
file, the inventory pointer file could result in being an empty file. There are three possible solutions to this issue:- For best results, if you are using the -
invPtrLoc
option, use it with this value:FA_ORACLE_HOME
/oraInst.loc
. This avoids a situation where you may inadvertently exclude part of the directory path to the file, as in the case of using a mapped drive. For example, if Oracle home is registered in inventory with a/net
path, such as/net/home/oraInst.loc
, and you provide/home/oraInst.loc
to theinvPtrLoc
option, the installer interprets the two paths as different. The end result is an empty inventory pointer file. - If
FA_ORACLE_HOME
is registered in central inventory with a/net
path, then you must include/net
when specifying the location of the inventory pointer file with the-invPtrLoc
option, for example,-invPtrLoc /net/
directory_path/
oraInst.loc
. - Restore from a backup copy of your
oraInst.loc
file in case the original file is damaged. - You can recover from this error by creating a new
oraInst.loc
. See the 'Creating the oraInst.loc File' section in the relevant Oracle Database installation guide, for example, Oracle Database Installation Guide, 11g Release 2 (11.2) for Linux.Then click Retry.
5.5.3 General Troubleshooting During the Configuration Phase
RUP Installer can be restarted to rerun all failed configuration tasks as well as those tasks that were not started from the previous session. When a configuration task or step fails, the Configuration Progress screen displays the location of the log file and the exception that caused the failure. You can also view the content of the log files that appear at the bottom of the screen to obtain detailed information to assist in diagnosing the cause of the failure.
If one or more failures occur during the configuration phase, the following message displays after the final configuration task is complete:
Configuration is completed with errors, exit the installer by clicking the 'Cancel' button and retry the failed configurations.
Perform the following steps to rerun RUP Installer and retry the failed configuration tasks:
- Click Cancel to exit RUP Installer.
- Resolve the issues that caused the failure.
- Start RUP Installer using the same command syntax that you used for the previous incomplete installation. For more information, see Section 5.4.1, 'Perform the Installation'.
- A pop up dialog displays, asking if you want to continue the previous incomplete installation. Select Yes to continue the previous session. If you select No, RUP Installer starts from the beginning and it will fail, indicating that a RUP cannot be installed again in the same environment. You would then need to restore from your backup and restart the RUP installation.
- The Configuration Progress screen displays only the failed and remaining configuration tasks, and then runs these tasks.
- Assuming all configuration tasks complete successfully, click Next to go to the Installation Complete screen and then click Finish to end the session. If a configuration task fails again and you want to attempt to run the session again, click Cancel to save the session.
5.5.4 The Next Button Is Not Enabled During Configuration Tasks
On the Configuration Progress page of RUP Installer, the Next button is enabled only when all configuration tasks are successful.
If you see that all your configurations are complete, and the Next button is not enabled, you encountered a configuration failure and continued on to the next configuration. In this case, you must retry the failed configurations by following these steps:
- On the Configuration Progress page of the RUP Installer, click Cancel.
- Restart RUP Installer. All failed configuration actions or steps are re-executed upon restart. For more information, see Section 5.5.3, 'General Troubleshooting During the Configuration Phase'.
As long as a configuration task is not successful, the Next button remains disabled. It may be necessary to repeat the cancel and restart procedure until all configuration tasks are successful.
5.5.5 Error Finding WEBLOGIC_HOME
On the Configuration Progress page of RUP Installer, a
java.lang.RuntimeException:: error in finding weblogic.Home
error may occur. The Oracle WebLogic Server class path may be corrupted.Follow these steps to resolve this issue:
- On the Configuration Progress page of RUP Installer, click Cancel.
- Set the WEBLOGIC_HOME in the CLASSPATH parameter explicitly. For example:
- Restart RUP Installer. All failed configuration actions or steps rerun upon restart.
5.5.6 Error During Bootstrapping Patch Manager
An error during the Bootstrapping Patch Manager configuration task normally occurs only when the database is down. Ensure that the database is up and running. You can review the related log files in this location:
FA_ORACLE_HOME
/admin/FUSION/log/FAPatchManager_bootstrap_
timestamp
.log
5.5.7 Troubleshooting Applying Middleware Patches
If an error occurs during the Applying Pre-PSA Middleware Patches or Applying Post-PSA Middleware Patches configuration tasks, review the log file in the relevant location:
FA_ORACLE_HOME/
admin/FUSION/log/fapatch/fapatch_11.1.3.0.0/ApplyPrePSAMiddlewarePatches
timestamp
.log
FA_ORACLE_HOME/
admin/FUSION/log/fapatch/fapatch_11.1.3.0.0/ApplyPostPSAMiddlewarePatches
timestamp
.log
For specific OPatch failures, go to each of the individual Oracle home directories to find the details of the OPatch errors. For example, for a SOA failure, go to
APPLICATIONS_BASE/
fusionapps/soa/cfgtoollogs/opatch
.5.5.8 Failure During Applying Middleware Patch Sets
Perform the following steps if the following error occurs during Applying Middleware Patch Sets:
- Confirm that you have followed the instructions in Section 5.3.2, 'Apply Mandatory Prerequisite Patches', Step 6.
- If you are installing the RUP in an Oracle VM environment, ensure that ODI Standalone Agent is installed. If this is not installed, refer to 'Installing Oracle Data Integrator (ODI) Standalone Agent for a Successful RUP Installation' in Oracle Fusion Applications release notes, 11g Release 1, Update 2 (11.1.3.0.0).
5.5.9 EditTimedOutException Error During Online Preverification
If you receive the following error during preverification, you may have to manually release the edit session. For more information, see Section 11.3.8, 'Resolving an EditTimedOutException Error'.
5.5.10 Troubleshooting Loading Database Components
This section contains information about troubleshooting issues that can occur during the Loading Database Components configuration task. Depending on the type of failure, you may need to review one or more of the log files in the following locations:
FA_ORACLE_HOME/
admin/FUSION/log/fapatch/fapatch_11.1.3.0.0/PatchManager_DBPatch/
FAPatchManager_apply_
timestamp
.log
adpatch_apply_
timestamp
.log
adpatch_apply
_timestamp
_workerum
.log
ATGPF_HOME/
admin/FUSION/log
5.5.10.1 Error While Loading Database Tasks
When RUP Installer notifies you that one or more database workers failed during the Loading Database Components configuration task, you must start AD Controller to manage the failed workers. For more information, see Section 11.5, 'Troubleshooting Patching Sessions for Database Content'. After you resolve the issue that caused the workers to fail and you restart the failed worker, click OK in the dialog box and RUP Installer continues processing.
5.5.10.2 Database Failure While Loading Database Components
If your database goes down while RUP Installer is running the Loading Database Components configuration task, the options to Abort or Retry display. If you simply bring the database up and then click Retry, you may encounter the following error:
Perform the following steps to recover from this error:
- Force the database patching session to fail.
- Start AD Controller.For more information, see Section 11.5.1, 'Starting AD Controller'.
- Follow this sequence of steps in AD Controller to manage the workers:
- Select Tell manager that a worker failed its job and enter All for all workers.
- Select Tell worker to quit and enter All for all workers. Note that this does not kill the workers. It sends a command to the worker to shutdown after it completes the current task.
- Wait for all workers to complete their tasks and shut down normally.
- If there are still some worker processes that do not shut down, kill those processes manually by selecting Tell manager that a worker failed its job. Then select Tell manager that a worker acknowledges quit and enter All for all workers.
- From your operating system, check for processes that are running
fapmgr, javaworker, adpatch, adadmin
,sqlplus
, andadworker
. If any exist, terminate them from your operating system. For more information, see - Select Tell worker to restart a failed job and enter All for all workers.
- Select Cancel to stop the session and restart RUP Installer.
5.5.10.3 AutoPatch Validation Fails
If AutoPatch validation fails, you receive this message:
An active adpatch or adadmin session was found. Complete or terminate the active session to allow fapmgr to proceed
.Follow these steps to resolve this error:
- Run the
fapmgr forcefail
command to update the patching tables. - Run the
fapmgr abort
command fromFA_ORACLE_HOME
to find out if an Oracle Fusion Applications Patch Manager must be cleaned up.If this command finds no failed session, proceed to Step 3. - Run the following commands from
ATGPF_ORACLE_HOME
to abandon any Applications Core patching sessions or AD Administration sessions that may be running:
5.5.11 LdapServerCheck Failure
If the OPSS Security Store is not running before RUP Installer starts, the related configuration task will fail. Even if you start this server after you notice the failure, the configuration task fails again, with the following error:
Follow these steps to recover:
- Abort the failed configuration task.
- Select Cancel to end the RUP Installer session.
- Start the OPSS Security Store. For more information, see 'Starting and Stopping Oracle Internet Directory' in the Oracle Fusion Middleware Enterprise Deployment Guide for Oracle Identity Management (Oracle Fusion Applications Edition).
- Start a new RUP Installer session. The installer resumes with the remaining tasks because you selected Cancel, which saves the session.
5.5.12 Troubleshooting Deployment of Applications Policies
This section contains information about troubleshooting issues that may occur during the Deploying Application Policies configuration task. Log files for this task may be found in this location:
FA_ORACLE_HOME/
admin/FUSION/log/fapatch/fapatch_11.1.3.0.0/fapatch
_timestamp
.log
5.5.12.1 Failure During Deployment of Applications Policies
When a failure occurs during Deploying Application Policies, you must restore only the stripe or system policy that failed from your backup. Use the OPSS
migrateSecurityStore
command with the appropriate source and destination arguments to perform the restore. Do not restore a stripe that has not failed. Review the log file to determine the cause of the failure. If needed, you can also review the log file that is specifically generated by each stripe. These following log files are located under the main log directory, FA_ORACLE_HOME/
admin/FUSION/log/fapatch/fapatch_11.1.3.0.0
/timestamp
:fapatch_CRMJaznAnalysis
_timestamp
.logfapatch_FSCMJaznAnalysis
_timestamp
.logfapatch_HCMJaznAnalysis
_timestamp
.logfapatch_OBIJaznAnalysis
_timestamp
.log
After you resolve the issue, restart RUP Installer by either selecting Retry in the same session or by exiting RUP Installer and restarting it.
For more information, see 'Migrating with the Script migrateSecurityStore' in the Oracle Fusion Middleware Application Security Guide.
5.5.12.2 Stripe Version Mismatch in Applications Policies
After the deployment of Applications Policies, a version check is performed, to ensure that the version of each stripe was updated successfully in OID. If the version of a stripe is incorrect, an error about a version mismatch is reported.
To resolve this issue, you may need a fix from Oracle Support to retry the deployment after you restore your policy store. Use the OPSS
migrateSecurityStore
command with the appropriate source and destination arguments. Do not restore a stripe that has not failed.For more information, see 'Migrating with the Script migrateSecurityStore' in the Oracle Fusion Middleware Application Security Guide.
5.5.12.3 IDM Server Failure During Deployment of Applications Policies
If the IDM Server goes down during the deployment of applications policies, the deployment fails. Even if the Retry button is enabled, RUP Installer does not allow a retry after this type of failure. You must instead click Cancel and restart RUP Installer.
5.5.12.4 JAZN Policy Stripe Version Validation Failure
Read only permission on a
.tmp
file could result in a failure during JAZN policy stripe validation. This file is created by the Oracle Enterprise Agent, with a file name such as, /tmp/pki_data1967998276.lck.tmp
. The file is owned by emcadm
, so the policy version validation fails. Because the policy upload completes before version validation starts, you can click Continue to proceed to the next task.5.5.12.5 migrateSecurityStore Command Fails
While running the WLST command
migrateSecurityStore
to backup applications and system policies, the command fails with the following error:To resolve this error, remove the entry,
<serviceInstanceRef ref='idstore.ldap'/>
, as described in Step 4 in Section 5.3.4.3, 'Back Up Applications and System Policies'.5.5.13 Failure during Applying OAM Configuration
If the Applying OAM Configuration task fails with the following error:
Perform this workaround to run
oamcfgtool.jar
manually from the command-line. Note that the parameters in brackets <> must be replaced with valid values first.:5.5.14 Webcat Patch File Creation Failure
If you apply a RUP that contains BI Publisher artifacts, the BI Presentation servers must not be running. The following error occurs if the BI Presentation servers are running during the deployment of BI Publisher artifacts:
To resolve this issue, shut down the BI Presentation servers to release locks on the Oracle BI Presentation Catalog. For more information, see 'fastartstop Syntax' in the Oracle Fusion Applications Administrator's Guide.
5.5.15 Failure During Deployment of BI Publisher Artifacts
If the deployment of BI Publisher artifacts fails, follow these steps to restore the BI Publisher web catalog and retry the deployment.
- Click Cancel to exit RUP Installer.
- Restore the web catalog from the backup created by RUP Installer. The log file includes a message that provides the location of the backup, for example:
- Restart RUP Installer.
5.5.16 Failures During Starting All Servers
A failure during the Starting All Servers configuration task typically happens when one of the servers times out and fails to restart due to resource issues or application specific issues.
5.5.16.1 General Failure
Various platforms and environment configurations can impact how long it will take all servers to actually start during the Starting All Servers configuration task. Although RUP Installer waits an average amount of time for this task to complete before it is marked as Failed, different platforms may require more time. It is not unusual to receive timeout errors in the log files if the starting of all servers for your environment requires more time than RUP Installer allows. If this task fails, follow these steps:
- Monitor the status of the servers by reviewing the messages in the server log files or on the console. The log file,
FA_ORACLE_HOME/
admin/FUSION/log/fapatch/fapatch_11.1.3.0.0/StartStop/fastartstop_
timestamp
.log, indicates which server failed to start.An example of messages for a server that timed out follow. - Review the log files at the domain level to see a summary of the server status for the domain in the previous step:
FA_ORACLE_HOME/
admin/FUSION/log/fapatch/fapatch_11.1.4.0.0/StartStop/
domain name_timestamp
.log
. - Review the corresponding server logs for the failed servers under the following directory:
APPLICATIONS_CONFIG/
domains/
hostname
/domain name/
servers/
server_name/
logs
. - After you determine and resolve the cause of the failure, return to RUP Installer and click Retry.
- When all servers are up and running, including those that exceeded the timeout limit, click Abort in RUP Installer to move to the next configuration task.
5.5.16.2 Failure to Start BIServer
The following exception during the Starting all Servers configuration action indicates a failure in starting the
BIServer
:The
coreapplication_obips1
server log file reports the following error:Perform the following steps to work around this issue.
- Select Retry, which shuts down and starts
bi_server1
. - Monitor the
fastartstop
log files and the state ofbi_server1(BIDomain).
- As soon as
bi_server1
restarts, as indicated by a RUNNING status, start the componentcoreapplication_obiccs1
or all the components of typeOracleBIClusterControllerComponent
usingopmnctl
.Example syntax follows:
5.5.17 Failure During IPM Import
If the configuration task for importing IPM artifacts fails with the following error, follow the instructions in Step 7 in Section 4.12.1, 'Prerequisites for the Deployment of IPM Artifacts'. Then run the following command:
5.5.18 Merging SOA Composite JDeveloper Customizations While Installing a RUP
If you performed JDeveloper customizations to a SOA composite and you deployed the composite to the SOA runtime, RUP Installer reports an error during Online Preverification, which instructs you to take the newer version of the composite that is in the RUP. You must then merge your customizations by performing the following steps.
- If any customizations are detected, the Online Preverification results display the SOA composite name, its location in the
FA_ORACLE_HOME/
stripe/
deploy
directory, and the requirement for you to merge JDeveloper customizations into the sca_*.jar file inFA_ORACLE_HOME
before proceeding with RUP Installer. The stripe in the directory path refers to crm, hcm, fscm, and so on. - Open the custom SOA workspace and the customized version of the Fusion Applications SOA composite in JDeveloper using 'Oracle Fusion Applications Developer'. For more information, see 'Customizing SOA Composites with JDeveloper' in the Oracle Fusion Applications Web User Interface Developer's Guide for Oracle Application Development Framework.
- Import the composite
sca_*.jar
file fromFA_ORACLE_HOME/
stripe/
deploy
into the project, for example revision 11.1.3.0.0, in JDeveloper. Make note of this revision number in the deployment window because you will need it in Step 8. - Restart JDeveloper in the Oracle Fusion Applications Administrator Customization role.
- Verify that there are no errors in JDeveloper.
- Verify that the changes introduced in both the customized version and the patched version are present.
- Right-click the composite project in the Application Navigator, select Deploy, select the composite, click Deploy to SAR, and click Next.
- Manually change the value in New Revision ID to the revision from Step 3, for example, 11.1.3.0.0, and click Finish.
- If the deployment folder is set to a location different from that of the
FA_ORACLE_HOME/
stripe/deploy
directory, copy and replace the JAR in the location mentioned in the error message of this SOA Composite. If your file name is different, rename it to the original name. You must copy the jar file in the correct format toFA_ORACLE_HOME/
stripe/deploy
. For example if you havesca_ContractsDeliverablePurchaseDocAttrReadComposite_rev11.1.2.0.0.jar
in JDeveloper, then you must copy it back toFA_ORACLE_HOME/
stripe/deploy
assca_ContractsDeliverablePurchaseDocAttrReadComposite.jar
. - To proceed with the installation of the RUP, select Retry.
For more information about customizing SOA composites, see 'Customizing and Extending SOA Components' in the Oracle Fusion Applications Extensibility Guide.
5.5.19 Troubleshooting SOA Composite Deployment Failures
This section describes how to recover from out-of-memory errors during the Deploying SOA Composites configuration task. The following topics are described:
5.5.19.1 SOA Composite Log Files
The following log files are generated by the deployment of SOA composites:
- Client side log files where individual domain logs reside:
FA_ORACLE_HOME
/admin/FUSION/log/fapatch/fapatch_11.1.3.0.0/soalogs
- Log files for the failed domain:
APPLICATIONS_CONFIG/
domains/
hostname/
domain name/
servers/
server name/
logs/soa_server1.log
APPLICATIONS_CONFIG/
domains/
hostname/
domain name/
servers/
server name/
logs/soa_server1.out
APPLICATIONS_CONFIG/
domains/
hostname/
domain name/
servers/
server name/
logs/soa_server1-diagnostic.log
APPLICATIONS_CONFIG/
domains/
hostname/
domain name/
servers/
server name/
logs/AdminServer.log
5.5.19.2 Composite Revision is Already Deployed
Normally, a failed SOA composite is undeployed by RUP Installer. However, if the failure of the deployment is due to SOA servers running out of memory, then RUP installer cannot recover. As a result, a failure message such as,
CFGEX-00062: Composite revision 'default/composite name!11.1.3.0.0
' is already deployed,
may occur.An example of a complete error message follows:
To resolve this issue, you must manually undeploy the composite.
Note:
Ensure that you undeploy only the revision deployed by RUP Installer. Do not undeploy the previous version.
To undeploy, use WebLogic Server Tool (WLST) commands or the Fusion Applications Control console.
5.5.19.2.1 Undeploy SOA Composites Using WLST Commands
Follow these steps to undeploy the composite using WLST commands:
- Start WLST:
- Run the
sca_undeployComposite
command using the following syntax:where the variables have values as follows:serverURL
contains the host and port of the SOA cluster Managed Server of the domain that the SOA composite failed to deploycompositeName
is the name of the composite to be undeployedrevision
, in the case of Release 2 Update 1 (11.1.3.0.0), should be 11.1.3.0.0 by default.
Example:You are prompted for user name and password to execute the command.For more information, see 'Oracle SOA Suite Custom WLST Commands' in the Oracle Fusion Middleware WebLogic Scripting Tool Command Reference.
5.5.19.2.2 Undeploy SOA Composites Using the Fusion Applications Control Console
Follow these steps to undeploy the composite using the Fusion Applications Control console:
- In the Fusion Applications Control console, connect to the domain where the SOA composite failed to deploy.
- Navigate to Farm_Domain->soa-infra->default.
- Locate the composite and revision, such as 11.1.3.0.0 as shown in this example:
- Right click on the composite and select SOA deployment > Undeploy.
.rup Patch Download
5.5.19.3 Cannot Set Default Composite
You may receive the following error during the deployment of a SOA composite. For this example, the
HcmEmploymentProcessesChngWkHrsComposite
composite is shown:To resolve this issue, manually deploy the missing composite by executing the following commands on a Windows platform:
5.5.20 Failure During Applying BI Metadata Updates
If a failure occurs during the Apply BI Metadata Updates task due to conflicts, you must resolve the conflicts before the task can proceed. You must resolve the conflicts as soon as the task fails and then select Retry to allow RUP Installer to proceed.
To get information about conflicts, review the related report at this location:
Refer to the following types of conflicts for information about how to resolve them.
- To resolve Oracle BI RPD conflicts, use the decision file located at
FA_ORACLE_HOME/
fusionapps/bi/.biapps_patch_storage/update/
timestamp/
patchrpd_decision_file.csv
. The decision file lists the decisions that would have been displayed in the Define Merge Strategy screen of the Merge Wizard if the merge had been performed in the Oracle BI Administration Tool. The decision file provides a record of all items that can be affected by user input.- Use the Load Decision File button in the Define Merge Strategy screen of the Merge Wizard to load the merge decisions, and then change the decisions if needed. In the decision window, ensure you select Current, as those are Oracle's changes.You can then complete the merge in the Oracle BI Administration Tool.
- Use Enterprise Manager to upload the merged RPD. For more information, see 'Using Fusion Middleware Control to Upload a Repository and Set the Oracle BI Presentation Catalog Location' in the Oracle Fusion Middleware System Administrator's Guide for Oracle Business Intelligence Enterprise Edition.
- Return to RUP Installer and select Retry.
For more information, see 'Resolving Conflicts for Oracle BI Repository (RPD) Updates' in the Oracle Fusion Middleware Reference Guide for Oracle Business Intelligence Applications and - If you made customizations to the content of the Oracle BI Presentation Catalog, conflicts may arise when the Oracle BI Presentation Catalog is updated by RUP Installer. You must resolve these conflicts and then run the BI Metadata Update Tool (MUT) which was run by RUP installer. The patch log file lists the conflicts and the location of the runtime and Oracle home Presentation Catalogs.Follow the steps below to resolve Oracle BI Presentation Catalog conflicts:
- Back up the runtime Oracle BI Presentation Catalog. This is the customized Oracle BI Presentation Catalog you were using before running RUP Installer.
- Start the Catalog Manager and open the runtime Oracle BI Presentation Catalog in offline mode.
- Start another instance of the Catalog Manager, and open the Oracle home Oracle BI Presentation Catalog in offline mode. This Oracle BI Presentation Catalog contains the content last delivered by Oracle.
- Review the list of conflicts in the patch log file.
- Archive the runtime Oracle BI Presentation Catalog. For instructions on archiving a Oracle BI Presentation Catalog, see 'Archiving and Unarchiving Using Catalog Manager' in the Oracle Fusion Middleware System Administrator's Guide for Oracle Business Intelligence Enterprise Edition.
- For each object with a conflict, copy the object in the Oracle home Presentation Catalog and paste it into the runtime Presentation Catalog, using the Force paste option. For instructions on copying and pasting objects, see 'Copying and Pasting Objects' in the Oracle Fusion Middleware System Administrator's Guide for Oracle Business Intelligence Enterprise Edition.
- Rerun the BI Metadata Update Tool (MUT). RUP Installer runs the MUT and the last part of the MUT generates a log file that contains the exact command to use for rerunning MUT.
For more information, see 'Resolving Conflicts for Oracle BI Presentation Catalog Updates' in the Oracle Fusion Middleware Reference Guide for Oracle Business Intelligence Applications. - To resolve JAZN policy store conflicts, see 'Resolving Patch Differences' in the Oracle Fusion Middleware Oracle Authorization Policy Manager Administrator's Guide (Oracle Fusion Applications Edition). Also see 'Upgrading Oracle Fusion Applications Policies' in the Oracle Fusion Middleware Oracle Authorization Policy Manager Administrator's Guide (Oracle Fusion Applications Edition) for background information.
5.5.21 AttachHome Script Hangs
If the
attachHome
script hangs, when following the steps in Section 5.2.11, 'Confirm All Oracle Homes Are Registered in the Central Inventory', run attachHome
with the following additional arguments: -waitforcompletion -nowait
.5.5.22 The runInstaller.sh -updateHomeDeps Command Hangs
If the
runInstaller -updateHomeDeps
command hangs, when following the steps in Section 5.2.11, 'Confirm All Oracle Homes Are Registered in the Central Inventory', run this command with the following additional arguments: -waitforcompletion -nowait
.Oracle Rup Patch
5.5.23 Verify Your Installation
.rup Patch Download Pc
Perform the steps in 'Verifying Installation' in the Oracle Fusion Applications Post-Installation Guide.