IBM Support

WebSphere Application Server for IBM i - Version 8.5.5 Fix packs

General Page

WebSphere Application Server, Version 8.5.5, is installed on IBM i as option 2 of licensed program 5733W85, WebSphere Application Server V8.5 for IBM i.

websphere 855,was855,websphere 8.5.5,was 8.5.5,websphere application server v8.5.5,websphere 855 on ibm i,was 855 on ibm i,websphere 8.5.5 on ibm i,was 8.5.5 on ibm i

After applying the WebSphere Application Server (WAS) 8.5 Group PTF, there are additional steps required to complete the fix pack installation. Please use one of the installation methods described below.

Note: Prior to updating your IBM WebSphere Application Server installation, it is HIGHLY recommended to export/backup your IBM Installation Manager and WebSphere Application Server installation data. Please refer to the IBM Software Technical Document: "How and When To Export/Backup Your IBM Installation Manager and WebSphere Application Server Installation Data on the IBM i?" for more information.

IMPORTANT!!! Before the WAS v8.5.5.13 and later fix packs can be installed, all WAS profiles as well as the command and new profile defaults will need to be changed to use JDK v7.0 or newer.
Please see:
Removal of Support for IBM JDK 6.0/6.2.6 with IBM WebSphere Application Server v8.5.5.13 Fix Pack Level on IBM i OS

IBM Web Administration GUI installation method (IBM Preferred)

  1. The WebSphere Group PTF has also provided a local repository for the latest IBM Installation Manager (IM) fix pack, and it is recommended that the IM be updated before you install the WebSphere fix packs provided by the WebSphere Group PTF. The Readme.txt and Readme.html files for the IM fix pack can be found here:
  2. Please review and follow the instructions listed in the document below to install the WAS 8.5 fix pack.
    How To Install an IBM WebSphere Application Server (WAS) Fix Pack Using the IBM Web Administration for i Console

Manual installation method

Throughout these instructions, you must replace the following:

<was_fixpack_product>: ( WAS | NDDMZ | PLG | CLIENT | LIBERTYEXPRESS ) The cumulative WebSphere fix pack repositories are provided for each stand-alone product offering. The following names are used to create IFS directories in the path where the expanded WebSphere repositories are restored:

Note: For product 5733W85 options 1, 2, and 3 (Express, Base, ND); a common fix pack repository is used that is referred to as WAS. This is the primary fix pack repository used for WAS fix pack installations. Please see the list below. The WAS Liberty Express fix pack repository is located under the LIBERTYEXPRESS directory. The WAS Liberty Base and Network Deployment(ND) fix packs are not provided with the IBM i WAS Group PTF.

IBM i Product
5733W85:

WAS: Option 1 - IBM WebSphere Application Server V8.5 Express
- IBM Web Enablement for IBM i
Option 2 - IBM WebSphere Application Server V8.5 Base
Option 3 - IBM WebSphere Application Server V8.5 Network Deployment
NDDMZ: Option 4 - IBM WebSphere Application Server V8.5 ND DMZ Secure Proxy
CLIENT: Option 6 - IBM WebSphere Application Server V8.5 Client
PLG: Option 7 - IBM WebSphere Application Server V8.5 Plugins
LIBERTYEXPRESS: Option 1 - IBM Web Enablement Liberty for IBM i
Express: /QIBM/ProdData/WebSphere/AppServer/V85/Express
Base: /QIBM/ProdData/WebSphere/AppServer/V85/Base
ND: /QIBM/ProdData/WebSphere/AppServer/V85/ND
NDDMZ: /QIBM/ProdData/WebSphere/AppServer/V85/NDDMZ
AppClient: /QIBM/ProdData/WebSphere/AppClient/V85/client
WebServer Plugins: /QIBM/ProdData/WebSphere/Plugins/V85/webserver
Liberty Express: /QIBM/ProdData/WebSphere/Liberty/V85/Express
InstallRoot : <product_location>
Offering : <offering_ID>
Offering version : <offering_version : '8.5.5001.20131019_0136'>
Provider : IBM WebSphere
Provider version : <installed_version: 8.5.5.0 | 8.5.5.1 | etc., '8.5.0.0' denotes the GA product version>
Product ID : <EXPRESS | BASE | ND | NDDMZ | PLG | APPCLIENT | LIBERTY_EXPRESS>

This file represents a snapshot of the WebSphere installations that were registered with IM at the time the PTF was installed, and may not contain current information if used at a later date. This file is found in the following location:


/QIBM/WAS/WASFIXPACKS/<was_fixpack_product>/<was_fixpack_version>/WEBSPHEREINSTALLS.TXT

You cannot make an in-place update of the Version 8.5.0.x Liberty profile feature. In WebSphere Application Server Version 8.5.5.0, the Liberty profile was promoted from a feature to an independently installable offering.

If you are updating an existing WebSphere Application Server Version 8.5.0.x Liberty profile feature, you must install the corresponding WebSphere Application Server Liberty product offering at Version 8.5.5.0 or later. You cannot make an in-place update of the Version 8.5.0.x Liberty profile feature to Version 8.5.5.0 or later.

To migrate your installation, you can copy your data and server configurations to the new installation. If your user data are kept in another location, follow typical procedures for managing your data and server configurations.

Based on the Websphere installed product options present, the WebSphere Application Server v8.5 Group PTF provides the Liberty Web Enablement profile repository (i.e. /QIBM/WAS/WASFIXPACKS/LIBERTYEXPRESS/<was_fixpack_version>/FIXPACK) that can be used to update the WebSphere Application Server Liberty Web Enablement product offering at Version 8.5.5.0 or later. For full details refer to documentation found here: "Updating the Liberty profile from Version 8.5.0 to Version 8.5.5"

Note: The IBM i WebSphere Application Server Group PTF does not supply fix packs for the IBM WAS Liberty Base and Network Deployment (ND) editions. These fix packs will have to be downloaded from IBM's Recommended Fixes for WAS site below.

If you installed the Liberty profile using a self extracting archive, you must download a fix pack archive for the Liberty profile to upgrade to the latest fix level. Fix pack archive files for the Liberty profile are not provided with the WebSphere Application Server PTF Group. For information about obtaining and installing the fix pack archives for the Liberty profile, please see at "Recommended fixes for WebSphere Application Server"

To install the fix pack using the manual method, perform the following actions:

  1. Sign on to the IBM i system with a user profile that has *ALLOBJ and *SECADM special authorities.
  2. Display the current value of QALWOBJRST and then change it to *ALL if needed.
  3. The WebSphere Group PTF has also provided a local repository for the latest IBM Installation Manager (IM) fix pack, and it is recommended that the IM be updated before you install the WebSphere fix packs provided by the WebSphere Group PTF. The Readme.txt and Readme.html files for the IM fix pack can be found here:
  4. Stop all servers and applications on the WebSphere Application Server installation that is being updated. These processes may include application server processes, nodeagent processes, deployment manager processes, job manager processes and WebSphere Application Server client applications.

    This is most easily done by ending all of the application server JVM jobs and the subsystem for the WAS installation version and edition you are updating.

    For example, if I am updating my WAS v8.5 Express installation; I would end all of the WAS v8.5 Express jobs in the QWAS85 subsystem first using the stopServer Qshell command for each profile job currently active in the subsystem:

    STRQSH
    cd <product_location>/bin

    Full Installation:
    ./stopServer <server> -profileName <profile>

    Liberty Installation:
    ./server stop <server>

    Note: The <server> and <profile> values are case sensitive and must match the names exactly.

    and then end the QWAS85 subsystem using the CL command:
    ENDSBS QWAS85 *IMMED
  5. Install the fix pack.
    From a system command line, invoke the following SBMJOB command to submit the installation process to batch via the UDPATEWAS job; where <Installation_Manager_location>, <offering_ID>, <product_location> and <was_fixpack_location> are defined above:

    SBMJOB CMD(STRQSH CMD('umask 022;<Installation_Manager_
    location>/eclipse/tools/imcl install <offering_ID> -acceptLicense -installationDirectory <product_location> -repositories <was_fixpack_location>')) JOB(UPDATEWAS) ALWMLTTHD(*YES) JOBQ(QSYS/QSYSNOMAX)

    Note: One of the product features, Extended Programming Models, in WebSphere Application Server Liberty Profile has been reclassified as a product asset of type add-on in WebSphere Application Server Liberty Profile, Version 8.5.5.4. As a result, if you are updating the WebSphere Application Server liberty profile to fixpack 4 (8.5.5.4), you also need to accept the add-on license terms by specifying the -properties user.accept.license=true option:

    SBMJOB CMD(STRQSH CMD('umask 022;<Installation_Manager_
    location>/eclipse/tools/imcl install <offering_ID> -acceptLicense -installationDirectory <product_location> -repositories <was_fixpack_location> -properties user.accept.license=true')) JOB(UPDATEWAS) ALWMLTTHD(*YES) JOBQ(QSYS/QSYSNOMAX)

    Note: IBM recommends the use of the SBMJOB command to submit the installation to batch instead of running the command interactively. Running the installation 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:
  6. To verifiy that the fix pack correctly updated the WebSphere installation, execute the following Qshell command:

    Full Installation: <product_location>/bin/versioninfo
    Liberty Installation: <product_location>/bin/productInfo version
    The 'Version' or 'Product version' that this command lists should be the same as the fix pack version just installed.
  7. End and restart the HTTP Admin instance if it was active during the update. To end and restart the HTTP Admin invoke the following commands from a system command line:

    ENDTCPSVR SERVER(*HTTP) HTTPSVR(*ADMIN) STRTCPSVR SERVER(*HTTP) HTTPSVR(*ADMIN)
    Note: In addition, you will want to restart any HTTP server instances associated with your WAS v8.5 application servers. This can be done using the following commands.
    ENDTCPSVR SERVER(*HTTP) HTTPSVR(<HTTPserver>) STRTCPSVR SERVER(*HTTP) HTTPSVR(<HTTPserver>)
  8. Once the IBM WAS Fix Pack installation has been verified as successful, you are free to start your IBM WebSphere Application Server profiles back up using the following Qshell command.

    Full Installation: <product_location>/bin/startServer <server> -profileName <profile>
    Liberty Installation: <product_location>/bin/server start <server>
    In addition, you also may want to change your QALWOBJRST IBM i system value back to its original value using the following CL command: CHGSYSVAL SYSVAL(QALWOBJRST) VALUE(<previousValue>)
  9. The fix pack installation 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

    Note: The <was_fixpack_location> directories can be large and are not managed or deleted by WebSphere. After all WebSphere installations have been updated and they are no longer needed, the system administrator can delete them and all their contents. Tip: IBM recommends saving the previous fix pack installation repository in case you need to rollback the fix pack to the previous version.

    Additional information about installing a fix pack may be found in the information center article, "Installing fix packs on IBM i operating systems using the Installation Manager command line", for Express, Base, and Network Deployment.

Uninstalling a fix pack

Note: Prior to updating your IBM WebSphere Application Server installation, it is HIGHLY recommended to export/backup your IBM Installation Manager and WebSphere Application Server installation data. Please refer to the IBM Software Technical Document: "How and When To Export/Backup Your IBM Installation Manager and WebSphere Application Server Installation Data on the IBM i?" for more information.

Uninstalling a fix pack can be accomplished by rolling back the product to an earlier version using the instructions outlined in the document below.

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

Optional: If you have a Passport Advantage account, you can also rollback the product to an earlier version using an IBM WebSphere Application Server live repository.

To roll back the IBM WAS product to an an earlier version using a live repository, perform the following steps:

  1. Sign on to the IBM i system with a user profile that has *ALLOBJ and *SECADM special authorities.
  2. Display the current value of QALWOBJRST and then change it to *ALL if needed.
  3. The WebSphere Group PTF has also provided a local repository for the latest IBM Installation Manager (IM) fix pack, and it is recommended that the IM be updated before you rollback the WebSphere fix packs provided by the WebSphere Group PTF. The Readme.txt and Readme.html files for the IM fix pack can be found here:
  4. Stop all servers and applications on the WebSphere Application Server installation that is being updated. These processes may include application server processes, nodeagent processes, deployment manager processes, job manager processes and WebSphere Application Server client applications.

    This is most easily done by ending all of the application server JVM jobs and the subsystem for the WAS installation version and edition you are updating.

    For example, if I am updating my WAS v8.5 ND installation; I would end all of the WAS v8.5 ND jobs in the QWAS85 subsystem first using the stopServer Qshell command for each profile job currently active in the subsystem:

    STRQSH cd <product_location>/bin

    Full Installation: ./stopServer <server>
    -profileName <profile>

    Liberty Installation: ./server stop <server>
    Note: The <server> and <profile> values are case sensitive and must match the names exactly.

    and then end the QWAS85 subsystem using the CL command: ENDSBS QWAS85 *IMMED
  5. On a CL command line, run the STRQSH command to start the Qshell command shell.
  6. Make sure that the umask is set to 022.
  7. Change to the <Installation_Manager_
    location>/eclipse/tools directory by executing the following command: cd <Installation_Manager_
    location>/eclipse/tools
  8. Construct the repository URL for your IBM WAS version and edition based on the <offering_ID> argument discussed earlier.
    ${REPOSITORY} would equal:

    http://www.ibm.com/
    software/repositorymanager
    /<offering_ID>/
    repository.config

    Example: the repository URL for the IBM WebSphere Application Server v8.5 ND product:
    http://www.ibm.com/software/repositorymanager/com.ibm.websphere.ND.v85/repository.config
  9. Encrypt your IBM Passport Advantage userID and password into a secure storage file.
  10. 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: ND
    Version: 8.5.5.2
    Installation Location: /QIBM/ProdData/WebSphere/AppServer/V85/ND
    Installation Library: QWAS85A
    Default Profile Location: /QIBM/UserData/WebSphere/Appserver/V85/ND
    For the above example, the ${INSTALL_DIR} variable would equal the value of the "Installation Location" parameter, which equals:
    /QIBM/ProdData/WebSphere/AppServer/V85/ND
  11. Display the installation event history for your installation and determine the "Package" value for the fix pack version you wish to roll back to.

    Full Installation: ${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.2 ND installation that I would like to roll back to v8.5.5.1. I would execute the historyInfo command as displayed below. Then, I would locate the v8.5.5.1 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.

    Installation Event
    Install Manager Offering ID com.ibm.websphere.ND.v85
    Action install
    Version 8.5.5.1
    Package com.ibm.websphere.ND.v85_
    8.5.5001.20131018_2242
    Log File Name /QIBM/UserData/InstallationManager/logs/20140122_1618.xml
    Timestamp 2014-01-22 16:21:51-0600
    Result success
    Installed Features EJBDeploy tool for pre-EJB 3.0 modules Embeddable EJB container Stand-alone thin clients and resource adapters
    In my example, ${PACKAGE} would be equal to com.ibm.websphere.ND.v85_
    8.5.5001.20131018_2242
    since I want to roll back the installation to v8.5.5.1.

    Liberty Installation:

    You will have to first list the available packages in the repository and then select the package version you wish to rollback to from the list. The package version selected from the list will equal ${PACKAGE}. To list the available packages in the repository, execute the following:

    STRQSH cd <Installation_Manager
    _location>/eclipse/tools ./imcl listAvailablePackages -repositories ${REPOSITORY} - secureStorageFile /tmp/secureStorageFile.txt -masterPasswordFile /tmp/masterPasswordFile.txt

    The result will be a list of all available packages in the repository.

    For example, I have a WAS v8.5.5.2 Liberty ND installation that I would like to roll back to v8.5.5.1. First, I would execute the "imcl listAvailablePackages" command as displayed below.

    ./imcl listAvailablePackages -repositories http://www.ibm.com/software/
    repositorymanager
    /com.ibm.websphere .liberty.WEBENAB.v85
    /repository.config -secureStorageFile /tmp/secureStorageFile.txt -masterPasswordFile /tmp/masterPasswordFile.txt

    Then, I would locate the v8.5.5.1 package for the currently installed <offerring_ID>, which happens to be "com.ibm.websphere.liberty
    .ND.v85". After reviewing the output of the "imcl listAvailablePackages" command, I found the following packages available in the repository.

    8.5.5.1 - com.ibm.websphere.liberty
    .ND.v85_8.5.5001.20131019_0136
    8.5.5.2 - com.ibm.websphere.liberty
    .ND.v85_8.5.5002.20140408_2239

    In my example, ${PACKAGE} would be equal to com.ibm.websphere.liberty
    .ND.v85_8.5.5001.20131019_0136
    since I want to roll back the installation to v8.5.5.1.
  12. Execute the rollback of the IBM WebSphere Application Server installation to the previous fix pack version using a live repository.

    From a system command line, invoke the following SBMJOB command to submit the rollback process to batch via the UDPATEWAS job; where <Installation_Manager_location>, ${PACKAGE}, ${INSTALL_DIR} and ${REPOSITORY} are defined above:

    SBMJOB CMD(STRQSH CMD('umask 022;<Installation_Manager_
    location>/eclipse/tools/imcl rollback ${PACKAGE} -installationDirectory ${INSTALL_DIR} -repositories ${REPOSITORY} -secureStorageFile /tmp/secureStorageFile.txt - masterPasswordFile /tmp/masterPasswordFile.txt')) JOB(UPDATEWAS) ALWMLTTHD(*YES) JOBQ(QSYS/QSYSNOMAX)

    Note: One of the product features, Extended Programming Models, in WebSphere Application Server Liberty Profile has been reclassified as a product asset of type add-on in WebSphere Application Server Liberty Profile, Version 8.5.5.4. As a result, if you are rolling back the WebSphere Application Server liberty profile from fixpack 4 (8.5.5.4), you also need to accept the add-on license terms by specifying the -properties user.accept.license=true option:

    SBMJOB CMD(STRQSH CMD('umask 022;<Installation_Manager
    _location>/eclipse/tools/imcl rollback ${PACKAGE} -installationDirectory ${INSTALL_DIR} -repositories ${REPOSITORY} -secureStorageFile /tmp/secureStorageFile.txt -masterPasswordFile /tmp/masterPasswordFile.txt -properties user.accept.license=true')) 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 <Installation_Manager_location>
    /eclipse/tools $ ./imcl rollback ${PACKAGE} -repositories ${REPOSITORY} -installationDirectory ${INSTALL_DIR} -secureStorageFile /tmp/secureStorageFile.txt -masterPasswordFile /tmp/masterPasswordFile.txt -properties user.accept.license=true -showVerboseProgress

    Note: One of the product features, Extended Programming Models, in WebSphere Application Server Liberty Profile has been reclassified as a product asset of type add-on in WebSphere Application Server Liberty Profile, Version 8.5.5.4. As a result, if you are rolling back the WebSphere Application Server liberty profile from fixpack 4 (8.5.5.4), you also need to accept the add-on license terms by specifying the -properties user.accept.license=true option:

    umask 022 $ cd <Installation_Manager_location>
    /eclipse/tools $ ./imcl rollback ${PACKAGE} -repositories ${REPOSITORY} -installationDirectory ${INSTALL_DIR} -secureStorageFile /tmp/secureStorageFile.txt -masterPasswordFile /tmp/masterPasswordFile.txt -properties user.accept.license=true -showVerboseProgress


    Once the fix pack rollback completes, you should receive the following message:
    Rolled back to ${PACKAGE} in the ${INSTALL_DIR} directory.

    Here is an example command to rollback the IBM WAS ND v8.5 product to 8.5.5.1 from 8.5.5.2.

    ./imcl rollback com.ibm.websphere.ND.v85_
    8.5.5001.20131018_2242 -repositories http://www.ibm.com/software/repositorymanager/com.ibm.websphere.ND.v85/repository.config -installationDirectory /QIBM/ProdData/WebSphere/AppServer/V85/ND -secureStorageFile
    /tmp/
    secureStorageFile.txt -masterPasswordFile
    /tmp/
    masterPasswordFile.txt -showVerboseProgress


    In my example, here is the message that was returned indicating a successful rollback operation.

    Rolled back to com.ibm.websphere.ND.v85_
    8.5.5001.20131018_2242
    in the /QIBM/ProdData/WebSphere/AppServer/V85/ND directory.

    Note: Rollback of the fix pack may take over an hour depending on your IBM i system. If memory available to the IBM Installation Manager is limited, the update can take much longer, potentially several hours. You will know the rollback process has completed when the UPDATEWAS job ends or the "./imcl rollback" command returns to a dollar sign in Qshell.
  13. Verify the IBM WebSphere Application Server installation is at the new version.

    Execute the following Qshell command:

    Full Installation:
    ${INSTALL_DIR}/bin/versionInfo
    i.e. /QIBM/ProdData/WebSphere/AppServer/V85/ND/bin/versionInfo

    Liberty Installation:
    ${INSTALL_DIR}/bin/productInfo version
    i.e. /QIBM/ProdData/WebSphere/Liberty/V85/ND/bin/productInfo version

    Installed Product
    Name IBM WebSphere Application Server - ND
    Version 8.5.5.1
    ID ND
    Build Level cf011341.03
    Build Date 10/18/13
    Package com.ibm.websphere.ND.v85_
    8.5.5001.20131018_2242
    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 ND installation was successfully rolled back from 8.5.5.2 to 8.5.5.1.
  14. Once the IBM WAS Fix Pack rollback has been verified as successful, you are free to start your IBM WebSphere Application Server profiles back up using the following Qshell command.

    Full Installation: <product_location>/bin/startServer <server> -profileName <profile>
    Liberty Installation: <product_location>/bin/server start <server>
    In addition, you also may want to change your QALWOBJRST IBM i system value back to its original value using the following CL command: CHGSYSVAL SYSVAL(QALWOBJRST) VALUE(<previousValue>)
  15. 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.

    Additional information about rolling back a WebSphere Application Server installation to a previously installed version may be found in the information center article, "Uninstalling fix packs from IBM i operating systems using the command line", for Express, Base, and Network Deployment

[{"Product":{"code":"HW1A1","label":"IBM Power Systems"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Component":"--","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"Version Independent","Edition":"","Line of Business":{"code":"LOB57","label":"Power"}}]

Document Information

Modified date:
03 May 2021

UID

isg3T1027698