[Java programming language only]

Uninstalling the product using response files

You can uninstall the product using IBM® Installation Manager with response files.

Before you begin

You must remove the WebSphere® eXtreme Scale augment from all WebSphere Application Server profiles before uninstalling WebSphere eXtreme Scale. You will be unable to perform the unaugment after uninstalling WebSphere eXtreme Scale. Use the manageprofiles command to unaugment existing profiles in a WebSphere eXtreme Scale environment.
Optional: Perform or record the installation of Installation Manager and installation of the product to a temporary installation registry on one of your systems so that you can use this temporary registry to record the uninstallation without using the standard registry where Installation Manager is installed.

About this task

Using Installation Manager, you can work with response files to uninstall the product in a variety of ways. You can record a response file using the GUI as described in the following procedure, or you can generate a new response file by hand or by taking an example and modifying it.

Procedure

  1. Stop all processes that are running in your environment.
  2. Optional: Record a response file to uninstall the product: On one of your systems, perform the following actions to record a response file that will uninstall the product:
    1. From a command line, change to the eclipse subdirectory in the directory where you installed Installation Manager.
    2. Start Installation Manager from the command line using the -record option.
      For example:
      • [Windows]Administrator or non-administrator
        IBMIM.exe -skipInstall "C:\temp\imRegistry" 
          -record C:\temp\uninstall_response_file.xml
      • [Linux][Unix]Administrator
        ./IBMIM -skipInstall /var/temp/imRegistry 
          -record /var/temp/uninstall_response_file.xml
      • [Linux][Unix]Non-administrator
        ./IBMIM -skipInstall user_home/var/temp/imRegistry 
          -record user_home/var/temp/uninstall_response_file.xml
      Tip: If you choose to use the -skipInstall parameter with a temporary installation registry created as described in Before you begin, Installation Manager uses the temporary installation registry while recording the response file. It is important to note that when the -skipInstall parameter is specified, no product packages are installed or uninstalled. All of the actions that you perform in Installation Manager simply update the installation data that is stored in the specified temporary registry. After the response file is generated, it can be used to uninstall the product, removing the product files and updating the standard installation registry.

      The -skipInstall operation should not be used on the actual agent data location used by Installation Manager. This is unsupported. Use a clean writable location, and re-use that location for future recording sessions.

      For more information, read the IBM Installation Manager documentation.

    3. Click Uninstall.
    4. In the Uninstall Packages window, perform the following actions.
      1. Select one of the following and the appropriate version:
        • WebSphere eXtreme Scale in a stand-alone environment
        • WebSphere eXtreme Scale Client in a stand-alone environment
        • WebSphere eXtreme Scale for WebSphere Application Server
        • WebSphere eXtreme Scale Client for WebSphere Application Server
      2. Click Next.
      3. Click Next.
    5. Review the summary information.
    6. Click Uninstall.
      • If the uninstallation is successful, the program displays a message that indicates success.
      • If the uninstallation is not successful, click View log to troubleshoot the problem.
    7. Click Finish.
    8. Click File > Exit to close Installation Manager.
  3. Use the response file to uninstall the product. From a command line on each of the systems from which you want to uninstall the product, change to the eclipse/tools subdirectory in the directory where you installed Installation Manager and use the response file that you created to uninstall the product.
    For example:
    • [Windows]Administrator or non-administrator
      imcl.exe 
        input C:\temp\uninstall_response_file.xml 
        -log C:\temp\uninstall_log.xml
    • [Linux][Unix]Administrator
      ./imcl
        input /var/temp/uninstall_response_file.xml 
        -log /var/temp/uninstall_log.xml
    • [Linux][Unix]Non-administrator
      ./imcl
        input user_home/var/temp/uninstall_response_file.xml 
        -log user_home/var/temp/uninstall_log.xml
  4. Optional: List all installed packages to verify the uninstallation.
    [Linux][Unix]
    ./imcl listInstalledPackages
    [Windows]
    imcl listInstalledPackages
  5. If the uninstallation process displays a list of augmented WebSphere Application Server profiles, then you must unaugment these profiles in order to proceed with the uninstallation.
  6. Optional: Uninstall IBM Installation Manager.
    Important: Before you can uninstall IBM Installation Manager, you must uninstall all of the packages that were installed by Installation Manager.

    Read the IBM Installation Manager documentation for information about using the uninstall script to perform this procedure.