Submit Feedback
Legacy Knowledge Base
Published Sep. 10, 2025

Common Upgrade Errors for Liferay DXP

Written By

Justin Choi

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

You are viewing an article from our legacy "FastTrack" publication program, made available for informational purposes. Articles in this program were published without a requirement for independent editing or verification and are provided"as is" without guarantee.

Before using any information from this article, independently verify its suitability for your situation and project.

This article documents the common configuration errors you may encounter while upgrading to Liferay Digital Experience Platform (DXP), versions 7.0 or 7.1.

Read below to discover the steps you can take to resolve these issues or avoid them altogether.

Resolution

Error: Upgrading to DXP

Summary: Upgrade process from legacy portal versions can fail.

Common Causes

  1. Permissions Algorithm 6
    1. Beginning in Liferay Portal 6.2, all previous algorithms have been deprecated.
  2. Document Storage and Image Storage: dl.store.impl= andimage.hook.
    1. The Liferay platform changed to file.system.store beginning with Liferay Portal, versions 6.1 and 6.2.
  3. Incorrect Database Connections 

Recommended Solution

  1. Regardless of which portal version the user started upgrading from, it is very important to prepare the new bundle’s portal-ext.properties. Liferay provides a virtual checklist for upgrading. This is the very short list (for the longer list, read the full dev.liferay.com and KB articles).
    1. Are the database name and connections the same?
    2. Permissions algorithm is set to 6.
    3. Document and image store and hooks are to manage the data migration from separate document and image galleries in Portal 6.0 and earlier to the new combined Docs and Media portlet in 6.1 and later.
  2. Besides the portal-ext.properties, there might be issues with the JVM, database and application servers. Please ensure that Liferay DXP supports these environments.

Prevention Tips

  1. For a smooth upgrade process, remember to backup your data before beginning.
  2. Check the portal.properties and portal-ext.properties. One benefit to upgrading to Liferay DXP is that the upgrade paths are already included in the portal.properties and do not have to be re-written in the portal-ext.properties.
  3. Liferay offers extensive documentation on the upgrade process so please read them before upgrading.

Additional Information

Did this article resolve your issue ?
Legacy Knowledge Base
Did this article resolve your issue ?