Uninstall Liberty fix packs from IBM i operating systems using response files

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

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

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

   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 specified.

   When we use Installation Manager v1.6.2 and later, we should use the -secureStorageFile and -masterPasswordFile options to store credentials in a credential-storage file. In versions of Installation Manager earlier than v1.6.2, the -keyring and -password options were used to access credentials in a keyring file. These options were deprecated in v1.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 Information Center. For more information on using the -keyring and -password options to store credentials in a keyring file, see the Installation Manager Version 1.5 Information Center.

2. Sign on to the IBM i system with a user profile that has *ALLOBJ and *SECADM special authorities.

3. Stop all servers and applications on the installation that is being rolled back.

4. On a CL command line, run the STRQSH command to start the Qshell command shell.

5. 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:

   ./imcl
     input $HOME/WASFiles/temp/rollback_response_file.xml 
     -log $HOME/WASFiles/temp/rollback_log.xml 
     -secureStorageFile $HOME/WASFiles/temp/credential.store -masterPasswordFile $HOME/WASFiles/master_password_file.txt

   The program might write important post-installation instructions to standard output.

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

6. Optional: List all installed packages to verify the roll back.
   ./imcl listInstalledPackages -long

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.v85'/>
</server>
<profile id='WebSphere Liberty V8.5' installLocation='/QIBM/ProdData/WebSphere/AppServer/V85/LibertyCore'>
</profile>
<rollback>
  <offering profile='WebSphere Liberty V8.5' id='com.ibm.websphere.liberty.v85' version='8.5.5.20101025_2108'/>
</rollback>
</agent-input>

Tips:

• The profile ID (<profile . . . id='profile_ID' . . . .> and <offering . . . profile='profile_ID' . . . .>) can be found when running 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'

• The version is a specific version of the offering to which to roll back (8.5.5.20101025_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.

Parent topic:

Install Liberty on IBM i operating systems

Tasks:

Install Liberty on IBM i operating systems using the command line

Install Liberty on IBM i operating systems using response files

Install Liberty remotely on IBM i operating systems using the iRemoteInstall command

Add and remove features from Liberty on IBM i operating systems using response files

Verify the installation

Uninstall Liberty from IBM i operating systems using the command line

Uninstall Liberty from IBM i operating systems using response files

Install Liberty interim fixes on IBM i operating systems using the command line

Install Liberty fix packs on IBM i operating systems using the command line

Install Liberty fix packs on IBM i operating systems using response files

Uninstall Liberty interim fixes from IBM i operating systems using the command line

Uninstall Liberty fix packs from IBM i operating systems using the command line