[AIX Solaris HP-UX Linux Windows][IBM i]

Uninstalling fix packs by using response files

You can roll back this product to an earlier version by 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.

For more information about using Installation Manager, read the IBM® Installation Manager documentation.

Procedure

  1. Log on to your system.

    [IBM i]Make sure that you log on to the IBM i system with a user profile that has *ALLOBJ and *SECADM special authorities.

  2. Create a response file to roll back the product.

    A response file is an XML file that contains the data that is required to update the product, such as the offerings to update and the installation directory.

    If your rollback requires access to an authenticated repository, you must also have a credential storage file and optionally a master password file. For more information about storing authentication credentials, see Storing credentials in the IBM Installation Manager documentation.

    For a sample response file that updates the WebSphere® Application Server offering, see the examples.

  3. Make sure that the product that you are rolling back is not running.
  4. Start the command line.

    [IBM i]On a CL command line, run the STRQSH command to start the Qshell command shell.

  5. Verify that you have the necessary permissions to install the fix pack in your chosen directories.
  6. Change to the eclipse/tools subdirectory in the directory where you installed Installation Manager.
  7. Run the imcl command with the location of the response file specified on the input parameter.
    For example:
    • [Windows]Administrator or non-administrator:
      imcl.exe
        input C:\temp\rollback_response_file.xml 
        -log C:\temp\rollback_log.xml 
        -secureStorageFile C:\IM\credential.store -masterPasswordFile C:\IM\master_password.txt
    • [AIX][HP-UX][Linux][Solaris]Administrator:
      ./imcl
        input /var/temp/rollback_response_file.xml
        -log /var/temp/rollback_log.xml
        -secureStorageFile /var/IM/credential.store -masterPasswordFile /var/IM/master_password.txt
    • [AIX][HP-UX][Linux][Solaris]Non-administrator:
      ./imcl
        input user_home/var/temp/rollback_response_file.xml 
        -log user_home/var/temp/rollback_log.xml
        -secureStorageFile user_home/var/IM/credential.store -masterPasswordFile user_home/var/IM/master_password.txt
    • [IBM i]
      ./imcl -acceptLicense 
        input $HOME/WASFiles/temp/rollback_response_file.xml 
        -log $HOME/WASFiles/temp/rollback_log.xml
        -secureStorageFile $HOME/WASFiles/temp/credential.store -masterPasswordFile $HOME/WASFiles/temp/master_password.txt 
    Note: The program might write important post-installation instructions to standard output.
  8. Optional: List all installed packages to verify the rollback.
    [AIX][HP-UX][Linux][Solaris][IBM i]
    ./imcl listInstalledPackages -long
    [Windows]
    imcl.exe listInstalledPackages -long

Example

The following sample response file shows rolling back the WebSphere Application Server, Network Deployment product to an earlier version on the Windows operating system.
<?xml version="1.0" encoding="UTF-8"?>
<agent-input>
<server>
  <repository location='https://www.ibm.com/software/repositorymanager/com.ibm.websphere.ND.v90'/>
</server>
<profile id='IBM WebSphere Application Server V9.0' installLocation='C:\Program Files\IBM\WebSphere\AppServer'>
  <data key='eclipseLocation' value='C:\Program Files\IBM\WebSphere\AppServer'/>
</profile>
<rollback>
  <offering profile='IBM WebSphere Application Server V9.0' id='com.ibm.websphere.ND.v90' version='9.0.0.20161025_2108'/>
</rollback>
</agent-input>
Finding the profile ID
To find the profile ID (<profile . . . id='profile_ID' . . . .> and <offering . . . profile='profile_ID' . . . .>), run the following command from the eclipse/tools subdirectory in the directory where you installed Installation Manager:
imcl listInstallationDirectories -verbose
The profile name is the same as the package group name.
Rolling back offerings with optional features

To find the installed offering ID (<offering . . . id='offering_ID' . . . .>), run the historyInfo or genHistoryReport command from the app_server_root/bin directory.

When you roll back a product, your response file must contain the features that were used in the previous product installation. If you do not add these features to your response file, Installation Manager removes them.

The offering IDs, optional features for each offering, and default features are shown in the following table:
Table 1. Offering IDs and optional features
Offering ID Optional feature ID Default features
WebSphere Application Server, Network Deployment

com.ibm.websphere.ND.v90

  • core.feature: WebSphere Application Server
    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
Note: You cannot use Installation Manager to modify, update, or roll back functions to later add or remove core.feature. Only the subfeatures can be added or removed.
  • core.feature
    • thinclient
    • embeddablecontainer
    • ejbdeploy
Application Client for WebSphere Application Server

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 WebSphere Application Server

com.ibm.websphere.NDDMZ.v90

  • core.feature: DMZ Secure Proxy Server for IBM WebSphere Application Server
    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

Specifying an offering version

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 as9.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 you run the following command against the repository:
imcl listAvailablePackages -repositories source_repository

Icon that indicates the type of topic Task topic



Timestamp icon Last updated: March 5, 2017 23:55
File name: tins_rollback_silent.html