You can roll back this product 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.
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 or the IBM Installation
Manager Version 1.5 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.
- 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.
For example:
./imcl
input $HOME/WASFiles/temp/rollback_response_file.xml
-log $HOME/WASFiles/temp/rollback_log.xml
-keyring $HOME/WASFiles/temp/im.keyring
Note: The
program might write important post-installation instructions to standard
output.
For more information on using Installation Manager,
read the IBM Installation
Manager Version 1.6 Information Center or the IBM Installation
Manager Version 1.5 Information Center.
- Optional: List all installed packages to verify
the roll back.
./imcl 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.BASE.v85'/>
</server>
<profile id='IBM WebSphere Application Server V8.5' installLocation='/QIBM/ProdData/WebSphere/AppServer/V85/BASE'>
<data key='eclipseLocation' value=''/QIBM/ProdData/InstallationManager'/>
</profile>
<rollback>
<offering profile='IBM WebSphere Application Server V8.5' id='com.ibm.websphere.BASE.v85' version='8.5.0.20101025_2108'/>
</rollback>
</agent-input>