Sun Java System Web Server 7.0 Update 1 Installation and Migration Guide

Chapter 4 Uninstalling the Web Server

This chapter describes how to uninstall the Web Server software, and contains the following sections:

Selecting the Uninstallation Mode

There are three uninstallation modes: graphical, command-line, and silent. Use the uninstall command to specify the uninstallation mode. The syntax is as follows:

./uninstall [--help] [--console] [--silent] [--javahome java_dir][--saveinstances]

If you run the uninstall command without options, the uninstallation programs runs in graphical mode.

The following table lists the uninstall command options.

Table 4–1 Options for the uninstall Command

Option 

Description 

./uninstall --help

Displays the options for the uninstall command.

./uninstall

Runs the uninstaller in graphical mode. 

./uninstall --console

Runs the uninstaller in command-line mode. 

./uninstall --silent

Runs the uninstaller in silent mode. 

./uninstall --javahome java_dir

Defines the location of the JDK installation that should be used for the uninstaller JVM, in graphical mode. 

./uninstall --console --javahome java_dir

Defines the location of the JDK installation that should be used for the uninstaller JVM, in command-line mode. 

./uninstall --saveinstances

Captures configuration information for a server instance before it is uninstalled, in command-line mode. All configuration information is removed during the uninstall process in silent mode. In all other modes, you are prompted during the uninstall process.

Uninstalling in Graphical Mode

The graphical interface is an interactive graphical wizard that walks through the uninstallation process. This is the default mode when the uninstallation program is started without options (./uninstall).

General navigation is as follows:


Note –

On UNIX systems, the uninstallation interface defaults to command-line mode if the DISPLAY environment variable has not been exported to your local machine and if X Windows is not supported. To uninstall in command-line mode, follow the instructions in Uninstalling in Command-Line Mode.


ProcedureTo Uninstall in Graphical Mode

  1. Navigate to the bin directory in the Web Server installation directory (by default, /sun/webserver7/bin on UNIX, and C:\Program Files\Sun\WebServer7\bin on Windows).

  2. Start the uninstallation program

    • (UNIX) Type ./uninstall.

    • (Windows) Double-click uninstall.exe or type uninstall from the command line. You can also use the Control Panel > Add or Remove Programs option, or use Start > Programs > Sun Microsystems > Web Server 7.0 > Uninstall.

    The uninstallation wizard appears.

  3. Click Next, and then specify whether to save instance configuration information.

    Selecting Save Instances (not selected by default) retains all the server instance directories in the Web Server's install_dir. Saving instances allows you to reuse the configurations by copying them to the config-store of the new Administration Server

  4. Click Next, and then Uninstall Now to proceed with the uninstallation.

    A progress bar shows status. Following uninstallation, a summary page displays. Click Details for more information, or Close to exit the uninstallation wizard.

Uninstalling in Command-Line Mode

The command-line interface is an interactive, text-based interface that prompts for responses in a terminal window. To activate the command-line mode, start the uninstallation program using the --console option (./uninstall --console).

ProcedureTo Uninstall in Command-Line Mode

  1. Navigate to the bin directory in the Web Server installation directory (by default /sun/webserver7/bin on UNIX, and C:\Program Files\Sun\WebServer7\bin on Windows).

  2. Start the uninstallation program with the following command:

    • (UNIX) ./uninstall --console

    • (Windows) uninstall --console

    The command-line uninstall interface displays.

  3. Select Uninstall Now to proceed with the installation.

Uninstalling in Silent Mode

Viewing Uninstallation Log Files

Log files are created during the uninstallation process. All uninstallation steps are logged, providing valuable troubleshooting information.

Uninstall Log

The uninstall log file is located as follows: install_dir/setup/Sun_Java_System_Web_Server_uninstall.log.

Uninstall log file entries contain information about the attempted action, the outcome of the action, and the cause of failure if applicable. Entries fall into three categories: INFO, WARNING, and ERROR. The following table describes each category.

Table 4–2 Uninstall Log Entry Categories

Category 

Description 

INFO

Marks normal completion of a particular uninstallation task. 

WARNING

Marks non-critical failures. Warning-level messages contain information about the cause and nature of the failure, and point to possible remedies.  

ERROR

Marks critical failures and reports the uninstallation status as failed. Error-level messages provide detailed information about the nature and cause of the problem. 

Low-Level Uninstall Log

Low-level uninstall logs are located as follows, where timestamp is of the format mmddHHMM.