test

Sun Java Enterprise System 5 Installation Guide for UNIX

Running the Uninstaller

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.

Running the Uninstaller in Graphical Mode

This section provides instructions for using the interactive graphical interface to uninstall the Java ES product components.

ProcedureTo Start the Graphical Uninstaller

  1. (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 -
    Note –

    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.

  2. If you are not logged in as root, become superuser.

  3. Navigate to the directory where the uninstaller is located:

    • Solaris OS: /var/sadm/prod/SUNWentsys5

    • Linux and HP-UX: /var/sadm/prod/sun-entsys5

  4. Start the graphical uninstaller:


    ./uninstall

    The Welcome page is displayed.

  5. Click Next to proceed.

    The Select Components page is displayed.

ProcedureTo Select Product Components to Uninstall

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

  2. After you are satisfied with your selections, click Next.

  3. 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:

    1. Click Continue to continue with uninstallation.

    2. Click Close to return to the Choose Software Components page.

  4. If unconfigure pages are displayed, enter the information requested for the product component.

ProcedureTo Grant Administrator Access

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.

Note –

In addition, the uninstaller might also prompt you for a port number or a host name.

  1. Provide the required administrator information.

  2. Click Next to proceed to the Ready To Uninstall page.

ProcedureTo Uninstall Software

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.

  1. Review the uninstallation selections you have made and make any changes needed as follows:

    1. Click Back through successive pages until the Select Components page is displayed.

    2. Make changes as needed page.

    3. Click Next to proceed again through the uninstaller pages.

      The uninstaller remembers previously-specified values. You can modify any value you previously specified.

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

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

  4. Click Close to exit the uninstaller.

  5. If you uninstalled Access Manager or Service Registry, go to Completing Post-uninstallation Tasks.

Running the Uninstaller in Text-Based Mode

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.

ProcedureTo Start the Uninstaller in Text-Based Mode

  1. If you are not logged in as root, become superuser.

  2. Navigate to the uninstaller directory:

    • Solaris OS: /var/sadm/prod/SUNWentsys5

    • Linux and HP-UX: /var/sadm/prod/sun-entsys5

  3. Run the uninstaller:


    ./uninstall -nodisplay

    The Welcome message is displayed followed by a list of all possible Java ES product components on your system.

ProcedureTo Select Product Components for Uninstallation

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.

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

  2. 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:

    1. Type Yes and press Return to continue with uninstallation.

    2. Type No and press Return to return to Component Selection.

    3. Type the character ! and press Return to exit the uninstallation.

  3. If unconfigure pages are displayed, enter the information requested for the product component.

ProcedureTo Grant Administrator Access

    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.

    Note –

    Depending on the product components you selected for removal, the uninstaller might also prompt you for a port number or a host name.

ProcedureTo Uninstall the Software

Before removing software from your system, the uninstaller displays a summary page, showing the product components selected for removal.

  1. Review your selections.

    1. If changes are needed, type the < character and press Return to go back through successive pages until the Component Selection list appears.

    2. Make changes as needed on the Component Selection list.

    3. Proceed again through the uninstaller screens.

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

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

  4. Type the ! character to exit the uninstaller.

    If you uninstalled Access Manager or Service Registry, go to Completing Post-uninstallation Tasks.

Running the Uninstaller in Silent Mode

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.

ProcedureTo Create a State File

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.

  1. If you are not logged in as root, become superuser.

  2. Navigate to the uninstaller directory:

    • Solaris OS: /var/sadm/prod/SUNWentsys5

    • Linux and HP-UX: /var/sadm/prod/sun-entsys5

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

  4. Run the silent uninstaller. For example:

    Tip –

    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.

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

  6. Make a copy of the state file for each host on which you are going to perform a silent uninstallation.

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

ProcedureTo Run the Uninstaller in Silent Mode

  1. Verify that you have properly prepared and edited the state file for the host where you want to uninstall Java ES product components.

  2. If you are not logged in as root, become superuser.

  3. Navigate to the uninstaller directory:

    • Solaris OS: /var/sadm/prod/SUNWentsys5

    • Linux and HP-UX: /var/sadm/prod/sun-entsys5

  4. Start the uninstaller. For example:


    ./uninstall -noconsole -state statefile_path

    To see the full syntax for the uninstall command, refer to uninstall Command.

ProcedureTo Monitor the Progress of a Silent Uninstallation

  1. In a terminal window, navigate to the log file directory:

    Solaris OS: /var/sadm/install/logsLinux and HP-UX: /var/opt/sun/install/logs

  2. 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:

    MM

    Specifies the month

    dd

    Specifies the date

    hh

    Specifies the hour

    mm

    Specifies the minute

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