You can roll back this product 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.
Restriction: You
cannot use the Installation Manager to roll back an installation
and add or remove the full WebSphere® Application
Server profile feature or the Liberty profile feature.
Procedure
- Optional: If the repository requires a username
and password, create a keyring file to access this repository.
For more information on creating a keyring file for Installation
Manager, read the IBM® Installation
Manager Version 1.6 Information Center.
Tip: When
creating a keyring 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: Starting
in Installation Manager Version 1.6.2, the
-keyring and
-password options
that have been used to access credentials in a keyring file are deprecated.
When you use Installation Manager Version 1.6.2 and later, use the
-secureStorageFile and
-masterPasswordFile options
to store credentials in a credential storage file.
There is no migration
path from keyring files to storage files because of the differences
in the file structures. You must create a storage file to replace
a keyring file.
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.
- Sign on to the IBM i system
with a user profile that has *ALLOBJ and *SECADM special authorities.
- Stop all servers and applications on the WebSphere Application
Server installation that is being rolled back.
- On a CL command line, run the STRQSH command
to start the Qshell command shell.
- 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
-keyring keyring_file -password password
-acceptLicense
For more information on using the imcl command,
read the IBM Installation
Manager Version 1.6 Information Center.
- Optional: List all installed packages to verify
the roll back.
./imcl listInstalledPackages -long