Upgrading Liberty on distributed operating systems using the GUI

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

• Make sure that the Installation Manager preferences are pointing to web-based or local repositories containing the appropriate upgrades for the offering.

• If an interim fix is already installed on the offering that we are trying to upgrade but that specific interim fix is not applicable to the offering to which 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.

We 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

1. Stop all servers and applications on the WebSphere Application Server Liberty installation that is being upgraded.

2. Start Installation Manager.

3. Click Install.

   If we 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 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 to upgrade.

      Important: If selected an existing group that cannot be upgraded to the product that we are currently installing, an error will occur.

   3. Click Next.

7. Select any features 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.

     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 the system.

• Change to the eclipse/tools subdirectory in the directory where you installed Installation Manager.

• List the installed packages.
  ./imcl listInstalledPackages -long

  

  imcl.exe listInstalledPackages -long

• Use the imcl install command to upgrade the installation to a different edition in the same installation location:

  ./imcl install com.ibm.websphere.liberty.v85 
  -repositories source_repository -installationDirectory /opt/IBM/WebSphere/Liberty -acceptLicense -showProgress

  

  imcl install com.ibm.websphere.liberty.v85 
  -repositories source_repository -installationDirectory C:\Program Files\IBM\WebSphere\Liberty -acceptLicense -showProgress

Parent topic: Install Liberty on distributed operating systems

Tasks:
Install Installation Manager and prepare to install Liberty
Install Liberty on distributed operating systems using the GUI
Install Liberty on distributed operating systems using the command line
Install Liberty on distributed operating systems using response files
Add and remove features from Liberty on distributed operating systems
Uninstall Liberty from distributed operating systems using the GUI
Uninstall Liberty from distributed operating systems using the command line
Uninstall Liberty from distributed operating systems using response files
Create custom installation repositories with IBM Packaging Utility
Use the launchpad to start Liberty installations

---

Terms and conditions for information centers