bea.com | products | dev2dev | support | askBEA

Download Docs | Site Map | Glossary
Search

Installing WebLogic Platform

Uninstalling WebLogic Platform

The following sections provide platform-specific procedures for uninstalling WebLogic Platform:

- About the Uninstallation Program

- Uninstalling WebLogic Platform in Graphical Mode

- Uninstalling WebLogic Platform in Console Mode

- Uninstalling WebLogic Platform in Silent Mode

- Reinstalling WebLogic Platform

About the Uninstallation Program

The following sections describe how to uninstall WebLogic Platform on Windows and UNIX systems. You can uninstall WebLogic Platform using graphical mode, console mode, 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 WebLogic Platform, or the entire installation. Uninstalling WebLogic Platform does not remove the BEA Home directory associated with the installation, the JVM, 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 WebLogic Platform installation, the uninstallation program also removes the WebLogic Platform product directory associated with the installation unless one of the following is true:

- The product directory contains customer-created configuration or application files—the uninstallation program does not delete customer-created configuration or 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 uninstall was invoked from within the product directory structure—specifically, within the uninstaller directory.

Uninstalling Service Packs and Rolling Patches

If you have installed a service pack or rolling patch, you can revert your system installation to an earlier version of the release as follows:

- You can revert to the prior service pack installation on your system. For example, if you first install WebLogic Platform 7.0, and then install Service Pack 1 (SP1), you can later revert to WebLogic Platform 7.0. Similarly, if you have WebLogic Platform 7.0 SP1 installed on your system and you upgrade to WebLogic Platform 7.0 SP2, you can revert only to WebLogic Platform 7.0 SP1; you cannot revert to WebLogic Platform 7.0.

- You can revert a rolling patch upgrade to the prior service pack on which the rolling patch is based. (Rolling patches are cumulative: each rolling patch replaces all earlier rolling patches on a particular service pack base.) For example, if you first install WebLogic Platform 7.0 SP2, and then install rolling patches 1 and 2 (RP1 and RP2), you can later revert to WebLogic Platform 7.0 SP2. You cannot revert to an earlier rolling patch, however.

Note: If you install additional WebLogic Platform components after installing a service pack or rolling patch, you cannot roll back to any previous versions of the product.

To revert to a previously installed version of WebLogic Platform, you can use the uninstallation program or Smart Update. See Uninstalling Maintenance Upgrades Using Smart Update for instructions on using Smart Update to roll back to a previous installation.

Uninstalling WebLogic Platform in Graphical Mode

Use the following procedure to uninstall WebLogic Platform 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 7-1.

   Table 7-1 Starting the Uninstallation Program in Graphical Mode

   To start the uninstallation program on this platform . . . | Perform the following steps . . .
   --- | ---
   Windows | 1. From the Windows Start menu, choose Start—>Programs—>BEA WebLogic Platform 7.0—>Uninstall WebLogic Platform 7.0. The WebLogic Platform Uninstaller Welcome window is displayed. 2. Proceed to step 3.
   UNIX | 1. Open a command shell and go to the following directory: WL_HOME/uninstall where WL_HOME represents the directory in which you installed WebLogic Platform. 2. Enter uninstall.sh at the prompt. The WebLogic Platform 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 WebLogic Platform in Console Mode for instructions.

3. Click Next to start the uninstall program.

   One of the following windows is displayed:

   - The Choose Components window—go to step 4.

   - The Select Uninstall Type window—If you have installed a service pack or rolling patch, you can roll back your system installation to the previous service pack. To uninstall WebLogic Platform, select Uninstall WebLogic Platform and continue to the next step. If you want to uninstall a service pack or rolling patch, see Uninstalling a Service Pack or Rolling Patch in Graphical Mode.

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. Click Done in the Uninstalling WebLogic Platform 7.0 window to exit the uninstallation program.

Uninstalling WebLogic Platform in Console Mode

Use the following procedure to uninstall WebLogic Platform 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 7-2.

   Table 7-2 Starting the Uninstallation Program in Console Mode

   To start the uninstallation program on this platform . . . | Perform the following steps . . .
   --- | ---
   Windows | 1. Open an MS-DOS command prompt window and go to the following directory: WL_HOME\uninstall where WL_HOME represents the directory in which you installed WebLogic Platform, typically C:\bea\weblogic700. 2. Enter the following command at the prompt: uninstall -mode=console The Welcome text is displayed.
   UNIX | 1. Open a command shell and go to the following directory: WL_HOME/uninstall where WL_HOME represents the directory in which you installed WebLogic Platform. 2. 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.

   One of the following panels is displayed:

   - The Choose Components panel—go to step 4.

   - The Uninstall Options panel—If you have installed a service pack or rolling patch, you can roll back your system installation to the previous service pack. To uninstall WebLogic Platform, type 1 at the prompt and press Enter, then continue to the next step. If you want to uninstall a service pack or rolling patch, see Uninstalling a Service Pack or Rolling Patch in Console Mode.

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

   >     Choose Components:

   >         Release 7.0.X.0
   >         |----WebLogic Server  [0] v
   >         |    +----Server  [0.0] v
   >         |    +----Workshop  [0.1] v
   >         |    +----Server Examples  [0.2] v
   >         |----WebLogic Integration  [1] v
   >         |    +----Integration Server  [1.0] v
   >         |    +----Integration Examples  [1.1] v
   >         |    +----Client only  [1.2] v
   >         |----WebLogic Portal  [2] v
   >         |    +----Portal Server  [2.0] v
   >         |    +----Portal Examples  [2.1] v
   >         |    +----EBCC  [2.2] v
   >         |----Platform Samples and Utilities  [3] v
   >         |    +-----QuickStart  [3.0] v
   >         |    +-----Platform Tour  [3.1] v

   >     Enter number exactly as it appears in brackets to toggle
   >      selection OR [Exit][Previous][Next]> 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. Dependency checking is performed to ensure that you do not uninstall a component that is required by another component. For example, to keep WebLogic Server and WebLogic Workshop installed on your system, enter 0 on the command line. The check mark (Windows systems) or x (UNIX systems) beside the entries for WebLogic Server, Server, Workshop, and Server Examples are cleared, indicating that those components will not be uninstalled. The remaining components, WebLogic Integration and WebLogic Portal, are selected, indicating they will be uninstalled.

5. Press Enter or type next.

   You are prompted to confirm your selections, as shown in the following text:

   >     Choose Components:

   >        ->1¦ Yes, uninstall these component selections
   >          2¦ No, return to component selection

   >     Enter index number to select OR [Exit][Previous][Next]>

6. Press Enter or type next to proceed with the uninstallation process.

7. When the uninstallation process is complete, press Enter or type done to complete the uninstallation and exit the uninstallation program.

Uninstalling WebLogic Platform in Silent Mode

When you uninstall WebLogic Platform in silent mode, the full installation of WebLogic Platform is uninstalled. You cannot use silent-mode uninstallation to roll back to a previous service pack or to uninstall individual WebLogic Platform components.

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 GUI and console modes, including:

- The BEA Home directory, including the logs and utils subdirectories

- The Java 2 SDK, if it was installed with WebLogic Platform

- Domain directories, including those in user_projects

- Any other file created or modified since WebLogic Platform was installed

You can manually delete these files.

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

Use the following procedure to uninstall WebLogic Platform using the command line interface:

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 the Table 7-3.

   Table 7-3 Starting the Uninstallation Program in Silent Mode

   To start the uninstallation program on this platform . . . | Perform the following steps . . .
   --- | ---
   Windows | 1. Open an MS-DOS command prompt window and go to the following directory: WL_HOME\uninstall where WL_HOME represents the directory in which you installed WebLogic Platform, typically C:\bea\weblogic700. 2. Enter the following command at the prompt: uninstall -mode=silent
   UNIX | 1. Open a command shell and go to the following directory: WL_HOME/uninstall where WL_HOME represents the directory in which you installed WebLogic Platform. 2. 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.

To create a verbose log file during silent uninstallation, include the -log=full_path_to_log_file option in the command line. For example:

uninstall -mode=silent -log=D:\logs\weblogic_uninstall.log

The path must specify a file. You cannot create a folder simply by including a name for it in a pathname; your path should specify only existing folders. If your path includes a nonexistent folder when you execute the command, the installation program does not create the log file.

Uninstalling a Service Pack or Rolling Patch in Graphical Mode

Use the following procedure to uninstall a WebLogic Platform service pack or rolling patch. You can also use Smart Update to uninstall a service pack or rolling patch. See Uninstalling Maintenance Upgrades Using Smart Update.

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 the Table 7-1.

   The WebLogic Platform Uninstaller Welcome window is displayed.

3. Click Next to start the uninstall program.

   The Select Uninstall Type window is displayed.

4. Select the service pack to which you want to roll back your system installation, and click Next.

   A status window displays the progress of the uninstallation. A message is displayed when the rollback is complete.

5. Click Done in the status window.

Uninstalling a Service Pack or Rolling Patch in Console Mode

Use the following procedure to uninstall a WebLogic Platform service pack or rolling patch. You can also use Smart Update to uninstall a service pack or rolling patch. See Uninstalling Maintenance Upgrades Using Smart Update.

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 7-2.

   The Welcome text is displayed.

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

   The Uninstall Options panel is displayed:

4. At the prompt, type the number of the option for the service pack to which you want to roll back your system installation, and press Enter.

   Text messages indicate the progress of the uninstallation.

Reinstalling WebLogic Platform

You cannot reinstall the same version of WebLogic Platform or any of its components over a previous WebLogic Platform installation of the same components—in the same BEA Home directory or in the same file location. You can, however, add components to an existing installation. For example, you can install WebLogic Server during one installation, and WebLogic Integration or WebLogic Portal during separate installations.

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

If you attempt to install a copy of WebLogic Platform 7.0 in the same BEA Home directory as a previous installation of WebLogic Platform 7.0, the installation program displays the following message:

>     A complete installation of WebLogic Platform 7.0 exists in this BEA
>     Home. Please select another BEA Home or uninstall the product.

Click or type OK to return to the Choose BEA Home directory 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 WebLogic Platform installation or create a new BEA Home directory.

- Exit the installation program. If you want to reinstall WebLogic Platform 7.0 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 WebLogic Platform in Graphical Mode

- Uninstalling WebLogic Platform in Console Mode

Then reinstall the software as described in one of the following sections:

- Installing WebLogic Platform Using Graphical-Mode Installation

- Installing WebLogic Platform Using Console-Mode Installation

- Installing WebLogic Platform Using Silent-Mode Installation