There have been several references over the years of 'how do I enable the log4j logging?'. I just had to recently go through this for PDI 5.4, so wanted to share (and make it a new search result the next time I forget ;-).

Step 1)

Edit (or the equivalent on your operating system)

In the end of the file, look for a like that starts with OPT="..."

Add "-cp . " to the beginning of the line, staying with something like: OPT="-cp . $OPT (...)"

Drop a log4j.xml file to the same dir as


Step 2)
Add a log4j.xml file beside / spoon.bat (per the -cp classpath addition).

Sample log4j.xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration xmlns:log4j="" debug="false">

<appender name="FILE" class="org.apache.log4j.FileAppender">
<param name="File" value="log4j.log" />
<param name="Append" value="true" />
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="%t %-5p %c{2} - %m%n"/>

<priority value="INFO"/>
<appender-ref ref="FILE"/>

<category name="org.pentaho">
<priority value="WARN"/>

<!-- example to look at the logs of some underlying libraries from a custom step or plugin -->

<category name="org.apache.commons.httpclient">
<priority value="DEBUG"/>
<category name="org.apache.chemistry.opencmis">
<priority value="DEBUG"/>



HTH someone else in the future,