After you have completed the relevant tasks in Verifying Prerequisites and planned for component uninstallation behavior, 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 product 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/SUNWentsys5
Linux and HP-UX: /var/sadm/prod/sun-entsys5
Start the graphical uninstaller:
./uninstall |
The Welcome page is displayed.
Click Next to proceed.
The Select Components page is displayed.
Examine the product components and select those you want to uninstall.
Product components that are installed on your system are enabled and can be selected. Product components that are not installed on your system are disabled.
Some product components contain subcomponents. Expand the product components to view the subcomponents.
After you are satisfied with your selections, click Next.
Resolve configuration or dependency issues.
If the uninstaller detects any recognizable product component dependencies, or potential loss of configuration data among the products selected, warnings are displayed. Your choices are:
If unconfigure pages are displayed, enter the information requested for the product component.
Depending on the product 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 product components you have selected for removal and the total disk space that will be reclaimed.
Review the uninstallation selections you have made and make any changes needed as follows:
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
The Uninstallation Complete page displays after all product component software has been removed.
Click View Summary or View Log for information about the uninstallation.
Uninstallation summary. Shows the product components that were uninstalled and a list of configuration information for the product components.
Uninstallation log. Shows all messages that were generated by the uninstaller during uninstallation.
You can also review the uninstallation summary and log files:
Solaris OS: /var/sadm/install/logsLinux and HP-UX: /var/opt/sun/install/logs
Click Close to exit the uninstaller.
If you uninstalled Access Manager or Service Registry, go to Completing 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. For usage guidelines, refer to How to Use the Text-Based Interface.
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/SUNWentsys5
Linux and HP-UX: /var/sadm/prod/sun-entsys5
Run the uninstaller:
./uninstall -nodisplay |
The Welcome message is displayed followed by a list of all possible Java ES product components on your system.
The uninstaller selects for removal any Java ES product components it finds on your system by listing the numbers corresponding to the installed product components. Product components that are not installed on your system are disabled and cannot be chosen. You can choose to uninstall all installed components, or select only some of the installed components for uninstallation.
Choose product components for uninstallation.
To uninstall all installed product components, press Return.
To choose specific product components, type a comma-separated list of the numbers corresponding to the product components you want to uninstall, and press Return.
Resolve configuration or dependency issues.
If the uninstaller detects product component dependencies among the products selected for removal, warnings about a potential loss of configuration data are displayed. Your choices are:
If unconfigure pages are displayed, enter the information requested for the product component.
If you selected a product 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 product 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 product 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 product 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 product components that were uninstalled and a list of configuration information for the product 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 and HP-UX: /var/opt/sun/install/logs
Type the ! character to exit the uninstaller.
If you uninstalled Access Manager or Service Registry, go to Completing Post-uninstallation Tasks.
Silent uninstallation is useful for uninstalling Java ES product 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 an interactive uninstallation session in either graphical or text-based mode. For more information, refer to Generating the Initial State File.
If you are not logged in as root, become superuser.
Navigate to the uninstaller directory:
Solaris OS: /var/sadm/prod/SUNWentsys5
Linux and HP-UX: /var/sadm/prod/sun-entsys5
If you are using the graphical interface of the uninstaller, you might need to provide access to your local display. See Running the Uninstaller in Graphical Mode.
Run the silent uninstaller. For example:
Include the –no option if you do not want to uninstall software in this session.
Graphical mode:
./uninstall -saveState statefile_path |
Text-based mode, software not uninstalled:
./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. If you used the –no option, no software was 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 product components.
If you are not logged in as root, become superuser.
Navigate to the uninstaller directory:
Solaris OS: /var/sadm/prod/SUNWentsys5
Linux and HP-UX: /var/sadm/prod/sun-entsys5
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:
Solaris OS: /var/sadm/install/logsLinux and HP-UX: /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_5_uninstall.Btimestamp |
The timestamp variable represents the time the log was created. The variable has the following format MMddhhmm, where:
Specifies the month
Specifies the date
Specifies the hour
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.