bea.com | products | dev2dev | support | askBEA

Download Docs | Site Map | Glossary
Search

Installation Guide

Uninstalling WebLogic Server

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

- About the Uninstallation Program

- Uninstalling Service Packs and Rolling Patches with the Uninstallation Program

- Uninstalling a Service Pack or Rolling Patch with Smart Update

- Reinstalling WebLogic Server

About the Uninstallation Program

On both Windows and UNIX systems, you can uninstall WebLogic Server 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, the uninstallation program automatically starts in console mode.

You can uninstall WebLogic Server examples only, or the entire WebLogic Server installation. Uninstalling WebLogic Server does not remove the BEA Home directory associated with the installation, or the SDK. If you choose to uninstall the entire WebLogic Server installation, the uninstallation program also removes the WebLogic Server 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.

If you have installed a service pack or rolling patch, you can also use the uninstallation program to revert to a prior service pack. See Uninstalling WebLogic Server in Graphical Mode.

Note: If you installed WebLogic Server with additional WebLogic Platform components, refer to the WebLogic Platform Installation Guide for information about uninstalling WebLogic Platform components.

Uninstalling WebLogic Server in Graphical Mode

Use the following procedure to uninstall WebLogic Server or WebLogic Server examples using the graphical interface:

1. Shut down any servers that are running. If you configured any of the servers as a Windows service, you should stop the service(s) before uninstalling the software.

2. Start the uninstallation program as described in the 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 Start—>Programs—>BEA WebLogic Platform 7.0—>Uninstall WebLogic Platform 7.0. The WebLogic Platform Uninstaller Welcome window is displayed. Proceed to step 3 following this table.
   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 Server. 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. Refer to the Uninstalling WebLogic Server 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 or you can completely uninstall WebLogic Server. To uninstall WebLogic Server, select Uninstall WebLogic Server and continue to the next step. If you want to uninstall a service pack or rolling patch, see Uninstalling a WebLogic Server 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 Server in Console Mode

Use the following procedure to uninstall WebLogic Server or WebLogic Server examples 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 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 | 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 Server, 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 Server. 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 uninstall WebLogic Server completely or you can roll back your system installation to the previous service pack. To uninstall WebLogic Server, 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 WebLogic Server 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
   >         +----WebLogic Server  [0] v
   >              +----Server  [0.0] v
   >              +----Workshop  [0.1] v
   >              +----Server Examples  [0.2] 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 the option on the command line exactly as it appears within the brackets. For example, type 0.0 to deselect the Server and keep it installed on your system.

   Dependency checking in the uninstallation program verifies that if you select a component to uninstall, all other components that are dependent on the selected component are also selected for uninstallation. For example, if you choose to uninstall the Server component, the uninstaller also uninstalls the Workshop and Server Examples components.

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 Server in Silent Mode

When you uninstall WebLogic Server in silent mode, the full installation of WebLogic Server 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 Server

- Domain directories, including those in user_projects

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

You can manually delete these files.

Although you can use silent-mode uninstallation to manually uninstall WebLogic Server, 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 WebLogic Server or WebLogic Server examples 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 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 | 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 Server, 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 Server. 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 be to a file. All folders in the path must exist before you execute the command or the installation program will not create the log file.

Uninstalling Service Packs and Rolling Patches with the Uninstallation Program

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 installed WebLogic Server 7.0, then installed Service Pack 1 (SP1), you can revert to WebLogic Server 7.0. If you have WebLogic Server 7.0 SP1 installed on your system and you upgrade to WebLogic Server 7.0 SP2 (when available), you can revert only to WebLogic Server 7.0 SP1, you cannot revert to WebLogic Server 7.0.

- You can revert rolling patch upgrades 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 installed WebLogic Server 7.0 SP1, then installed rolling patches 1 and 2 (RP1 and RP2), you can revert to WebLogic Server 7.0 SP1. You cannot revert to an earlier rolling patch.

For instructions, see Uninstalling a WebLogic Server Service Pack or Rolling Patch in Graphical Mode or Uninstalling a WebLogic Server Service Pack or Rolling Patch in Console Mode.

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 Server, you can use the uninstallation program or Smart Update. See Uninstalling a Service Pack or Rolling Patch with Smart Update for instructions to use Smart Update to roll back to a previous installation.

Uninstalling a WebLogic Server Service Pack or Rolling Patch in Graphical Mode

Use the following procedure to uninstall a WebLogic Server service pack or rolling patch. You can also use Smart Update to uninstall a service pack or rolling patch. See Uninstalling a Service Pack or Rolling Patch with Smart Update.

1. Shut down any servers that are running. If you configured any server as a Windows service, stop the service(s) before uninstalling the software.

2. Start the uninstallation program as described in the Table 8-1.

   The WebLogic Server 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 on the status window.

Uninstalling a WebLogic Server Service Pack or Rolling Patch in Console Mode

Use the following procedure to uninstall a WebLogic Server service pack or rolling patch. You can also use Smart Update to uninstall a service pack or rolling patch. See Installing Service Packs and Rolling Patches Using Smart Update.

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

Uninstalling a Service Pack or Rolling Patch with Smart Update

You can use Smart Update to 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 installed WebLogic Server 7.0, then installed Service Pack 1 (SP1), you can revert to WebLogic Server 7.0. If you have WebLogic Server 7.0 SP1 installed on your system and you upgrade to WebLogic Server 7.0 SP2, you can revert only to WebLogic Server 7.0 SP1, you cannot revert to WebLogic Server 7.0.

- You can revert rolling patch upgrades 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 installed WebLogic Server 7.0 SP1, then installed rolling patches 1 and 2 (RP1 and RP2), you can revert to WebLogic Server 7.0 SP1. You cannot revert to an earlier rolling patch.

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.

You can also uninstall a service pack or rolling patch using the standard uninstallation process. For more information, see Uninstalling WebLogic Server in Graphical Mode.

To uninstall a service pack or rolling patch, follow these instructions:

1. Start Smart Update as described in Table 6-1.

2. In the left pane, select the release for the product you want to roll back.

   Service packs and rolling patches that you can uninstall (or roll back) are displayed in the Downgrade Options section of the window.

3. In the Downgrade Options pane, select the service pack or rolling patch to uninstall and click OK.

   The BEA Uninstaller Program opens.

4. Click Next to proceed.

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

5. Click Done on the status window.

   The Smart Update window is displayed.

Reinstalling WebLogic Server

You cannot reinstall the same major version of WebLogic Server or any of its components over a previous WebLogic Server 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 Server Examples or additional WebLogic Platform components during separate installations.

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

If you attempt to install a copy of WebLogic Server 7.0 in the same BEA Home as a previous installation of WebLogic Server 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.

Type or click 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 Server installation or create a new BEA Home directory.

- Exit the installation program. If you want to reinstall WebLogic Server 7.0 in the same BEA Home, you must uninstall the previous installation. You can invoke the uninstall program as described in one of the following sections:

  - Uninstalling WebLogic Server in Graphical Mode

  - Uninstalling WebLogic Server in Console Mode

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

  - Installing WebLogic Server Using Graphical-Mode Installation

  - Installing WebLogic Server Using Console-Mode Installation

  - Installing WebLogic Server Using Silent-Mode Installation