legacy-knowledge-base
公開されました Jun. 30, 2025

Migration Guidelines from Cloud Stack Version 4.x to 5.x

written-by

Vincent Liu

How To articles are not official guidelines or officially supported documentation. They are community-contributed content and may not always reflect the latest updates to Liferay DXP. We welcome your feedback to improve How To articles!

While we make every effort to ensure this Knowledge Base is accurate, it may not always reflect the most recent updates or official guidelines.We appreciate your understanding and encourage you to reach out with any feedback or concerns.

legacy-article

learn-legacy-article-disclaimer-text

Introduction

With the End of Functionality for Cloud Service Stack Version 4 on January 14, 2025, existing builds using Version 4 images will fail moving forward.

As Liferay Cloud Version 5 introduces new features and improvements, upgrading backup, database, Liferay, search, and web server services to the latest major image is required to take advantage of various fixes and enhancements.

Recommended Best Practices:

Updating to version 5 is as easy as updating to any minor version. Simply update the "image" property in your <service>/LCP.json files to version 5.0.0 or higher.

  1. Update the ci service using the CLI(see Deploying Changes via the CLI Tool)
  2. Edit the LCP.json files for all remaining services(backup, database, liferay, search, and webserver) to images version 5.0.0 or higher
  3. Commit the changes to your repository using these git commands(commands provided as an example, please use your normal SDLC process)
    • git add .
    • git commit -m "Update dxp cloud stack to XXX"
    • git push origin branchname
  4. Deploy to your environment
    • The deploy option can be found on the Builds page of the Cloud Console (3 dot menu -> deploy build to...)

Notes:

  • Once you've updated your services, be sure to take a look at Liferay Cloud Version 5 Changes for steps to leverage the improvements of version 5.
  • There is no expected downtime associated with this update aside from the amount of time it takes for the services to start up.

If you have any questions about this update or encounter any issues during the upgrade, please submit a ticket, and Liferay Support will be happy to assist.

did-this-article-resolve-your-issue

legacy-knowledge-base