This topic applies to WebSphere Application Server Liberty V8.5.5.9 and earlier. For the latest Liberty topics, see the WebSphere Application Server Liberty documentation.

Uninstalling Liberty fix packs from distributed operating systems using the command line

You can roll back WebSphere® Application Server Liberty Core 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.

Procedure

  1. Optional: If the repository requires a username and password, create a credential-storage file to access this repository.
    Tip: When creating a credential-storage 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: When you use Installation Manager Version 1.6.2 and later, you should use the -secureStorageFile and -masterPasswordFile options to store credentials in a credential-storage file. In versions of Installation Manager earlier than Version 1.6.2, the -keyring and -password options were used to access credentials in a keyring file. These options were deprecated in Version 1.6.2. There is no migration path from keyring files to storage files because of the differences in the file structures. 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 documentation. For more information on using the -keyring and -password options to store credentials in a keyring file, see the Installation Manager Version 1.5 documentation.
  2. Log on to your system.
  3. Stop all servers and applications on the 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.
    For AIX platformsFor HP UNIX platformsFor LINUX platformsFor Solaris platforms
    ./imcl rollback offering_ID_offering_version
      -repositories source_repository 
      -installationDirectory installation_directory
      -preferences preference_key=value
      -properties property_key=value
      -secureStorageFile storage_file -masterPasswordFile master_password_file
      -acceptLicense
    For Windows platforms
    imcl.exe rollback offering_ID_offering_version
      -repositories source_repository 
      -installationDirectory installation_directory
      -preferences preference_key=value
      -properties property_key=value
      -secureStorageFile storage_file -masterPasswordFile master_password_file
      -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.5.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.
    • If you previously installed Liberty Repository features and addons but do not have access to a Liberty repository when you rollback your installation, specify the following properties in the response file:
      -properties user.addon="",user.feature=""   
      Specifying these properties enables the product to rollback and uninstalls all features and addons.
    • [8.5.5.4 or later]If you are rolling back from Version 8.5.5.4 to Version 8.5.5.3 and you have the Extended Programming Models installed, you might receive errors. To prevent errors, specify a properties parameter,addon=""; for example:
      For AIX platformsFor HP UNIX platformsFor LINUX platformsFor Solaris platforms
      ./imcl rollback offering_ID_offering_version
        -repositories source_repository 
        -installationDirectory installation_directory
        -preferences preference_key=value
        -properties user.accept.license=true,user.addon=""
        -secureStorageFile storage_file -masterPasswordFile master_password_file
        -acceptLicense
      For Windows platforms
      imcl.exe rollback offering_ID_offering_version
        -repositories source_repository 
        -installationDirectory installation_directory
        -preferences preference_key=value
        -properties user.accept.license=true,user.addon=""
        -secureStorageFile storage_file -masterPasswordFile master_password_file
        -acceptLicense

    For more information on using Installation Manager, read the IBM® Installation Manager documentation.

  6. Optional: List all installed packages to verify the roll back.
    For AIX platformsFor HP UNIX platformsFor LINUX platformsFor Solaris platforms
    ./imcl listInstalledPackages -long
    For Windows platforms
    imcl.exe listInstalledPackages -long

Icon that indicates the type of topic Task topic



Timestamp icon Last updated: Tuesday, 12 December 2017
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-libcore-mp&topic=twlp_ins_rollback_cl
File name: twlp_ins_rollback_cl.html