You can roll back WebSphere® Application
Server Liberty Network
Deployment 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.
Note: In WebSphere Application Server
Version 8.5.5.0, the Liberty profile was promoted from a feature to
an independently installable offering. After updating to WebSphere Application Server Liberty Network Deployment Version 8.5.5.x from
Version 8.5.0.x, you can roll back to the Version
8.5.0.x Liberty profile feature level that you
were at before updating. If you previously had a combined full-profile
and Liberty-profile installation, the Liberty profile feature will
be reinstalled to the wlp folder when you roll
back. Any user data and server configurations will not be restored.
If necessary, you can copy them from the backed-up location into the
new wlp/usr folder after rollback. If any wlp.bak_<timestamp> directories
are present in your installation image, they will not be affected
by the rollback. If you update and roll back multiple times between
Version 8.5.0.x and Version 8.5.5.x levels,
therefore, you will have multiple wlp.bak_<timestamp> folders
in your installation image. These can always be deleted, copied,
or moved without negative impact to your installation.
Procedure
- 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.
Note: When you
use Installation Manager Version 1.6.2 and later, you should use the
-secureStorageFile and
-masterPasswordFile options
to store credentials in a credential-storage file. In versions of
Installation Manager earlier than Version 1.6.2, the
-keyring and
-password options
were used to access credentials in a keyring file. These options were
deprecated in Version 1.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.
- Log on to your system.
- Stop all servers and applications on the installation that
is being rolled back.
- 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
Tips: - The offering_ID is the offering ID that is
listed in WebSphere Application
Server product offerings for supported operating systems.
- The offering_version, which optionally can
be attached to the offering ID with an underscore, is a specific version
of the offering to which to roll back (8.5.5.20110503_0200 for
example).
- 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.
For more information on using Installation Manager,
read the IBM® Installation
Manager Information Center.
- Optional: List all installed packages to verify
the roll back.
./imcl listInstalledPackages -long
imcl.exe listInstalledPackages -long