5 Deinstalling Oracle Business Intelligence

This chapter describes the process of deinstalling some or all Oracle Business Intelligence components. This chapter contains the following sections:

5.1 Deinstallation Scenarios

You can deinstall Oracle Business Intelligence for the following scenarios:

5.1.1 Deinstalling Oracle Business Intelligence on a Single Computer

To deinstall an Oracle Business Intelligence system that was previously installed on a single computer, you deinstall all Oracle Business Intelligence and WebLogic Server components.

Deinstalling an Oracle Business Intelligence installation on a single computer involves the following tasks:

  1. Run the deinstall script and select the Deinstall instances managed by a WebLogic domain option.

  2. Stop all Oracle Business Intelligence processes and servers, including all OPMN-controlled components and JEE components.

  3. Drop the Metadata Services (MDS) and Business Intelligence Platform (BIPLATFORM) schemas using RCU.

  4. Run the deinstall script and select the Deinstall the Oracle home option.

  5. Deinstall the Oracle Common home manually or by running the deinstall script that it contains.

  6. Use the Oracle WebLogic Server uninstaller to uninstall WebLogic Server.

  7. Remove the Oracle home (if necessary).

  8. Remove the Middleware home and any other homes (Domain home, Applications home, and Instance home) that might have been installed outside of the Middleware home.

To begin the process of deinstalling an Oracle Business Intelligence system, deinstall your Oracle Business Intelligence instance. See Section 5.4.2, "Deinstalling Oracle Business Intelligence Instances."

5.1.2 Deinstalling Oracle Business Intelligence with Multiple Domains

To deinstall an Oracle Business Intelligence system that was previously installed with multiple domains on a single computer, you deinstall the Oracle Business Intelligence instance only. This deinstall approach also applies if the Oracle Business Intelligence system is collocated with other Fusion Middleware products on a single computer.

Deinstalling an installation of Oracle Business Intelligence with multiple domains on single computer includes the following tasks:

  1. Run the Oracle Business Intelligence deinstall script and select the Deinstall instances managed by a WebLogic domain option.

  2. Stop all Oracle Business Intelligence processes and servers, including all OPMN-controlled components and JEE components.

  3. Remove the domain, if appropriate, either manually or by using Oracle WebLogic Server Administration Console. After all Oracle Business Intelligence domains are removed, you can also remove the Oracle Business Intelligence home directory.

To begin the process of deinstalling an Oracle Business Intelligence system, deinstall your Oracle Business Intelligence instance. See Section 5.4.2, "Deinstalling Oracle Business Intelligence Instances."

5.1.3 Deinstalling Oracle Business Intelligence Scaled Out

To deinstall an Oracle Business Intelligence system that was previously installed and scaled out across multiple computers, you scale in the installation and then deinstall all Oracle Business Intelligence and WebLogic Server components on each computer.

Deinstalling an installation of Oracle Business Intelligence that is scaled out across multiple computers includes the following tasks:

  1. Scale in your Oracle Business Intelligence system. For more information, refer to "Using Fusion Middleware Control to Scale System Components" in Oracle Fusion Middleware System Administrator's Guide for Oracle Business Intelligence Enterprise Edition.

  2. On each computer that contains Oracle Business Intelligence, complete the steps described in Section 5.1.1, "Deinstalling Oracle Business Intelligence on a Single Computer."

5.2 About the Deinstallation Script

Oracle Business Intelligence includes a script that enables you to perform some steps in the deinstall process (see Section 5.2.2, "Deinstallation Script Options"). When you deinstall Oracle Business Intelligence, you should use the script exactly as described in this chapter. Otherwise, future reinstallations may fail.

5.2.1 Deinstallation Script Location

To use the deinstallation script for your operating system, run one of the following files from your Oracle home with the -deinstall option:

Linux and UNIX:

ORACLE_HOME/oui/bin/runInstaller.sh

Windows:

ORACLE_HOME\oui\bin\setup.exe

Alternatively, on Windows, you can access and start the deinstallation script by clicking the Deinstall shortcut, found in the Start menu programs group Oracle Business Intelligence.

5.2.2 Deinstallation Script Options

The Oracle Business Intelligence deinstallation script provides the following options:

  • Deinstall the Oracle home

    This option removes everything under the Oracle home from which the deinstallation script is started. Before you select this option, ensure that no system components are using the Oracle home you are deinstalling.

  • Deinstall instances managed by a WebLogic domain

    This options removes instances of your system components that are managed by a WebLogic domain. You must provide the credentials for your WebLogic domain.

5.3 Before You Deinstall Oracle Business Intelligence

Before you deinstall Oracle Business Intelligence, do the following:

  • Ensure the Oracle home you want to deinstall is not in use by an existing domain.

    Note:

    The Oracle home can be deinstalled only from the computer that contains the OUI/oraInventory folder. In the case of a shared or mapped drive, use the deinstallation script to connect to a domain and proceed with deinstallation. The Oracle home itself, however, cannot be removed in this case.

  • Stop all running processes that use the Oracle home.

5.4 Deinstallation Tasks

This section provides instructions for the tasks that are related to deinstalling Oracle Business Intelligence. The actual tasks that you must perform vary depending on your situation. In other words, you might not need to perform all of the tasks described in this section. To determine which tasks you must perform for your situation, see Chapter 5, "Deinstallation Scenarios."

The section includes the following topics:

5.4.1 Starting the Deinstallation Script

The instructions to start the deinstallation script depend on the operating system you are using, as described in this section.

To start the deinstallation script on Linux and UNIX operating systems:

  1. In a command window, navigate to the following directory:

    ORACLE_HOME/oui/bin

  2. Run the following command:

    . /runInstaller.sh -deinstall

To start the deinstallation script on Windows operating systems, do one of the following:

  • Click Start, select Programs and then Oracle Business Intelligence, and then click Deinstall.

  • In a command window, navigate to the following directory:

    ORACLE_HOME\oui\bin

    Run the following command:

    setup.exe -deinstall

5.4.2 Deinstalling Oracle Business Intelligence Instances

To deinstall Oracle Business Intelligence instances, follow the steps provided in this section.

Note:

Do not use the opmnctl unregisterinstance command to unregister any Oracle Business Intelligence managed instances. Instead, complete the steps in the following procedure.

To deinstall an Oracle Business Intelligence instance:

  1. Start the deinstallation script. See Section 5.4.1, "Starting the Deinstallation Script."

  2. Welcome Screen

    Click Next.

  3. Select Deinstallation Type Screen

    Click Deinstall ASInstances managed by WebLogic Domain, and then click Next to continue.

  4. Specify WebLogic Domain Detail Screen

    Specify the following information:

    • The host name of the domain

    • The port number for the domain

    • User name of the system administrator account

    • Password for the system administrate account

    Click Next to continue.

  5. Select Managed Instance Screen

    Click the Oracle Business Intelligence instance you want to deinstall.

    Click Next to continue.

  6. Deinstallation Summary Screen

    Verify the deinstallation settings.

    Click Deinstall to initiate the deinstallation.

  7. Deinstall Progress Screen

    This screen shows the progress and status of the deinstallation. No action is required; the installer automatically advances to the next screen when deinstallation is complete.

  8. Deinstall Completed Screen

    Click Finish.

  9. If you are deinstalling an Oracle Business Intelligence instance in a scaled out installation, open Oracle Enterprise Manager Fusion Middleware Control. In Fusion Middleware Control, click Lock and Edit Configuration. Then, without changing any configuration settings, click Release Configuration. This removes references of Business Intelligence components from the instance you deinstalled.

Next, stop Oracle Business Intelligence. See Section 5.4.3, "Stopping Oracle Business Intelligence."

5.4.3 Stopping Oracle Business Intelligence

Before continuing with the deinstallation process, stop the Oracle Business Intelligence components controlled by OPMN (opmnctl stopall) and JEE components. You can stop the JEE components through Oracle Enterprise Manager Fusion Middleware Control.

For details and instructions on stopping your Oracle Business Intelligence system, refer to Chapter 4, "Starting and Stopping Oracle Business Intelligence" in Oracle Fusion Middleware System Administrator's Guide for Oracle Business Intelligence Enterprise Edition.

Next, continue with one of the following tasks, depending on your deinstallation scenario:

5.4.4 Dropping Oracle Business Intelligence Schemas

To drop the Oracle Business Intelligence schemas from your database, you run the Repository Creation Utility (RCU).

Access RCU from one of the following directories, depending on your operating system:

  • On Linux and UNIX:

    RCU_HOME/bin

  • On Windows:

    RCU_HOME\bin

To drop the Oracle Business Intelligence database schemas:

  1. Start RCU using one of the following commands, depending on your operating system:

    • On Linux and UNIX:

      ./rcu

    • On Windows:

      Run rcu.bat

    If you downloaded the RCU .zip file from OTN, then you can also start RCU as shown above from the bin directory of the RCU_HOME.

  2. On the Welcome screen, click Next.

  3. On the Create Repository screen, select Drop, and then click Next.

  4. On the Database Connection Details screen, provide the credentials to connect to your database. These are the same credentials you provided on this screen when you created the Metadata Services (MDS) and Business Intelligence Platform (BIPLATFORM) schemas.

    Click Next. A Checking Prerequisites screen appears. If there are errors, details about the errors are displayed on the Database Connection Details Screen. Fix the errors and click Next again.

  5. On the Select Components screen, select the prefix and schemas you want to drop from the repository.

    Click Next. A Checking Prerequisites screen appears. If there are errors, details about the errors are displayed on the Select Components Screen. Fix the errors and click Next again.

    After the checking is complete with no errors, click OK to dismiss the screen.

  6. On the Summary screen, click Drop.

    A DROP screen appears. If there are errors, details about the errors are displayed on the Summary Screen. Fix the errors and click Next again.

    After the schemas are dropped with no errors, click OK to dismiss the screen.

  7. On the Completion Summary screen, click Close.

Next, restart the deinstallation script and deinstall the Oracle home. See Section 5.4.5, "Deinstalling the Oracle Home."

5.4.5 Deinstalling the Oracle Home

After all managed and unmanaged Oracle Business Intelligence instances have been deinstalled, deinstall the Oracle home.

To deinstall the Oracle home:

  1. Start the deinstallation script. See Section 5.4.1, "Starting the Deinstallation Script."

  2. Welcome Screen

    Click Next.

  3. Select Deinstallation Type Screen

    Click Deinstall Oracle home.

    Click Next to continue.

  4. Deinstall Oracle Home Screen

    Verify the Oracle home you are about to deinstall.

    Click Deinstall to continue.

  5. Deinstall Progress Screen

    This screen shows the progress and status of the deinstallation. No action is required; the installer automatically advances to the next screen when deinstallation is complete.

  6. Deinstall Completed Screen

    Click Finish.

Next, deinstall the Oracle Common home. See Section 5.4.6, "Deinstalling the Oracle Common Home."

5.4.6 Deinstalling the Oracle Common Home

You can deinstall the Oracle Common home (inside the Middleware home) manually or by using the deinstall script provided in the Oracle Common home. If you use the deinstall script, you must specify the full path of your Java Runtime Environment (JRE). If you installed Oracle Business Intelligence using the Simple or Enterprise Install type, you can fulfill this requirement by specifying the JDK directory that was created by Oracle Business Intelligence 11g Installer in the Middleware home.

Note:

Do not deinstall the Oracle Common home if other Oracle products are installed in the Middleware home.

To remove the Oracle Common home with the deinstall script:

  1. Access your the following directory, depending on your operating system:

    • Linux and UNIX:

      MW_HOME/oracle_common/oui/bin/

    • Windows

      MW_HOME\oracle_common\oui\bin\

  2. Enter the following command, depending on your operating system:

    • Linux and UNIX:

      ./runInstaller.sh -deinstall -jreLoc full_path_of_jre_or_jdk

    • Windows:

      setup.exe -deinstall -jreLoc full_path_of_jre_or_jdk

    The Oracle home deinstaller Welcome screen opens.

  3. In the Welcome screen, click Next.

  4. In the Deinstall Oracle Home screen, click Deinstall.

  5. When the deinstallation concludes, click Finish.

  6. If you are deinstalling on a computer running a Windows operating system, restart the computer to finalize the deinstallation of the Oracle Business Intelligence instance, Oracle home, and Oracle Common home.

To remove the Oracle Common home manually, do one of the following, depending on your operating system:

  • On Linux and UNIX, run the following commands:

    > cd MW_HOME

    > rm -rf oracle_common

  • On Windows operating systems, open a file manager window, navigate to your Middleware home, then right-click the oracle_common folder and click Delete. Then, restart the computer to finalize the deinstallation of your Oracle Business Intelligence instance, your Oracle home, and Oracle Common home.

Next, uninstall Oracle WebLogic Server. See Section 5.4.7, "Uninstalling Oracle WebLogic Server."

5.4.7 Uninstalling Oracle WebLogic Server

Note:

If you installed Oracle Business Intelligence on a Windows operating system using the Simple or Enterprise Install type, you must uninstall the Node Manager Service before you uninstall Oracle WebLogic Server. To uninstall the Node Manager Service, run uninstallNodeMgrSvc.cmd from the following directory in your WebLogic Home:

WL_HOME\server\bin\uninstallNodeMgrSvc.cmd

For more information, refer to "Installing and Uninstalling the Node Manager Service" in Oracle® Fusion Middleware Installation Guide for Oracle WebLogic Server.

Uninstall your Oracle WebLogic Server. For more information, refer to Chapter 6, "Uninstalling the Software" in Oracle® Fusion Middleware Installation Guide for Oracle WebLogic Server.

Next, remove the Oracle home (if the deinstallation script did not remove it). See Section 5.4.9, "Removing the Oracle Home."

5.4.8 Removing the Oracle Business Intelligence Domain

You can remove the Oracle Business Intelligence domain manually or by using Oracle WebLogic Server Administration Console. This section describes the manual method. For details on the method using Oracle WebLogic Server Administration Console, refer to Oracle® Fusion Middleware Administrator's Guide.

To delete your Oracle Business Intelligence domain manually:

  1. Do one of the following, depending on your operating system:

    • On Linux and UNIX, run the following commands:

      > cd MW_HOME/user_projects/domains

      > rm -rf bifoundation_domain

    • On Windows operating systems, open a file manager window, navigate to the MW_HOME\user_projects\domains directory, right-click the bifoundation_domain folder, and click Delete.

  2. If you're deinstalling a scaled out installation, an additional domain directory (bifoundation_domain) exists in the MW_HOME/user_projects/applications directory. Oracle recommends that you remove this directory using the methods described above.

Next, remove the Oracle home (if the deinstallation script did not remove it). See Section 5.4.9, "Removing the Oracle Home."

5.4.9 Removing the Oracle Home

Under certain circumstances, the Oracle Business Intelligence deinstallation script does not remove the Oracle home. If this occurs, manually remove Oracle home and all its sub-directories.

To manually remove the Oracle home, do one of the following, depending on your operating system:

  • On Linux and UNIX, run the following commands:

    > cd MW_HOME

    > rm -rf Oracle_BI1

  • On Windows operating systems, open a file manager window, navigate to your Middleware home, right-click the Oracle_BI1 folder, and click Delete.

After you manually remove the Oracle home and all its sub-directories, do one of the following, depending on your deinstallation scenario:

  • Deinstalling Oracle Business Intelligence on a single computer: The next step is to remove the Middleware home and any other homes (Domain, Applications, and Instance homes) that were optionally installed outside of the Middleware home. See Section 5.4.10, "Removing the Middleware Home and Homes Installed Outside of the Middleware Home."

  • Deinstalling Oracle Business Intelligence that was previously installed with multiple domains on a single computer: This is the final step of the deinstall process. No other tasks are required.

5.4.10 Removing the Middleware Home and Homes Installed Outside of the Middleware Home

After removing the Oracle Business Intelligence home and all its sub-directories, manually remove the Middleware home and any homes that were installed outside of the Middleware home, such as the Domain, Applications, and Instance homes.

To manually remove the Middleware home, do one of the following, depending on your operating system:

  • On Linux and UNIX, run the following commands:

    > cd MW_HOME_parent_dir

    > rm -rf MW_HOME

  • On Windows operating systems, open a file manager window, navigate to the parent directory of your Middleware home, right-click the MW_HOME folder, and click Delete.

Typically, the Domain, Applications, and Instance homes are installed inside the Middleware home. However, in certain situations, you have the option to install them outside of the Middleware home. If any of these homes were installed outside of the Middleware home and you want to remove them, you must do so manually.

This is the final step of the deinstall process if you are deinstalling Oracle Business Intelligence on a single computer or with multiple domains. If you are deinstalling a scaled out installation of Oracle Business Intelligence, return to Section 5.4.2, "Deinstalling Oracle Business Intelligence Instances" and repeat the deinstallation process for all other computers that contain Oracle Business Intelligence.

5.5 Silent Deinstallation

In a silent deinstallation (or unattended installation), an Oracle Business Intelligence instance and home are deinstalled without user interaction.

Silent deinstallation eliminates the need to monitor the deinstallation of Oracle Business Intelligence instances and homes because no graphical output is displayed and no direct user input is required. You use the -d or –deinstall parameter from the command line and supply the installer with a response file. The response file is a text file containing variables and parameter values that provide answers to the deinstallation script prompts. Unless it is modified, a response file is only portable to computers that have the same directory structures (including logical drives) as the computer where it was created.

Silently deinstalling Oracle Business Intelligence includes the following tasks:

  1. Create a response file for deinstalling the Oracle Business Intelligence instance. See Section 5.5.1, "Creating Response Files to Silently Deinstall Oracle Business Intelligence."

  2. Create a response file for deinstalling the Oracle home. See Section 5.5.1, "Creating Response Files to Silently Deinstall Oracle Business Intelligence."

  3. Deinstall the Oracle Business Intelligence instance using the response file you created in Step 1. You can deinstall an Oracle Business Intelligence instance by using the response file from the command line or by running a batch or shell program that uses the response file. See Section 5.5.2, "Silently Deinstalling Oracle Instances."

  4. Stop all Oracle Business Intelligence processes and servers, including all OPMN-controlled components and JEE components. See Section 5.4.3, "Stopping Oracle Business Intelligence."

  5. Drop your Oracle Business Intelligence schemas. See Section 5.4.4, "Dropping Oracle Business Intelligence Schemas."

  6. Deinstall the Oracle home using the response file you created in Step 2. You can deinstall an Oracle home by using the response file from the command line or by running a batch or shell program that uses the response file. See Section 5.5.3, "Silently Deinstalling Oracle Homes."

  7. Deinstall the Oracle Common home manually or by running the deinstall script that it contains. See Section 5.4.6, "Deinstalling the Oracle Common Home."

  8. Deinstall Oracle WebLogic Server. See Section 5.4.7, "Uninstalling Oracle WebLogic Server."

  9. Remove the Oracle Business Intelligence domain. Section 5.4.8, "Removing the Oracle Business Intelligence Domain."

  10. Remove the Oracle home. See Section 5.4.9, "Removing the Oracle Home."

  11. Remove the Middleware home and any other homes (Domain home, Applications home, and Instance home) that might have been installed outside of the Middleware home. Section 5.4.10, "Removing the Middleware Home and Homes Installed Outside of the Middleware Home."

5.5.1 Creating Response Files to Silently Deinstall Oracle Business Intelligence

To silently deinstall Oracle Business Intelligence, you must save information specific about your installation in a response file. If you attempt to deinstall using a response file that is not configured correctly, the deinstallation program is very likely to fail.

You can create response files manually in a text editor or automatically by running the Oracle Business Intelligence deinstallation script. This procedures in this section describe the latter method.

To create a response file using the Oracle Business Intelligence deinstallation script, you click Save on the Deinstall Oracle Home screen (if you selected to deinstall your Oracle home) or the Deinstallation Summary screen (if you selected to deinstall an Oracle instance). When you use the deinstallation script, it prompts you for a name and location where to save the response file. After you create a response file, you can use it to replicate the deinstallation on other systems by modifying it in a text editor as needed.

To create a response file for a silent deinstallation, refer to one or both of the following sections:

5.5.1.1 Creating Response Files for Silently Deinstalling Oracle Business Intelligence Instances

To create a response file for a silently deinstalling an Oracle Business Intelligence instance:

  1. Start the deinstallation script. See Section 5.4.1, "Starting the Deinstallation Script."

  2. Welcome Screen

    Click Next.

  3. Select Deinstallation Type Screen

    Click Deinstall ASInstances managed by WebLogic Domain, and then click Next to continue.

  4. Specify WebLogic Domain Detail Screen

    Specify the following information:

    • The host name of the domain

    • The port number for the domain

    • User name of the system administrator account

    • Password for the system administrate account

    Click Next to continue.

  5. Select Managed Instance Screen

    Click the Oracle Business Intelligence instance you want to deinstall.

    Click Next to continue.

  6. Deinstallation Summary Screen

    Verify the deinstallation settings.

    Click Save to save the deinstallation settings in a response file.

  7. In the Save window, specify the name of your response file and the location where you want to save it, and then click Save. Remember to save the file with the .rsp file extension. Also, make a note of the name and location of the response file.

  8. Do one of the following:

5.5.1.2 Creating Response Files for Silently Deinstalling Oracle Homes

To create a response file for a silently deinstalling an Oracle home:

  1. Start the deinstallation script. See Section 5.4.1, "Starting the Deinstallation Script."

  2. Welcome Screen

    Click Next.

  3. Select Deinstallation Type Screen

    Click Deinstall Oracle home.

    Click Next to continue.

  4. Deinstall Oracle Home Screen

    Verify the Oracle home you are about to deinstall.

    Click Save to save the deinstallation settings in a response file.

  5. In the Save window, specify the name of your response file and the location where you want to save it, and then click Save. Remember to save the file with the .rsp file extension. Also, make a note of the name and location of the response file.

  6. Do one of the following:

5.5.2 Silently Deinstalling Oracle Instances

To silently deinstall an Oracle instance:

  1. In a command window, access the following directory, depending on your operating system:

    Linux and UNIX:

    ORACLE_HOME/oui/bin/

    Windows:

    ORACLE_HOME\oui\bin\

  2. Run the following command, depending on your operating system:

    Linux and UNIX:

    ./runInstaller -silent -deinstall -response path_to_deinstall_instance_file/deinstall_instance_filename.rsp

    Windows:

    setup.exe -silent -deinstall -response path_to_deinstall_instance_file\deinstall_instance_filename.rsp

5.5.3 Silently Deinstalling Oracle Homes

To silently deinstall an Oracle home:

  1. In a command window, access the following directory, depending on your operating system:

    Linux and UNIX:

    ORACLE_HOME/oui/bin/

    Windows:

    ORACLE_HOME\oui\bin\

  2. Run the following command, depending on your operating system:

    Linux and UNIX:

    ./runInstaller -silent -deinstall -response path_to_deinstall_home_file/deinstall_home_filename.rsp

    Windows:

    setup.exe -silent -deinstall -response path_to_deinstall_home_file\deinstall_home_filename.rsp