This topic applies to WebSphere Application Server Liberty V8.5.5.9 and earlier. For the latest Liberty topics, see the WebSphere Application Server Liberty documentation.

Upgrading Liberty on distributed operating systems using the GUI

You can use Installation Manager GUI to upgrade WebSphere® Application Server Liberty offerings on distributed operating systems.

Before you begin

  • Make sure that your Installation Manager preferences are pointing to web-based or local repositories that contain the appropriate upgrades for the offering.
  • If an interim fix is already installed on the offering that you are trying to upgrade but that specific interim fix is not applicable to the offering to which you want to upgrade, the upgrade will be blocked by Installation Manager. An error message will be generated that indicates that the interim fix is not applicable to the offering. Remove the interim fix before upgrading.

About this task

You can use Installation Manager to upgrade WebSphere Application Server Liberty offerings in the following paths:
  • WebSphere Application Server Liberty Core to WebSphere Application Server Liberty
  • WebSphere Application Server Liberty Core to WebSphere Application Server Liberty Network Deployment
  • WebSphere Application Server Liberty - Express® to WebSphere Application Server Liberty
  • WebSphere Application Server Liberty to WebSphere Application Server Liberty Network Deployment
  • WebSphere Application Server Liberty Trial to WebSphere Application Server Liberty
  • WebSphere Application Server Liberty Core Trial to WebSphere Application Server Liberty Core
  • WebSphere Application Server Liberty Network Deployment Trial to WebSphere Application Server Liberty Network Deployment
  • WebSphere Application Server Liberty for Developers to WebSphere Application Server Liberty
  • WebSphere Application Server Liberty for Developers to WebSphere Application Server Liberty Network Deployment

Procedure

  1. Stop all servers and applications on the WebSphere Application Server Liberty installation that is being upgraded.
  2. Start Installation Manager.
  3. Click Install.
    Note: If you are prompted to authenticate, use the IBM® ID and password that you registered with on the program website.

    Installation Manager searches its defined repositories for available packages.

  4. Select the name of the Liberty offering to which you want to upgrade and the appropriate version, and click Next.
  5. Accept the terms in the license agreements, and click Next.
  6. Complete the following actions.
    1. Select Use the existing package group.
    2. Select the package group of the product that you want to upgrade.
      Important: If you select an existing group that cannot be upgraded to the product that you are currently installing, an error will occur.
    3. Click Next.
  7. Select any features that you want to include in the upgraded installation and click Next.
  8. Review the summary information, and click Install.
    • If the upgrade is successful, the program displays a message indicating that installation is successful.
      Note: The program might also display important post-installation instructions as well.
    • If the installation is not successful, click View Log File to troubleshoot the problem.
  9. Click Finish.
  10. Click File > Exit to close Installation Manager.

Example

Here is an example of how to upgrade a WebSphere Application Server Liberty offering on distributed operating systems using the command line.
  • Log on to your system.
  • Change to the eclipse/tools subdirectory in the directory where you installed Installation Manager.
  • List the installed packages.
    For AIX platformsFor HP UNIX platformsFor LINUX platformsFor Solaris platforms
    ./imcl listInstalledPackages -long
    For Windows platforms
    imcl.exe listInstalledPackages -long
  • Use the imcl install command to upgrade the installation to a different edition in the same installation location:
    For AIX platformsFor HP UNIX platformsFor LINUX platformsFor Solaris platforms
    ./imcl install com.ibm.websphere.liberty.v85 
    -repositories source_repository -installationDirectory /opt/IBM/WebSphere/Liberty -acceptLicense -showProgress
    For Windows platforms
    imcl install com.ibm.websphere.liberty.v85 
    -repositories source_repository -installationDirectory C:\Program Files\IBM\WebSphere\Liberty -acceptLicense -showProgress

Icon that indicates the type of topic Task topic



Timestamp icon Last updated: Tuesday, 12 December 2017
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-libcore-mp&topic=twlp_ins_upgrading_dist_gui
File name: twlp_ins_upgrading_dist_gui.html