[AIX Solaris HP-UX Linux Windows]

Uninstalling fix packs from distributed operating systems using the command line

You can roll back this product to an earlier version using the Installation Manager command line.

Before you begin

Restriction: In order to use this procedure, you must have Installation Manager Version 1.6 or later installed on your system.

During the rollback process, Installation Manager must access files from the earlier version of the package. By default, these files are stored on your computer when you install a package. If you change the default setting or delete the saved files, Installation Manager requires access to the repository that was used to install the earlier version.

About this task

Restriction: You cannot use the Installation Manager to roll back an installation and add or remove the full WebSphere® Application Server profile feature or the Liberty profile feature.

Procedure

  1. Optional: If the repository requires a username and password, create a keyring file to access this repository.

    For more information on creating a keyring file for Installation Manager, read the IBM® Installation Manager Version 1.6 Information Center.

    Tip: When creating a keyring file, append /repository.config at the end of the repository URL location if the imutilsc command is unable to find the URL that is specified.
    Note: Starting in Installation Manager Version 1.6.2, the -keyring and -password options that have been used to access credentials in a keyring file are deprecated. When you use Installation Manager Version 1.6.2 and later, use the -secureStorageFile and -masterPasswordFile options to store credentials in a credential storage file.

    There is no migration path from keyring files to storage files because of the differences in the file structures. You must create a storage file to replace a keyring file.

    For more information on using the -secureStorageFile and -masterPasswordFile options to store credentials in a credential storage file, see the Installation Manager Version 1.6 Information Center.

  2. Log on to your system.
  3. Stop all servers and applications on the WebSphere Application Server installation that is being rolled back.
  4. Change to the eclipse/tools subdirectory in the directory where you installed Installation Manager.
  5. Use the imcl command to roll back the product.
    [AIX][HP-UX][Linux][Solaris]
    ./imcl rollback offering_ID_offering_version
      -repositories source_repository 
      -installationDirectory installation_directory
      -preferences preference_key=value
      -properties property_key=value
      -keyring keyring_file -password password
      -acceptLicense
    [Windows]
    imcl.exe rollback offering_ID_offering_version
      -repositories source_repository 
      -installationDirectory installation_directory
      -preferences preference_key=value
      -properties property_key=value
      -keyring keyring_file -password password
      -acceptLicense
    Tips:
    • The offering_ID is the offering ID that is listed in WebSphere Application Server product offerings for supported operating systems.
    • The offering_version, which optionally can be attached to the offering ID with an underscore, is a specific version of the offering to which to roll back (8.5.0.20110503_0200 for example).
      • If offering_version is not specified, the installation rolls back to the previously installed version of the offering and all interim fixes for that version are installed.
      • If offering_version is specified, the installation rolls back to the specified earlier version of the offering and no interim fixes for that version are installed.

      The offering version can be found attached to the end of the offering ID with an underscore in the Package section of the report that is generated when you run the historyInfo or genHistoryReport command from the app_server_root/bin directory.

    For more information on using Installation Manager, read the IBM Installation Manager Version 1.6 Information Center.

  6. Optional: List all installed packages to verify the roll back.
    [AIX][HP-UX][Linux][Solaris]
    ./imcl listInstalledPackages -long
    [Windows]
    imcl.exe listInstalledPackages -long
Task topic    

Terms and conditions for information centers | Feedback

Last updated: April 20, 2014 09:36 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-nd-dist&topic=tins_rollback_cl
File name: tins_rollback_cl.html