28 Uninstall an Oracle Fusion Applications Environment

This section describes the actions necessary to remove an existing Oracle Fusion Applications environment from a system. It includes step-by-step instructions and provides important information about the ramifications of taking this action.

This section includes the following topics:

28.1 Introduction to Uninstall an Oracle Fusion Applications Environment

During the uninstallation process, components that were installed using the Provisioning Wizard are removed. The Oracle Fusion Applications database and the Oracle Identity Management components are not removed. To remove the Oracle Fusion Applications database, see Delete the Database. The Oracle Identity Management environment, including the Oracle Identity Management databases is not removed.

Note the following characteristics of the uninstallation process:

  • Run the deinstall process on all hosts. Use the Provisioning Wizard deinstall option for the Primordial host, and the command line option for the Primary host and Secondary host. Products installed from the command line must be uninstalled from the command line.

  • Start the Provisioning Wizard on the same host (primordial) where it was started at the time of installation. Monitor the process on all hosts using the primordial host interface.

  • All binaries, regardless of patch level, are removed.

It is not possible to partially uninstall an environment by selecting specific components to uninstall.

28.2 Prerequisites to Uninstall an Oracle Fusion Applications Environment

Always use the provisioning deinstall option (the Provisioning Wizard option or the command line) rather than simply deleting the APPLICATIONS_BASE, APPLICATIONS_CONFIG, and the oraInventory directories manually. This is especially important for the web tier. Two of its instances share the same oraInventory location.

Before beginning the uninstallation process, complete these tasks:

  1. Stop any processes that are running in the environment.
  2. Shut down all Managed Servers, the Administration Server, and the Node Manager on all hosts. See Stop the Entire Environment in Order in the Oracle Fusion Applications Administrator's Guide.
  3. Stop Oracle HTTP Server with this command: APPLICATIONS_CONFIG/CommonDomain_webtier/bin/opmnctl shutdown.
  4. Stop the Oracle Business Intelligence components that are controlled by Oracle Process Manager and Notification Server with this command: APPLICATIONS_CONFIG/BIInstance/bin/opmnctl shutdown.
  5. Shut down Global Order Promising (GOP) (if provisioned):

    UNIX: APPLICATIONS_CONFIG/gop_1/bin/opmnctl shutdown.

  6. Stop the Java EE components using Oracle Enterprise Manager Fusion Middleware Control. See Starting and Stopping Java EE Applications Using WLST in the Oracle Fusion Middleware Administering Oracle Fusion Middleware.

See Start and Stop Components in the Oracle Fusion Applications Administrator's Guide.

28.3 Uninstall Oracle Fusion Applications Using the Provisioning Wizard

To perform an uninstallation using the Provisioning Wizard, start the wizard from the primordial host and complete the uninstallation interview screens.

28.3.1 Start the Provisioning Wizard

To start the Provisioning Wizard, do the following from the primordial host:

  1. Set the JAVA_HOME environment variable to point to the JDK location in the provisioning repository, for example:

    UNIX:

    export JAVA_HOME=REPOSITORY_LOCATION/jdk

    export PATH=$JAVA_HOME/bin:$PATH

  2. Verify that the LIBPATH value is null.
  3. Run the following command on the primordial host:

    UNIX:

    cd FAPROV_HOME/provisioning/bin

    ./provisioningWizard.sh

    Solaris: use bash provisioningWizard.sh instead of ./provisioningWizard.sh.

28.3.2 Wizard Interview Screens and Instructions

Table 28-1 shows the steps necessary to uninstall an Oracle Fusion Applications environment with the Provisioning Wizard. For help with any of the interview screens, click Help.

If the correct values required are not entered, error and warning messages are displayed at the bottom of the screen.

Table 28-1 Deinstalling an Oracle Fusion Applications Applications Environment

Screen Description and Action Required

Welcome

No action is required on this read-only screen.

Click Next to continue.

Specify Central Inventory Location

This screen displays only if one or more of the following conditions are not met:

  • The -invPtrLoc option is used to specify the central inventory location. Thus, default value for the platform is not used. Note that the default value for Linux platforms is /etc/oraInst.loc. For Solaris, the default value is /var/opt/oracle/oraInst.loc.

  • The Central Inventory Pointer File is readable.

  • The Central Inventory Pointer File contains a value for inventory_loc.

  • The inventory_loc directory is writable.

  • The inventory_loc directory has at least 150K of space.

  • inventory_loc is not an existing file.

Specify the location of the Central Inventory Directory that meets the previous criteria. The inventory_loc directory can be created by the createCentralInventory.sh script and does not have to exist at the time its location is specified.

For non-Windows platforms, in the Operating System Group ID field, select or enter the group whose members are granted access to the inventory directory. All members of this group can install products on this host. Click OK to continue.

The Inventory Location Confirmation dialog prompts to run the inventory_directory/createCentralInventory.sh script as root, to confirm that all conditions are met and to create the default inventory location file, such as /etc/oraInst.loc. After this script runs successfully, return to the interview and click OK to proceed with the installation.

To continue the installation without root access, select Continue installation with local inventory. Click OK to proceed with the installation.

For more information about inventory location files, see Oracle Universal Installer Inventory in the Oracle Universal Installer User's Guide.

Click Next to continue.

Installation Options

Presents a list of valid installation actions that can be performed using the Provisioning Wizard. Select Deinstall an Applications Environment.

Enter the directory path in the Response File field to the response file associated with the environment that needs to be deinstalled. Or click Browse to navigate to the response file location.

Click Next to continue.

Summary

Displays the application and middleware components to be uninstalled. The processes associated with these components must be shut down manually. See Prerequisites to Uninstall an Oracle Fusion Applications Environment.

Click Deinstall to begin uninstalling the applications and middleware components.

Deinstallation Progress

The uninstallation process runs on the primordial host. Uninstall from the command line on any primary or secondary hosts provisioned in the environment. See Uninstall Oracle Fusion Applications From the Command Line.

The following symbols help track the deinstall progress:

  • Block: Processing has not yet started on this host for the named phase.

  • Clock: Performing the build for a phase.

  • Check mark: The build was completed successfully.

  • x mark: The build has failed for this phase. Correct the errors before continuing.

  • Restricted symbol: The validation process has stopped due to a failure within another process.

Click an x or a Restricted symbol to display information about failures. Click the host-level Log file for details about this phase. Click a build Log file to see details specific to that build.

If the uninstallation fails, a Retry button is enabled, allowing to try the uninstall again. See Recovery After Failure for information about retry, cleanup, and restore actions.

Click Next to continue.

Deinstallation Complete

Review the list of components removed from this environment. Click Save to create a text file that contains the details.

See Clean Up After Uninstalling Oracle Fusion Applications for information about manual tasks necessary to complete the uninstallation process.

Click Finish to dismiss the screen.

28.4 Uninstall Oracle Fusion Applications From the Command Line

If a primary or secondary host have been provisioned, run the deinstall command on those hosts from the command line, using the same procedure used during provisioning. If the primordial host is no longer available, the entire uninstall process must be run from the command line.

Run the deinstall command as root (with administration privileges) as follows:

UNIX: runProvisioning.sh -responseFile response_file_location -target deinstall

If the web tier has been deployed in a DMZ, run the Oracle Universal Installer (OUI) manually on that host to uninstall. See Introduction to Oracle Universal Installer (OUI) in the Oracle Universal Installer User’s Guide.

28.5 Clean Up After Uninstalling Oracle Fusion Applications

The remaining cleanup tasks are as follows:

UNIX:

  1. If processes are set up to run as a service, verify the /etc/services file and remove the corresponding entries from the file.

  2. If processes are set up to run as a service, verify the /etc/inetd.conf file and remove the corresponding process entries from the file.

  3. Clean up or remove the APPLICATIONS_BASE directory.

  4. Clean up or remove the application configuration (APPLICATIONS_CONFIG) directory. If local application configuration is enabled, clean up or remove also the local application configuration directories.

Deinstalling Oracle Fusion Applications does not remove the beahomelist file or the bea directory under:

UNIX: user_home/bea/beahomelist

For information about how this file is used, see Backup Artifacts and Updating Oracle Inventory in the Oracle Fusion Middleware Administrator's Guide.

28.6 Uninstall Oracle Identity Management

Follow these instructions to clean up an Oracle Identity Management provisioned environment, before starting another round of provisioning.

Linux or UNIX:

  1. On each host, kill all Oracle Identity Management processes. Restarting the host is recommended.

  2. On each host, delete the contents of the directory IDM_LOCAL_CONFIG.

  3. Delete the contents of the directories IDM_BASE and IDM_CONFIG on shared storage.

  4. Drop the database schema using Oracle Fusion Middleware Repository Creation Utility. When dropping the schema, ensure to select the ODS schema, as it is not selected by default. Oracle Identity Management Provisioning faisl during the next run if this step is not performed correctly.

  5. Rerun provisioning.

28.7 Delete the Database

To delete the database, use Database Configuration Assistant (DBCA) to delete an instance of the database and then remove the database software. See Deleting a Database Using DBCA and Removing Oracle Database Software in Oracle Database 2 Day DBA.

28.8 Uninstall the Oracle Identity Management Provisioning Framework

Follow the instructions described in this section to uninstall the Oracle Identity Management provisioning framework.

  1. Stop all services running under IDMLCM_HOME. Since there is no script for killing processes under IDMLCM_HOME, kill all the processes running under IDMLCM_HOME manually.

  2. Change directory to IDMLCM_HOME/oui/bin and execute the following command:

    UNIX:

    runInstaller -deinstall -jreLoc <JAVA_HOME>

  3. On the Oracle Universal Installer screen, proceed as follow in Table 28-2:

    Table 28-2 Provisioning Framework Deinstallation Screen Flow

    Screen Description and Action Required

    Welcome

    No action is required on the read-only screen.

    Click Next to continue.

    Deinstall Oracle Home

    Verify that the directory path is correct. Click Save to create a text file with the details of the configuration that is being deinstalled.

    Click Deinstall to continue. On the Warning screen, click Yes to remove the software files and the provisioning Oracle home directory. Click No to remove only the software files, or Cancel to return to the previous screen.

    If No is clicked, remove the files manually. For example, if the provisioning framework directory is /d1/Oracle/Provisioning, use this syntax:

    (UNIX)

    cd /d1/oracle/provisioning

    rm -rf provisioning

    Deinstallation Progress

    The progress of the deinstallation is monitored. Click Cancel to stop the process.

    Click Next to continue.

    Deinstallation Complete

    Review the summary of the deinstallation and the components that were deinstalled.

    Click Finish to exit.

If the JAVA_HOME environment variable is not set, retrieve it from REPOSITORY_LOCATION/installers/jdk/jdk.zip, unzip it to any location and set the JAVA_HOME.

28.9 Uninstall the Oracle Fusion Applications Provisioning Framework

Uninstalling Oracle Fusion Applications involves removing the Oracle Fusion Applications Provisioning Oracle home. The deinstaller attempts to remove the Oracle home from which it was started, and removes only the software in the Oracle home.

Before removing the Oracle Fusion Applications Provisioning Oracle home, ensure that it is not in use. After removing the software, provisioning a new Oracle Fusion Applications environment is not longer possible.

28.9.1 Run the Provisioning Framework Deinstaller

To start the deinstaller, navigate to:

UNIX: FAPROV_HOME/oui/bin and use this command:

runInstaller -deinstall -jreLoc REPOSITORY_LOCATION/jdk

The Uninstall menu is a Windows shortcut to the setup.exe -deinstall command. Do not use the Start -> All Programs -> Oracle - OHnnnn -> Oracle Installation Products -> Uninstall menu option on Windows operating systems, where nnnn is a number. This Uninstall menu is also a shortcut to the setup.exe program but does not have the -deinstall command line option. Therefore, it is not deinstall the provisioning framework.

The deinstaller described in this section removes the provisioning framework to provision the Oracle Fusion Applications environment. It does not uninstall the Oracle Fusion Applications environment. To uninstall an Oracle Fusion Applications environment, refer to Uninstall Oracle Fusion Applications Using the Provisioning Wizard or Uninstall Oracle Fusion Applications From the Command Line before removing the provisioning wizard from the system.

28.9.2 Deinstaller Screens and Instructions

Table 28-3 contains instructions for uninstalling the provisioning framework. For help with any of the interview screens, click Help.

Table 28-3 Provisioning Deinstaller Screen Flow

Screen Description and Action Required

Welcome

No action is required on this read-only screen.

Click Next to continue.

Deinstall Oracle Home

Verify that the directory path is correct. Click Save to create a text file with the details of the configuration to be deinstalled. Click Deinstall to continue.

On the Warning screen, select whether the deinstaller should remove the Oracle home directory in addition to removing the software. Click Yes to remove the software files and the provisioning Oracle home directory. Click No to remove only the software files, or click Cancel to return to the previous screen.

If No is clicked, remove the framework software files manually. For example, use this syntax if the directory is /d1/oracle/provisioning:

UNIX: cd /d1/oracle/provisioning

rm -rf provisioning

Deinstallation Progress

Monitor the progress of the deinstallation. Click Cancel to stop the process. Click Next to continue.

Deinstallation Complete

Click Finish.