Chapter 5
Uninstalling the Enterprise Edition Software

This chapter contains instructions for uninstalling the Sun ONE Application Server 7, Enterprise Edition software from your system.

The following topics are addressed here:

About Uninstalling
Uninstalling the Application Server Software
Uninstalling in Silent Mode (non-interactive)

---

About Uninstalling

The installation program enforces component dependencies as specified for each component. Once component dependencies are satisfied, component life cycles are independent. A particular component can be installed or uninstalled dynamically through incremental installation and partial uninstallation mechanisms without corrupting other components.

Uninstallation failure will result in a complete rollback of the installation, requiring you to reinstall the product.

Note	If an uninstallation fails, you may need to clean up some leftover files or processes before attempting a new installation. In this case, perform the tasks in "Uninstallation Failure Cleanup".

Components

The following components can be uninstalled separately or as a complete package:

Sun ONE Application Server, including its graphical and command-line administrative tools and Sun ONE Message Queue 3.0.1
Java 2 Software Development Kit (J2SE), Standard Edition 1.4.1_03
Sun ONE Application Server Administration Client (command-line tool only)
Sample applications
High-Availability Database (HADB)
Load balancer plug-in for web servers

Installation files, configuration files, and all log files are removed from local and remote hosts during installation.

Uninstallation Requirements

The following must be true for uninstallation to succeed:

All databases are stopped and disabled prior to uninstalling.

For guidelines on stopping the HADB, refer to the "Stopping the HADB".

All database hosts are reachable by SSH or RSH for the root user.

For instructions on setting this up HADB communications, refer to "Setting Up Host Communication".

The uninstallation program is run from the original installation host.

---

Uninstalling the Application Server Software

The uninstallation program detects any running Sun ONE Application Server processes and stops them before continuing to uninstall.

Note	If your J2SE is installed in a directory other than /usr/j2se, you must use the following command: ./uninstall -javahome valid_j2se_directory where valid_j2se_directory is the path to your J2SE 1.4.1_03 installation.

To uninstall the Application Server software, perform the following steps:

Verify that you have met the requirements in "Uninstallation Requirements".
Log in as root on the machine where you want to uninstall the Sun ONE Application Server 7, Enterprise Edition software.
Navigate to your machine’s Sun ONE Application Server 7 installation directory.
Select your installation method.
To run uninstallation using the graphical interface, type the following at the command prompt (no options; this is the default method):

./uninstall

To run uninstallation using the command-line interface, type:

./uninstall -console

The Welcome page of the uninstallation program is displayed.

Read the Welcome page and click Next (or press Enter at the command line) to continue.
You will be queried about whether you want to do an incremental uninstallation.
If you answer No, the Ready to Install page is displayed as shown in Step 7.
If you answer Yes, the component selection page is displayed showing the components that are installed on your system.
Select which components you want to uninstall and click Next (or press Enter at the command line).

The Ready to Uninstall page is displayed showing a list of the Application Server components you have selected to uninstall.

Click Uninstall Now (or press Enter on the command line) to start the uninstallation process.

The Uninstallation progress indicator bar is displayed.

When uninstallation finishes, the Uninstall Summary page is displayed.

Review the details by clicking Details.

A details listing displays the top portion of the log file. Complete information on the uninstallation can be found in the uninstallation log file specified at the end of the details listing:

/var/sadm/install/logs/Sun_ONE_Application_Server_uninstall.log

Click Dismiss to close the Details page.
Click Close (or press Enter at the command line) to quit the uninstallation program.
Verify that uninstallation succeeded by checking to see that the Application Server components have been removed from the system.

Note	If uninstallation is interrupted, or if you have trouble installing the Application Server software after removing a previous version or a component, refer to "Uninstallation Failure Cleanup".

---

Uninstalling in Silent Mode (non-interactive)

Note	The interactive methods allow you to select which components you want to uninstall; silent mode does not. That is, incremental, or partial, uninstallation is not available for silent mode.

To uninstall the Sun ONE Application Server software in non-interactive silent mode, perform these steps:

Log in as root on the machine where you want to uninstall the Application Server 7, Enterprise Edition software.
Start silent uninstallation at the command line as follows:

./uninstall -silent

When the prompt is returned, the silent uninstallation is completed.

Verify that uninstallation succeeded by checking to see that the Sun ONE Application Server components have been removed from the system.
Repeat this process for each server where you want to uninstall.

Previous      Contents      Index      Next

---

Copyright 2003 Sun Microsystems, Inc. All rights reserved.