test

Sun Java Communications Suite 5 Installation Guide

Running the Uninstaller

After you have completed the relevant tasks in Verifying 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 F, Installation Commands.

Running the Uninstaller in Graphical Mode

This section provides instructions for using the interactive graphical interface to uninstall the 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/SUNWcomm-entsys5

    • Linux: /var/sadm/prod/sun-comm-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 and cannot be selected.

    • Some product components contain subcomponents. Expand the product components to view the subcomponents.

    • If you deselect a product component that contains subcomponents, expand the product component to verify the subcomponent list.

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

  3. If the uninstaller detects any recognizable product 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.

  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.

    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 product 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 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/logs

      Linux: /var/opt/sun/install/logs

  4. Click Close to exit the uninstaller.

  5. If you installed Access Manager or Messaging Server, 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 10, 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/SUNWcomm-entsys5

    • Linux: /var/sadm/prod/sun-comm-entsys5

  3. Run the uninstaller:


    ./uninstall -nodisplay

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

ProcedureTo Select Product Components for Uninstallation

  1. The uninstaller selects for removal any product components it finds on your system by listing the numbers corresponding to the installed product components. Press Return to uninstall all product components.

    Alternately, choose specific product components by typing a comma-separated list of the numbers corresponding to the product components you want to uninstall, and press Return.

    Note –

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

  2. If the uninstaller detects product 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.

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

ProcedureTo Grant Administrator Access

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

      Linux: /var/opt/sun/install/logs

  4. Type the ! character to exit the uninstaller.

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

Running the Uninstaller in Silent Mode

Silent uninstallation is useful for uninstalling 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 a false uninstallation in either graphical or text-based mode. 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/SUNWcomm-entsys5

    • Linux: /var/sadm/prod/sun-comm-entsys5

  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

  1. Verify that you have properly prepared and edited the state file for the host where you want to uninstall product 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/SUNWcomm-entsys5

    • Linux: /var/sadm/prod/sun-comm-entsys5

  5. Start the uninstaller. For example:


    ./uninstall -nodisplay -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/logs

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