# Installation Guide

# Uninstalling the Software

The following sections provide procedures for uninstalling the software:

- About the Uninstallation Program
- Uninstalling Your Software in Graphical Mode
- Uninstalling Your Software in Console Mode
- Uninstalling Your Software in Silent Mode
- Reinstalling Your Software

## About the Uninstallation Program

The following sections describe how to uninstall your BEA software on Windows and UNIX systems. You can uninstall the software using graphical, console, or silent mode. To run the graphical-mode uninstallation program, your console must support a Java-based GUI. If the uninstallation program determines that your system cannot support a Java-based GUI, it automatically starts running in console mode.

You can uninstall individual components of your product distribution, or the entire installation. Dependency checking in the uninstaller ensures that the appropriate components are uninstalled.

The uninstallation program does not remove the BEA Home directory associated with the installation, the JDK, or any user-created domains. Only the components that were installed by the installation program can be removed. If you choose to uninstall the entire installation, the uninstallation program also removes the product directory associated with the installation unless one of the following is true:

- The product directory contains user-created configuration or application files—the uninstallation program does not delete user-created configuration files, application files, or domains.
- The complete installation was not uninstalled. If an individual component is uninstalled, only the installation directory for that component is removed; the installation directories for other components are unaffected.
- The uninstallation program was invoked from within the product directory structure—specifically, from within the `uninstaller` directory.

## Uninstalling Your Software in Graphical Mode

Use the following procedure to uninstall the complete product installation, or individual components, in graphical mode:

1. Shut down any servers that are running. If any of these servers is configured as a Windows service, you should stop the service(s) before uninstalling the software.
2. Start the uninstallation program as described in Table 8-1.

Table 8-1 Starting the Uninstallation Program in Graphical Mode
To start the uninstallation program on this platform . . . | Perform the following steps . . .
--- | ---
Windows | From the Windows Start menu, choose StartProgramsBEA ProductsUninstall BEA Products. The BEA Products Uninstaller Welcome window is displayed. Proceed to step 3.
UNIX | Go to the following directory: `WLRT_HOME``/uninstall` Here `WLRT_HOME` represents the directory in which you installed your WebLogic Real Time software. Enter `uninstall.sh` at the prompt. The BEA Products Uninstaller Welcome window is displayed.
Note: | If your system supports a graphical user interface, the uninstallation program starts in graphical mode. If your system does not support a graphical user interface, the uninstallation program starts in console mode. If console mode is started, see Uninstalling Your Software in Console Mode for instructions.

3. Click Next to start the uninstall program.

The Choose Components window is displayed.

4. Select the components to uninstall by selecting or clearing the appropriate check boxes. Then click Next. By default, all installed components are selected, indicating that they will be removed.
5. Optionally, click Details to view the log file that lists the uninstalled components.
6. Click Done in the Uninstalling BEA Products window to exit the uninstallation program.

## Uninstalling Your Software in Console Mode

Use the following procedure to uninstall the complete product installation, or individual components, using the command-line interface:

1. Shut down any servers that are running. If any of these servers is configured as a Windows service, you should stop the service(s) before uninstalling the software.
2. Start the uninstallation program as described in Table 8-2.

Table 8-2 Starting the Uninstallation Program in Console Mode
To start the uninstallation program on this platform . . . | Perform the following steps . . .
--- | ---
Windows | Open a Command Prompt window and go to the following directory: `WLRT_HOME``\uninstall` Here `WLRT_HOME` represents the directory in which you installed your WebLogic Real Time software, typically`C:\bea\realtime10`. Enter the following command at the prompt: `uninstall -mode=console` The Welcome text is displayed.
UNIX | Go to the following directory: `WLRT_HOME``/uninstall` Here `WLRT_HOME` represents the directory in which you installed WebLogic Server. At the prompt, enter the following command: `sh uninstall.sh -mode=console` The Welcome text is displayed.

3. Press Enter or type `next` to proceed to the next panel of the uninstallation program.

Note: | Instead of typing complete words when you want to enter `[Exit]`, `[Previous]`, and `[Next]`, you can use the following one-letter shortcuts: `x`, `p`, and `n`, respectively.

The Choose Components to uninstall panel is displayed.

4. Select the components you want to uninstall. The available components are displayed as follows:

    Check the BEA Products components you want to uninstall.

    Release 9.x.x.x
    +----WebLogic Real Time [1] v
    |    +----WebLogic Real Time [1.1] v
    +----WebLogic Server [1] v
    |    +----Server [1.1] v
    |    +----Server Examples [1.2] v
    |    +----Web Server Plug-Ins [1.3]

    Enter number exactly as it appears in brackets to toggle selection OR
     [Exit][Previous][Next]>

By default, all installed components are selected, indicating that they will be removed.

To leave a component installed on your system, type the numeric code for that component on the command line, exactly as it appears within the brackets. For example, to uninstall only the Server Examples and the Web Server Plug-ins, and keep the Server installed on your system, enter `1.1` on the command line. The check mark (Windows systems) or `x` (UNIX systems) beside the entry for Server is cleared, indicating that it will not be uninstalled. The Server Examples and the Web Server Plug-ins will be uninstalled.

Dependency checking is performed to ensure that you do not uninstall a component that is required by another component.

5. Press Enter or type `next` to proceed with the uninstallation process.
6. When the uninstallation process is complete, press Enter or type `exit` to complete the uninstallation and exit the uninstallation program.

## Uninstalling Your Software in Silent Mode

When you uninstall your BEA Products software in silent mode, the complete installation of your software is uninstalled.

When you run the uninstallation program in silent mode, it leaves behind the same files and directories as when you run the uninstallation program in graphical and console modes, including:

- The BEA Home directory, including the `logs` and `utils` subdirectories
- The JDK, if it was installed with your BEA product installation
- Domain directories, including those in `user_projects`
- Any other file created or modified after your BEA software was installed

You can manually delete these files.

Although you can use silent-mode uninstallation to manually uninstall your software, silent-mode uninstall is intended for use in scripts. You can adapt the steps in Table 8-3 for use in scripts.

Use the following procedure to uninstall your BEA Products software in silent mode:

1. Shut down any servers that are running. If you configured any of the servers as a Windows service, you must stop the service(s) before uninstalling the software.
2. Start the uninstallation program as described in Table 8-3.

Table 8-3 Starting the Uninstallation Program in Silent Mode
To start the uninstallation program on this platform . . . | Perform the following steps . . .
--- | ---
Windows | Open a Command Prompt window and go to the following directory: `WLRT_HOME\uninstall` Here `WLRT_HOME` represents the directory in which you installed your WebLogic Real Time software, typically `C:\bea\realtime10.` Enter the following command at the prompt: `uninstall -mode=silent`
UNIX | Go to the following directory: `WLRT_HOME``/uninstall` Here `WLRT_HOME` represents the directory in which you installed WebLogic Real Time. At the prompt, enter the following command: `sh uninstall.sh -mode=silent`

Notes: | When you run the uninstallation program in silent mode, no messages are displayed indicating the uninstallation is in progress or has completed successfully, even if errors are encountered.

Note: | You can also include the `-log=``full_path_to_log_file` option in the command line to create a verbose installation log. For example:

Note: | `uninstall -mode=silent -log=C:\logs\weblogic_uninstall.log`

Note: | For more information, see Generating a Verbose Installation Log.

## Reinstalling Your Software

You cannot reinstall the same version of any BEA product on top of a previously installed version of the same product—in the same BEA Home directory or in the same file location. You can, however, add products and product components to an existing installation. For example, you can install WebLogic Server during one installation, and AquaLogic Service Bus during a separate installation.

To reinstall the same version of one of the product components or the entire BEA Products distribution in the same location, you must first uninstall the previous installation.

If you try to install a complete copy of the BEA Products software in a BEA Home directory that already contains a complete installation, an error message is displayed. Click or type `OK` to return to the Choose BEA Home directory prompt.

At the prompt, choose one of the following options:

- To continue installing the software using a different BEA Home directory, select an existing BEA Home directory that does not contain a previous installation, or create a new BEA Home directory.
- Exit the installation program. If you want to reinstall your BEA Products software in the same BEA Home, you must uninstall the previous installation. You can invoke the uninstall program appropriate for your platform, as described in one of the following sections:

- Uninstalling Your Software in Graphical Mode
- Uninstalling Your Software in Console Mode
- Uninstalling Your Software in Silent Mode

Then reinstall the software as described in Starting the Installation Program.