Uninstalling Liberty fix packs from distributed operating systems using response files

You can roll back WebSphere® Application Server Liberty Core to an earlier version using Installation Manager response files.

Before you begin

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.
  2. Log on to your system.
  3. Stop all servers and applications on the WebSphere Application Server Liberty Core installation that is being rolled back.
  4. Use a response file to roll back the product.

    Change to the eclipse/tools subdirectory in the directory where you installed Installation Manager, and roll back the product.

    For example:
    • For Windows platforms Administrator or non-administrator:
      imcl.exe
        input C:\temp\rollback_response_file.xml 
        -log C:\temp\rollback_log.xml 
        -secureStorageFile C:\IM\credential.store -masterPasswordFile C:\IM\master_password_file.txt
    • For AIX platformsFor HP UNIX platformsFor LINUX platformsFor Solaris platformsAdministrator:
      ./imcl
        input /var/temp/rollback_response_file.xml 
        -log /var/temp/rollback_log.xml 
        -secureStorageFile /var/IM/credential.store -masterPasswordFile /var/IM/master_password_file.txt
    • For AIX platformsFor HP UNIX platformsFor LINUX platformsFor Solaris platformsNon-administrator:
      ./imcl
        input user_home/var/temp/rollback_response_file.xml 
        -log user_home/var/temp/rollback_log.xml 
        -secureStorageFile user_home/var/IM/credential.store -masterPasswordFile user_home/var/IM/master_password_file.txt
    Note: The program might write important post-installation instructions to standard output.

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

  5. 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
For Windows platforms

Example

The following is an example of a response file for rolling back the product to an earlier version.
<?xml version="1.0" encoding="UTF-8"?>
<agent-input>
<server>
  <repository location='https://www.ibm.com/software/repositorymanager/com.ibm.websphere.liberty'/>
</server>
<profile id='WebSphere Liberty' installLocation='C:\Program Files\IBM\WebSphere\Liberty'>
</profile>
<rollback>
  <offering profile='WebSphere Liberty' id='com.ibm.websphere.liberty' version='16.0.2.20161025_2108'/>
</rollback>
</agent-input>
Tips:
  • The profile ID (<profile . . . id='profile_ID' . . . .> and <offering . . . profile='profile_ID' . . . .>) can be found when you run the imcl listInstallationDirectories -verbose command from the eclipse/tools subdirectory in the directory where you installed Installation Manager. It is the same as the package group's name.
  • The offering ID (<offering . . . id='offering_ID' . . . .>) can be found in Liberty product offerings for supported operating systems.
  • The version is a specific version of the offering to which to roll back (16.0.2.20161025_2108 for example).
    This specification is optional.
    • If 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 version is specified, the installation rolls back to the specified earlier version of the offering and no interim fixes for that version are installed.
  • When you roll back to a previous fix pack, any Liberty addons and features that do not apply to that fix pack are removed.
    If you previously installed Liberty features and addons but do not have access to a Liberty repository when you roll back your installation, specify the following properties in the response file. Specifying these properties uninstalls all features and addons but enables the product to roll back.
    <data key='user.feature' value=''/> 
    <data key='user.addon' value=''/>

    Note that for fix pack 16.0.0.2 and later, all features that apply to an edition are available and installed when you install the product.


Icon that indicates the type of topic Task topic

File name: twlp_ins_rollback_silent.html