Uninstall fix packs using the command line
We can roll back this product to an earlier version using the Installation Manager imcl rollback command.
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 we install a package. If we change the default setting or delete the saved files, Installation Manager requires access to the repository used to install the earlier version.
For more information about using Installation Manager, read the IBM Installation Manager documentation.
Tasks
- Log on to the system.
(iSeries) Log on to the IBM i system with a user profile that has *ALLOBJ and *SECADM special authorities.
- Verify the product that we are rolling back is not running.
- Start the command line.
(iSeries) On a CL command line, run the STRQSH command to start the Qshell command shell.
- Verify that we have the necessary permissions to install the fix pack in our chosen directories.
- Change to the eclipse/tools subdirectory in the directory where we installed Installation Manager.
- Use the imcl command to roll back the product.
(UNIX)
./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(Windows)
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
- Rolling back offerings with optional features
When we roll back a product, specify all optional features that were used in the previous product installation. If we 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:
Offering ID Optional feature ID Default features WebSphere Application Server, Network Deployment com.ibm.websphere.ND.v90
- core.feature: WAS
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
We 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 WAS 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 WAS com.ibm.websphere.NDDMZ.v90
- core.feature: DMZ Secure Proxy Server for IBM WAS
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
- Offering 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 we run the following command against the repository:
imcl listAvailablePackages -repositories source_repository- Optional: List all installed packages to verify the roll back.
(UNIX) (iSeries)
./imcl listInstalledPackages -long(Windows)
imcl.exe listInstalledPackages -long
Update the product on distributed and IBM i operating systems Install fix packs on distributed operating systems using the GUI Install fix packs using the command line Install fix packs using response files Uninstall fix packs using response files Install and uninstall interim fixes