Upgrade: Packaging change of WebSphere Application Server Liberty profile in IBM Worklight v6.x
Important information about how WebSphere Application Server Liberty profile is delivered since IBM Worklight v6.0.0, and what is the impact on the upgrade of the production MobileFirst Server.
About this task
Important: The information on this page applies to you if you previously installed Worklight Server V5.x with the embedded WebSphere Application Server Liberty profile option.
Since IBM Worklight v6.1.0, WebSphere Application Server Liberty Core is not embedded in the IBM Installation Manager wizard of MobileFirst Server. Instead, it is provided as a separate IBM Installation Manager wizard.
Is this step required for the upgrade path? System status after this step, if both Application Center and MobileFirst Server are on the same application server Worklight Server V5.0.6.x to MobileFirst Server v6.3.0 Worklight Server v6.0.x to MobileFirst Server v6.3.0 Worklight Server v6.1.x to MobileFirst Server v6.3.0.x Worklight Server v6.2.x to MobileFirst Server v6.3.0 v6.3.0 to v6.3.0.x (fix pack or interim fix) Application Center Status MobileFirst Server Status Yes No No No No Run Run
As a result of this packaging, the MobileFirst Server upgrade process does not upgrade the installed version of WebSphere Application Server Liberty profile, and will not apply fix packs to it in the future. At the end of the upgrade process, the Liberty server remains installed in <WorklightServerInstallationDirectory>/server/wlp, but is considered as an external file from the perspective of upgrades, uninstall, and updates from the IBM Installation Manager wizard of MobileFirst Server.
To prevent this existing server from being uninstalled during the upgrade process, the IBM Installation Manager wizard temporarily renames its directory during the upgrade process. It is critical to apply the steps that are defined in section Special steps for WebSphere Application Server Liberty profile before you start the upgrade process. The result of not completing these steps can be a non-functional server.
Alternate Method: Move the MobileFirst apps and data to a new Liberty server
This alternate upgrade method migrates the MobileFirst Operations Console and Application Center to a new WebSphere Application Server Liberty profile server installed by IBM Installation Manager. This server can be updated by IBM Installation Manager when new updates for Liberty are made available.
- Stop the Liberty server that was installed with the previous version of IBM MobileFirst Platform Foundation.
- Install WebSphere Application Server Liberty Core with IBM Installation Manager. The installer for WebSphere Application Server Liberty Core is part of the MPF Foundation package.
- Create a server in this new WebSphere Application Server Liberty profile installation. If we are not familiar with the creation of a server for Liberty, see the Tutorial for a basic installation of MobileFirst Server.
- Configure the Liberty server for the production environment.
- Modify the Ant files created in section Identify the MobileFirst WAR file and prepare the Ant deployment script to point to the newly installed WebSphere Application Server Liberty Core.
- When you reach the step Running IBM Installation Manager and completing the Application Center upgrade, follow the instructions for Upgrading from Worklight Server V5.0.6.x (changing the Liberty server).
Parent topic: Preparation for upgrades to MobileFirst Server