Logging

Introduction

Penrose utilizes Log4j for logging. When running in the foreground, by default the output will be shown on the screen. When running in the background, by default the output will be stored in PENROSE_SERVER_HOME/var/penrose.out. Note: running Penrose in the debug mode will slow down the performance considerably.

Logging Configuration

The logging configuration is stored in PENROSE_HOME/conf/log4j.xml.

<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE log4j:configuration
        PUBLIC "-//Apache//DTD Log4j 1.2//EN"
        "http://logging.apache.org/log4j/docs/api/org/apache/log4j/xml/log4j.dtd">

<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/" debug="false"> 

  <appender name="timestamp" class="org.apache.log4j.ConsoleAppender"> 
    <layout class="org.apache.log4j.PatternLayout"> 
      <param name="ConversionPattern" value="[%d{MM/dd/yyyy HH:mm:ss}] %m%n"/>
    </layout>
  </appender> 

  <appender name="debug" class="org.apache.log4j.ConsoleAppender"> 
    <layout class="org.apache.log4j.PatternLayout"> 
      <param name="ConversionPattern" value="%-20C{1} [%4L] %m%n"/>
    </layout>
  </appender> 

  <appender name="file" class="org.apache.log4j.RollingFileAppender"> 
    <param name="File" value="var/penrose.log"/>
    <layout class="org.apache.log4j.PatternLayout"> 
      <param name="ConversionPattern" value="%-20C{1} [%4L] %m%n"/>
    </layout>
  </appender> 

  <logger name="org.safehaus.penrose" additivity="false">
    <level value="WARN"/> 
    <appender-ref ref="timestamp"/> 
  </logger> 

  <root> 
    <level value="OFF"/>
  </root> 

</log4j:configuration>

The default logging level is WARN. You can change the logging level either by modifying the log4j.xml or simply by specifying an command-line parameter below.

To start Penrose Server in verbose (INFO) mode:

penrose.bat -v

To start Penrose Server in debug mode:

penrose.bat -d