IBM Support

How To Manually Rollback/UnInstall a Fix Pack at IBM WebSphere Application Server (WAS) v8.0 and later

Question & Answer


Question

This document will answer the question, "How do I manually rollback/uninstall a fix pack at IBM WebSphere Application Server (WAS) v8.0 and later?"

Answer

Before rolling back to a previous fix pack version at IBM WebSphere Application Server v8.0 and later, you need to ensure the following pre-requisites have been met.

    1) The fix pack repository of the version you wish to rollback to must already exist in the IFS of your IBM i server. Previous WAS fix pack repository versions are stored in the /QIBM/WAS/WASFixpacks/ IFS directory by default when the IBM i WAS Group PTF has been applied. If you cannot find a fix pack repository for the version you wish to rollback to, you can download the previous fix pack repository version and then restore it to your IBM i server. Information on this process can be found here.
    2) The fix pack version you wish to rollback to must have been previously installed to the IBM WebSphere Application Server installation path.
    3) You need to have access to an IBM i user profile that has explicit *ALLOBJ and *SECADM special authorities.
    4) All Java processes related to the IBM WebSphere Application Server installation must be ended.
    i.e. ENDSBS QWASx *IMMED
    5) All IBM i Host Servers must be started.
    i.e. STRHOSTSVR *ALL
    NOTE: You can use the IBM i Access for Windows DOS command "cwbping <IPaddress>" to test your IBM i Host Servers. Where <IPaddress> is the IP address of the IBM i server.
    6) The QALWOBJRST system value must be set to *ALL.
    i.e. CHGSYSVAL SYSVAL(QALWOBJRST) VALUE(*ALL)

Steps to rollback your IBM WebSphere Application Server installation to a previously installed fix pack version

1) Open a 5250 emulation session to your IBM i and sign in with a user profile that has explicit *ALLOBJ and *SECADM special authority.

2) Open a Qshell session.
    STRQSH

3) Identify your IBM WebSphere Application Server installation path.
    The following steps will refer to your IBM WebSphere Application Server (WAS) installation directory as ${INSTALL_DIR}. Your specific WAS installation directory can be found by executing the following command.

    /QIBM/WAS/bin/queryWASinstalls

    Example output:
    -------------------------------------------------------------------------
    Websphere Edition:      EXPRESS
    Version:                8.5.5.0
    Installation Location:  /QIBM/ProdData/WebSphere/AppServer/V85/Express
    Installation Library:   QWAS85A
    Default Profile Location: /QIBM/UserData/Websphere/Appserver/V85/Express
    -------------------------------------------------------------------------

    For the above example, the ${INSTALL_DIR} variable would equal /QIBM/ProdData/WebSphere/AppServer/V85/Express.

4) Display the installation event history for your installation and determine the "Package" value for the fix pack version you wish to roll back to.
    ${INSTALL_DIR}/bin/historyInfo

    After the previous installation events are displayed, you will need to identify the package name of the previous update you wish to rollback to. This is the value displayed next to the "Package" item for the installation event.

    For example, I have a WAS v8.5.5.0 Express installation that I would like to roll back to v8.5.0.2. I would execute the historyInfo command as displayed below. Then, I would locate the v8.5.0.2 installation event and make note the value for the "Package" item since it will be required for the "imcl rollback" command discussed later in this document.

    In my example, ${PACKAGE} would be equal to com.ibm.websphere.EXPRESS.v85_8.5.2.20130327_1831 since I want to roll back the installation to v8.5.0.2.

    i.e.
    /QIBM/ProdData/WebSphere/AppServer/V85/Express/bin/historyInfo

    Installation Event          
    -------------------------------------------------------------------------
    Install Manager Offering ID        com.ibm.websphere.EXPRESS.v85
    Action                             install
    Version                            8.5.0.0
    Package                            com.ibm.websphere.EXPRESS.v85_8.5.0.20120501_1108
    Log File Name                      /QIBM/UserData/InstallationManager/logs/20130424_2011a.xml
    Timestamp                          2013-04-24 20:11:58+0200
    Result                             success      
    Installed Features                 EJBDeploy tool for pre-EJB 3.0 modules
                               Stand-alone thin clients and resource adapters
                                       Embeddable EJB container                                                                                            
    Installation Event        
    ------------------------------------------------------------------------
    Install Manager Offering ID        com.ibm.websphere.EXPRESS.v85
    Action                             update
    Version                            8.5.0.2
    ********
    Package                            com.ibm.websphere.EXPRESS.v85_8.5.2.20130327_1831
    ********
    Log File Name                      /QIBM/UserData/InstallationManager/logs/20130502_0034.xml
    Timestamp                          2013-05-02 00:34:32+0200
    Result                             success
    Installed Features                 EJBDeploy tool for pre-EJB 3.0 modules
                                       Embeddable EJB container
                               Stand-alone thin clients and resource adapters                                                                                                      
    Installation Event
    ------------------------------------------------------------------------
    Install Manager Offering ID        com.ibm.websphere.EXPRESS.v85
    Action                             update            
    Version                            8.5.5.0
    Package                            com.ibm.websphere.EXPRESS.v85_8.5.5000.20130514_1044
    Log File Name                      /QIBM/UserData/InstallationManager/logs/20140307_0112.xml
    Timestamp                          2014-03-07 01:12:33+0100
    Result                             success
    Installed Features                 EJBDeploy tool for pre-EJB 3.0 modules
                                       Embeddable EJB container
                               Stand-alone thin clients and resource adapters
    -------------------------------------------------------------------------

5) Identify the IFS path to the fix pack installation repository for the fix pack version you wish to rollback to.
    i.e. /QIBM/WAS/WASFixpacks/<version>/FIXPACK

    As previously noted, the fix pack repository of the version you wish to rollback to must already exist in the IFS of your IBM i server. Previous WAS fix pack repository versions are stored in the /QIBM/WAS/WASFixpacks/ IFS directory by default when the IBM i WAS Group PTF has been applied. If you cannot find a fix pack repository for the version you wish to rollback to, you can download the previous fix pack repository version here and then restore it to your IBM i server.

    To list the fix pack installation repository versions available in the IBM i WAS default location, type the following from a Qshell command line:

    ls /qibm/was/wasfixpacks/was
    8007    8502    8550        

    The above output tells me that I have the IBM WAS 8.0.0.7, 8.5.0.2, and 8.5.5.0 fix pack installation repositories available on my IBM i server. In my example, I am attempting to roll back to 8.5.0.2. Since I have identified the 8.5.0.2 fix pack installation repository still exists on my system, no further action is needed.

    In my example, ${REPOSITORY} would be equal to /QIBM/WAS/WASFixpacks/8502/FIXPACK.

    If you did not see the fix pack installation repository for the version you are attempting to rollback to, you would need to download and restore the fix pack installation repository to the IFS of your IBM i server. Then, use the IFS path to this repository in place of the ${REPOSITORY} variable.

6) Execute the rollback of the IBM WebSphere Application Server installation to the previous fix pack version.
    From a system command line, invoke the following SBMJOB command to submit the rollback process to batch via the UDPATEWAS job; where ${PACKAGE}, ${INSTALL_DIR} and ${REPOSITORY} are defined above:

    SBMJOB CMD(STRQSH CMD('umask 022;/QIBM/ProdData/InstallationManager/eclipse/tools/imcl rollback ${PACKAGE} -repositories ${REPOSITORY} -installationDirectory ${INSTALL_DIR} -showVerboseProgress')) JOB(UPDATEWAS) ALWMLTTHD(*YES) JOBQ(QSYS/QSYSNOMAX)

    NOTE: IBM recommends the use of the SBMJOB command to submit the rollback to batch instead of running the command interactively. Running the rollback process in batch will prevent issues from occurring if your interactive session loses connectivity or ends unexpectedly.

    Optionally, the IM imcl command can be executed interactively using the following steps:
    umask 022                
    $                                                                                                                                
    cd /qibm/proddata/installationmanager/eclipse/tools              
    $                                                                                                                                
    ./imcl rollback ${PACKAGE} -repositories ${REPOSITORY} -installationDirectory ${INSTALL_DIR} -showVerboseProgress

    Once the fix pack rollback completes, you should receive the following message:

    Rolled back to ${PACKAGE} in the ${INSTALL_DIR} directory.
    $

    In my example, I would execute the following command:

    ./imcl rollback com.ibm.websphere.EXPRESS.v85_8.5.2.20130327_1831 -repositories /qibm/was/wasfixpacks/was/8502/fixpack -installationDirectory /QIBM/ProdData/WebSphere/AppServer/V85/Express -showVerboseProgress                                                                     
    In my example, here is the message that was returned indicating a successful rollback operation.

    Rolled back to com.ibm.websphere.EXPRESS.v85_8.5.2.20130327_1831 in the /QIBM/ProdData/WebSphere/AppServer/V85/Express directory.
    $

7) Verify the IBM WebSphere Application Server installation is at the new version.
    ${INSTALL_DIR}/bin/versionInfo
    i.e. /QIBM/ProdData/WebSphere/AppServer/V85/Express/bin/versionInfo

    Installed Product
    -------------------------------------------------------------------------
    Name                  IBM WebSphere Application Server - Express
    Version               8.5.0.2
    ID                    EXPRESS
    Build Level           cf021312.01
    Build Date            3/27/13
    Package               com.ibm.websphere.EXPRESS.v85_8.5.2.20130327_1831
    Architecture          System i
    Installed Features    WebSphere Application Server Full Profile
                          EJBDeploy tool for pre-EJB 3.0 modules
                          Embeddable EJB container
                          Stand-alone thin clients and resource adapters
    -------------------------------------------------------------------------

    As you can see in my example above, the IBM WebSphere Application Server Express installation was successfully rolled back from 8.5.5.0 to 8.5.0.2.

8) The fix pack rollback process is now complete. If you experience issues or have questions along the way, please contact the IBM i Global Support Center at 1-800-IBM-SERV and open a new service request.

[{"Type":"MASTER","Line of Business":{"code":"LOB57","label":"Power"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SWG60","label":"IBM i"},"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.1.0"}]

Document Information

Modified date:
18 December 2019

UID

nas8N1019969

Page Feedback