You can roll back WebSphere® Application
Server Liberty Network
Deployment to
an earlier version using Installation Manager response files.
Before you begin
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 WebSphere Application Server Liberty Network
Deployment installation
that is being rolled back.
- 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.
Note: 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.
- Optional: List all installed packages to verify
the roll back.
./imcl listInstalledPackages -long
imcl.exe 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.ND.v85'/>
</server>
<profile id='WebSphere Liberty V8.5.5' installLocation='C:\Program Files\IBM\WebSphere\Liberty'>
</profile>
<rollback>
<offering profile='WebSphere Liberty V8.5.5' id='com.ibm.websphere.liberty.ND.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 you run 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'
. . . .>) can be found in WebSphere Application
Server product offerings for supported operating systems.
- 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.