test

Sun Java Enterprise System 2005Q4 Installation Guide for UNIX

Running the Uninstaller

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.

Running the Uninstaller in Graphical Mode

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

ProcedureTo Start the Graphical Uninstaller

Steps

  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/SUNWentsys4

    • Linux: /var/sadm/prod/sun-entsys4

  4. Start the graphical uninstaller:


    ./uninstall

    The Welcome page is displayed.

  5. Click Next to proceed.

    The Select Components page is displayed.

ProcedureTo Select Components to Uninstall

Steps

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

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

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

    1. Click Continue to continue with uninstallation.

    2. Click Close to return to the Component Selection page.

ProcedureTo Grant Administrator Access

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.

Note –

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

Steps

  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 components you have selected for removal and the total disk space that will be reclaimed.

Steps

  1. Review the uninstallation selections you have made.

    1. If changes are needed, click Back through successive pages until the Component Selection page is displayed.

    2. Make changes as needed on the Component Selection 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

    • After all component software has been removed, the uninstaller displays the Uninstallation Complete page.

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

  4. Click Close to exit the uninstaller.

  5. If you installed Access Manager or Messaging Server, go to 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.

Tip –

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.

ProcedureTo Start the Uninstaller in Text-Based Mode

Steps

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

  2. Navigate to the uninstaller directory:

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

    • Linux: /var/sadm/prod/sun-entsys4

  3. Run the uninstaller:


    ./uninstall -nodisplay

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

ProcedureTo Select Components for Uninstallation

Steps

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

    Note –

    Components that are not installed on your system are disabled and cannot be chosen.

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

    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.

ProcedureTo Grant Administrator Access

Step

    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.

    Note –

    Depending on the 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 components selected for removal.

Steps

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

  4. Type the ! character to exit the uninstaller.

    Go to Post-uninstallation Tasks if you uninstalled Access Manager or Messaging Server.

Running the Uninstaller in Silent Mode

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.

ProcedureTo Create a State File

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.

Steps

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

  2. Navigate to the uninstaller directory:

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

    • Linux: /var/sadm/prod/sun-entsys4

  3. If you are using the graphical interface of the uninstaller, provide access to your local display. See Running the Uninstaller in Graphical Mode.

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

  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. No software has been 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

Steps

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

  2. Open a terminal window.

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

  4. Navigate to the uninstaller directory:

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

    • Linux: /var/sadm/prod/sun-entsys4

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

Steps

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

    On Solaris OS: /var/sadm/install/logsOn Linux: /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_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.