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

If PaaS Environment Hangs after Upgrade Deployment Should we Rollback?

written-by

Kenny Back

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

Issue

  • During an update we observed an error on startup and so decided to rollback from 5.X to a 4.X version. However, when we tried to restart services the system would not recover, hanging indefinitely. Further, the backup list became inaccessible. Eventually the matter resolved itself, but this was concerning and we want to know how it can be prevented?

Environment

  • 2024 Quarterly Releases

Resolution

  • Cloud stack service dependencies are defined in their respective LCP.json and ensure that services will start in the below sequence:
  1. database and search
  2. liferay
  3. backup and webserver
  • These as well as health checks result in a self healing mechanism and hence shouldn’t be a cause of concern. You can check the kubernetes events in the service status logs for more details during deployment: https://learn.liferay.com/w/liferay-cloud/support-and-troubleshooting/troubleshooting/reading-liferay-cloud-service-logs#log-types 
  • It is also not recommended to update each service as there are dependencies between them in a particular release. It is recommended to group all service version changes as per the corresponding service changelogs here: https://help.liferay.com/hc/en-us/articles/29035668172429-08-01-2024-Service-Release-Updates
  • Now in the case of a rollback, revert that particular build itself consisting of the group mentioned above.
  • Please note too that we do not suggest to rollback to a 4.x version as a long term option, it should be used only to stabilize the current environment during an incident. It is recommended that both the cloud platform and DXP updates are tested in non-production with code and data similar to production as much as possible.
  • Lastly, if you ever do need to rollback again let the engineer on the ticket know that the search volumes may need to be deleted as the environment can sometimes complain of the newer version of files when you start the older ES version.

 

did-this-article-resolve-your-issue

legacy-knowledge-base