After you have completed the relevant tasks in Uninstallation Prerequisites, you are ready to run the uninstaller. This section contains information on the three ways in which the uninstaller can be used.
Information on syntax of the uninstall command can be found in Appendix B, Installation Commands.
This section provides instructions for using the interactive graphical interface to uninstall the Java ES components.
(Optional) Provide access to your local display.
If you are logging in to a remote machine, make sure your DISPLAY environment variable is properly set to the local display. If the DISPLAY variable is not set properly, the installer runs in text-based mode.
Example for C Shell (machine name myhost):
setenv DISPLAY myhost:0.0 |
Example for Korn Shell (machine name myhost):
DISPLAY=myhost:0.0 |
You might need to grant display authorization to run the installer on your local display. For example, you can use the following command to grant display authority from myhost to the root user on serverhost:
myhost\> xauth extract - myhost:0.0|rsh -l root serverhost xauth merge - |
For full instructions on granting such authorization safely, refer to the “Manipulating Access to the Server” chapter in the Solaris X Window System Developer's Guide.
If you are not logged in as root, become superuser.
Navigate to the directory where the uninstaller is located:
Solaris OS: /var/sadm/prod/SUNWentsys4
Linux: /var/sadm/prod/sun-entsys4
Start the graphical uninstaller:
./uninstall |
The Welcome page is displayed.
Click Next to proceed.
The Select Components page is displayed.
Examine the components and select those you want to uninstall.
Components that are installed on your system are enabled and can be selected. Components that are not installed on your system are disabled and cannot be selected.
Some components contain subcomponents. Expand the components to view the subcomponents.
If you deselect a component that contains subcomponents, expand the component to verify the subcomponent list.
After you are satisfied with your selections, click Next.
If the uninstaller detects any recognizable component dependencies, or potential loss of configuration data among the products selected, a warning is displayed. Your choices are:
Depending on the components you selected for removal, the uninstaller prompts you for administrator IDs and passwords. For details on the information you must provide the uninstaller, refer to Granting Administrator Access for the Uninstaller.
In addition, the uninstaller might also prompt you for a port number or a host name.
Provide the required administrator information.
Click Next to proceed to the Ready To Uninstall page.
Before removing software from your system, the uninstaller lists the components you have selected for removal and the total disk space that will be reclaimed.
Review the uninstallation selections you have made.
If changes are needed, click Back through successive pages until the Component Selection page is displayed.
Make changes as needed on the Component Selection page.
Click Next to proceed again through the uninstaller pages.
The uninstaller remembers previously-specified values. You can modify any value you previously specified.
Click Next when you are satisfied with your selections.
The uninstaller begins removing software from your system and displays the following:
A progress bar that displays the overall completion percentage
The name of the package currently being removed
After all component software has been removed, the uninstaller displays the Uninstallation Complete page.
Click View Summary or View Log for information about the uninstallation.
Uninstallation summary. Shows the components that were uninstalled and a list of configuration information for the components.
Uninstallation log. Shows all messages that were generated by the uninstaller during uninstallation.
You can also review the uninstallation summary and log files:
On Solaris OS: /var/sadm/install/logsOn Linux: /var/opt/sun/install/logs
Click Close to exit the uninstaller.
If you installed Access Manager or Messaging Server, go to Post-uninstallation Tasks.
The text-based interface allows you to run the uninstaller directly from a terminal window by responding to prompts displayed in the window.
Refer to How to Use the Text-Based Interface to learn about text-based prompts for uninstallation.
If you have problems during uninstallation, refer to Chapter 9, Troubleshooting.
If you are not logged in as root, become superuser.
Navigate to the uninstaller directory:
Solaris OS: /var/sadm/prod/SUNWentsys4
Linux: /var/sadm/prod/sun-entsys4
Run the uninstaller:
./uninstall -nodisplay |
The Welcome message is displayed followed by a list of all possible Java ES components on your system.
The uninstaller selects for removal any Java ES components it finds on your system by listing the numbers corresponding to the installed components. Press Return to uninstall all components.
Alternately, choose specific components by typing a comma-separated list of the numbers corresponding to the components you want to uninstall, and press Return.
Components that are not installed on your system are disabled and cannot be chosen.
If the uninstaller detects component dependencies among the products selected for removal, a warning about a potential loss of configuration data is displayed. Your choices are:
If you selected a component for which the uninstaller needs an administrative ID or password, the uninstaller prompts you for administrator IDs and passwords.
For details on the information you must provide the uninstaller, refer to Granting Administrator Access for the Uninstaller.
Depending on the components you selected for removal, the uninstaller might also prompt you for a port number or a host name.
Before removing software from your system, the uninstaller displays a summary page, showing the components selected for removal.
Review your selections.
When you are satisfied with your selections, type the number 1 and press Return.
The uninstaller begins removing software from your system. During uninstallation, the uninstaller displays a progress bar that displays the overall completion percentage.
After all component software has been removed, you can view the uninstallation summary and log.
Type 1 or 2 and press Return to see information about the uninstallation.
Uninstallation summary. Type 1 to see the components that were uninstalled and a list of configuration information for the components.
Uninstallation log. Type 2 to list all messages that were generated by the uninstaller during uninstallation.
You can also view the uninstallation summary and log files:
Solaris OS: /var/sadm/install/logsLinux: /var/opt/sun/install/logs
Type the ! character to exit the uninstaller.
Go to Post-uninstallation Tasks if you uninstalled Access Manager or Messaging Server.
Silent uninstallation is useful for uninstalling Java ES components on multiple hosts that share similar configurations. The procedure for uninstalling in silent mode is similar to the procedure for installing in silent mode as described in Chapter 5, Installing in Silent Mode.
To perform a silent uninstallation, you must first generate a state file by running a false uninstallation in either graphical or text-based mode. Refer to Generating a State File.
If you are not logged in as root, become superuser.
Navigate to the uninstaller directory:
Solaris OS: /var/sadm/prod/SUNWentsys4
Linux: /var/sadm/prod/sun-entsys4
If you are using the graphical interface of the uninstaller, provide access to your local display. See Running the Uninstaller in Graphical Mode.
Run the silent uninstaller. For example:
Graphical mode:
./uninstall -no -saveState statefile_path |
Text-based mode:
./uninstall -no -nodisplay -saveState statefile_path |
To see the full syntax for the uninstall command, refer to Uninstall Command.
Proceed through the uninstaller to completion.
As you respond to the prompts, the uninstaller records your answers in the specified state file. When you complete the uninstallation, the state file is available in the location that you specified. No software has been uninstalled.
Make a copy of the state file for each host on which you are going to perform a silent uninstallation.
Edit each file providing information specific to the host where you will run that silent uninstallation.
For guidelines on editing state files, refer to Editing the State File. Editing the state file might also include generating a state file ID, as explained in Creating a Platform-Appropriate State File ID.
Verify that you have properly prepared and edited the state file for the host where you want to uninstall Java ES components.
Open a terminal window.
If you are not logged in as root, become superuser.
Navigate to the uninstaller directory:
Solaris OS: /var/sadm/prod/SUNWentsys4
Linux: /var/sadm/prod/sun-entsys4
Start the uninstaller. For example:
./uninstall -noconsole -state statefile_path |
To see the full syntax for the uninstall command, refer to Uninstall Command.
In a terminal window, navigate to the log file directory:
On Solaris OS: /var/sadm/install/logsOn Linux: /var/opt/sun/install/logs
Locate the log files for the current uninstallation. The log file of interest for monitoring purposes is:
Java_Enterprise_System_uninstall.Btimestamp |
The timestamp variable represents the time the log was created. The variable has the following format MMddhhmm, where:
MM |
Specifies the month |
dd |
Specifies the date |
hh |
Specifies the hour |
mm |
Specifies the minute |
Use the tail command to watch messages as they are written to the logs. For example:
tail -f logfile_name |
To exit the tail program, press Ctrl+C.