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 spoon.sh (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 spoon.sh

source: http://pedroalves-bi.blogspot.com/20...ogging-in.html

Step 2)
Add a log4j.xml file beside spoon.sh / 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="http://jakarta.apache.org/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"/>
</layout>
</appender>

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

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

<!-- 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>
<category name="org.apache.chemistry.opencmis">
<priority value="DEBUG"/>
</category>

</log4j:configuration>

======================

HTH someone else in the future,
-D