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:

Click Back to return to the previous screen.
Click Next to move to the next screen.
Click Cancel to cancel the installation.
Click Help to display documentation specific to the current screen.

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.

To Uninstall in Graphical Mode

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

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.

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

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

To Uninstall in Command-Line Mode

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

Start the uninstallation program with the following command:
- (UNIX) ./uninstall --console
- (Windows) uninstall --console
The command-line uninstall interface displays.

Select Uninstall Now to proceed with the installation.

Uninstalling in Silent Mode

From the command line, navigate to the bin directory in the Web Server installation directory (/sun/webserver7/bin by default on UNIX and C:Program Files\Sun\WebServer7\bin on Windows), and start the uninstallation program with the following command:
- (UNIX)./uninstall --silent
- (Windows) uninstall --silent
- Note –
  Use ./uninstall --saveinstances –console if you want to capture instance configuration information before the instance is uninstalled. Otherwise, all configuration information is removed during the uninstall process.

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.

Solaris (root installation)

/var/sadm/install/logs/Sun_Java_System_Web_Server_uninstall.timestamp
Solaris (non-root installation)

/var/tmp/Sun_Java_System_Web_Server_uninstall.timestamp
Linux, HP-UX, AIX

/var/tmp/Sun_Java_System_Web_Server_uninstall.timestamp
Windows

%tmp%\Sun_Java_System_Web_Server_uninstall.timestamp