Knowledge Base
Published Sep. 10, 2025

Upgrading Liferay using a JNDI connection

Written By

Adrienne Lao

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.

Issue

  • When trying to upgrade a Liferay environment using a JNDI connection to the database the upgrade fails and produces errors. 
  • Auto upgrade portal properties ("upgrade.database.auto.run=true" and "schema.module.build.auto.upgrade=true") do not work with JNDI. 

Environment

  • DXP 7.4 

Resolution

If you are unable to immediately upgrade to a version containing the fix for LPS-197082, apply the following workaround:

 

  1. Open your portal-ext.properties file.

  2. Add the following property and leave the value blank: jdbc.default.driverClassName=

  3. Save the file and restart the Liferay server.

 

Setting this property to a blank value prevents the incorrect detection of Hypersonic, ensuring Liferay applies the upgrade.database.auto.run=true configuration during the next startup.

Did this article resolve your issue ?

Knowledge Base