legacy-knowledge-base
公開されました Sep. 10, 2025

Exception in thread "main" java.lang.ClassNotFoundException: com.liferay.portal.tools.DBUpgrader

written-by

Kartik Singh

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

  • While attempting to upgrade to the Liferay Quarterly Release, the following error was encountered, and the upgrade process failed:
    • Exception in thread "main" java.lang.ClassNotFoundException: com.liferay.portal.tools.DBUpgrader
       at java.base/java.net.URLClassLoader.findClass(URLClassLoader.java:445)
       at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:593)
       at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:526)
       at com.liferay.portal.tools.db.upgrade.client.DBUpgraderLauncher.main(DBUpgraderLauncher.java:33)

Environment

  • All Quarterly Release

Resolution

  • To resolve this issue and ensure the upgrade proceeds smoothly, modify the dir property by removing the version of Tomcat in app-server.properties file: (Path: Liferay_Home> tools> portal-tools-db-upgrade-client> app-server.properties)
  • Incorrect:
    • dir=../../tomcat-9.0.xx
  • Correct:
    • dir=../../tomcat
  • The full corrected configuration looks like this:
    • dir=../../tomcat
      extra.lib.dirs=/bin
      global.lib.dir=/lib
      portal.dir=/webapps/ROOT
      server.detector.server.id=tomcat
  • After making this change, the upgrade completes successfully without throwing any errors.

Additional Information

did-this-article-resolve-your-issue

legacy-knowledge-base