Sun Java Communications Suite 5 Installation Guide

Resolving Uninstallation Problems

This section addresses the following problems you might encounter during uninstallation.

Cannot Find Uninstaller

The installation program places the uninstaller on your system at the following location:

If the uninstaller is not in this directory, one of the following might have occurred:

Suggested Fix. Manually clean up your system as described in Uninstallation Fails, Leaving Behind Files.

Uninstallation Fails, Leaving Behind Files

If manual cleanup is necessary because the uninstaller left behind files or processes, perform the following procedure to remove packages from your system.

ProcedureTo Manually Clean Up Packages

  1. Determine which packages you want to remove.

    Compare the packages on your system with the Communications Suite packages listed in Chapter 5, List of Installable Packages, in Sun Java Enterprise System 5 Installation Reference for UNIX. You can use the Solaris pkginfo or prodreg utility or the Linux rpm command to determine which packages are installed. (See Installation Fails Due to Leftover Files During Uninstallation

  2. Stop all running processes for Communications Suite product components.

    Brief instructions for stopping processes are contained in Chapter 6, Completing Communications Suite Postinstallation Configuration product component documentation.

  3. Back up all custom configuration and user data you plan to use in subsequent installations.

    Reviewing Uninstallation Behavior for Communications Suite Product Components provides some information on configuration and user data that should be backed up. For more information, refer to the product component documentation for each product component.

  4. Use the pkgrm, rpm -e, or swremove command to remove Communications Suite component packages.

  5. Remove any remaining product component directories and their content that you do not plan to use in subsequent installations. If you do plan to use these directories later, move them elsewhere.

  6. Update the product registry file, which is located here:

    Solaris OS: /var/sadm/install/productregistry

    Linux: /var/opt/sun/install/productregistry

    The uninstaller uses this registry to determine which product components are installed on a host. Both the installer and uninstaller update the product registry upon completion of an installation or uninstallation.

    Note –

    If you manually remove packages rather than using the uninstaller, then you must edit the product registry so it correctly reflects the software installed on your system.

  7. Clean up the log files for your system, which are located here:

    Solaris OS: /var/sadm/install/logs

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

    The log files might not correctly reflect the state of your system after you manually remove packages.

Product Registry Is Corrupted

During uninstallation, the uninstaller uses the product registry file to determine what needs to be uninstalled:

Solaris OS: /var/sadm/install/productregistry

Linux: /var/opt/sun/install/productregistry