Uninstalling fix packs by using the command line

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

Before you begin

During the rollback process, the Installation Manager must access files from the earlier version of the product package. By default, these files are stored on your computer when you install a product package. If you change from the default and choose not to save backup files for rollback or if you delete the saved files, the Installation Manager requires access to the installation package in the repository at the prior level to roll back to earlier versions of the product package.

If fix packs are installed on the original installation package, you need to specify the repositories of the fix pack version that you want to roll back to. You also need to specify other repositories that the Installation Manager requests. The general availability repository is the most important to specify. Specify this repository as 9.0.0.0 for version 9.0.

Important: Installation Manager can install any fix-pack level of the product directly without installing the interim fix packs. In fact, Installation Manager installs the latest level by default. For example, you can skip fix-pack levels and go from Version 9.0.0.1 directly to Version 9.0.0.5. However, keep in mind that later you cannot roll back to any level that was skipped. If you directly install to Version 9.0.0.5, for example, you cannot roll back to Version 9.0.0.3. If you skip from Version 9.0.0.1 to Version 9.0.0.5, you can roll back only to Version 9.0.0.1.

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

Procedure

Log on to your system.

Make sure that you log on to the IBM i system with a user profile that has *ALLOBJ and *SECADM special authorities.
Make sure that the product that you are rolling back is not running.
Start the command line.

On a CL command line, run the STRQSH command to start the Qshell command shell.
Verify that you have the necessary permissions to install the fix pack in your chosen directories.
Change to the eclipse/tools subdirectory in the directory where you installed Installation Manager.

Use the imcl command to roll back the product.

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

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

You can roll back offerings with optional features:

When you roll back a product, you must specify all optional features that were used in the previous product installation. If you do not specify these features, Installation Manager removes them.

The offering IDs, optional features for each offering, and default features are shown in the following table:

Table 1. Offering IDs and optional features
Offering ID	Optional feature ID	Default features
WebSphere® Application Server (base) `com.ibm.websphere.BASE.v90`	`core.feature`: WebSphere Application Server This feature must be specified to specify the following optional subfeatures: `samples`: Sample applications `thinclient`: Standalone thin clients and resource adapters `embeddablecontainer`: Embeddable EJB container `ejbdeploy`: EJBDeploy tool for pre-EJB 3.0 modules Note: You cannot use Installation Manager to modify, update, or rollback functions to later add or remove `core.feature`. Only the subfeatures can be added or removed.	`core.feature` `thinclient` `embeddablecontainer` `ejbdeploy`
Application Client for WebSphere Application Server `com.ibm.websphere.APPCLIENT.v90`	`samples`: Samples `standalonethinclient.resourceadapter.runtime`: Standalone Thin Clients Runtime `standalonethinclient.resourceadapter.samples`: Standalone Thin Clients Samples `embeddablecontainer`: Embeddable EJB Container	`embeddablecontainer`
DMZ Secure Proxy Server for IBM WebSphere Application Server `com.ibm.websphere.NDDMZ.v90`	`core.feature`: DMZ Secure Proxy Server for IBM WebSphere Application Server This feature must be specified to specify the following optional subfeature: `thinclient`: Standalone thin clients and resource adapters	No default features
Web Server Plug-ins `com.ibm.websphere.PLG.v90`	No optional features	N/A
WebSphere Customization Toolbox `com.ibm.websphere.WCT.v90`	`zpmt`: Profile Management Tool (z/OS only) `zmmt`: z/OS Migration Management Tool `pct`: Web Server Plug-ins Configuration Tool	All optional features are installed by default

You can offer version information:
The offering_version, which optionally can be attached to the offering ID with an underscore, is a specific version of the offering to roll back to, such as 9.0.0.20160503_0200.
- 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 when you run the following command against the repository:
```
imcl listAvailablePackages -repositories source_repository
```

Optional: List all installed packages to verify the roll back.

./imcl listInstalledPackages -long

imcl.exe listInstalledPackages -long