Legacy Knowledge Base
Published Sep. 10, 2025

Enable BundleStartStopLogger debug log traces

Written By

Mariano Alvaro

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.

Issue

  • How to enable BundleStartStopLogger debug log traces to see module lifecycle events during startup.

Environment

  • Liferay DXP 7.0+

Resolution

  1. Stop the server.
  2. If it doesn't exist create a folder named log4j inside $LIFERAY_HOME/osgi
  3. Inside the recently created folder:
    1. Deploy the attached file: log4j.dtd
    2. Create the following file: org.eclipse.osgi-log4j-ext.xml
      1. Before 7.4 u77 (Log4j 1.x)
        <?xml version="1.0"?>
        <!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">

        <log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
        <!-- DXP 7.0 to 7.3 -->
        <category name="com.liferay.portal.equinox.log.bridge.internal.BundleStartStopLogger">
        <priority value="DEBUG" />
        </category>
        <!-- DXP 7.4 -->
        <category name="com.liferay.portal.bootstrap.log.BundleStartStopLogger">
        <priority value="DEBUG" />
        </category>
        </log4j:configuration>
      2. From 7.4 u77 (Log4j 2.x)
        <?xml version="1.0"?>

        <Configuration strict="true">
        <Loggers>
        <Logger name="com.liferay.portal.bootstrap.log.BundleStartStopLogger" level="DEBUG"/>
        </Loggers>
        </Configuration>
  4. Start the server.
Did this article resolve your issue ?

Legacy Knowledge Base