Enabling error logging in the desktop Process Designer (deprecated)
You can configure IBM® Process
Designer to
log errors by using log4J
or java.util.log
.
You can then examine the logs to troubleshoot problems with Process Designer.
Traces and logs
Error logs and traces can
be located in a number of different places within the Process Designer installation
directory. You can find ae.log
and java.util.log
in
the main directory where Process Designer is
installed. Other logs are located in the <ProcessDesignerInstallationDirectory>\workspace\metadata
directory.
You can use the information in these logs to troubleshoot a problem. If you need to contact IBM Support, submit these logs to get the problem resolved faster.
Enabling log4J debug tracing
Configure Process Designer to
add debug statements to the ae.log file:
- Close Process Designer.
- Locate the file
twappserver.jar
in the directory<ProcessDesignerInstallationDirectory>\teamworks\eclipse\plugins\teamworks.appserver.websphere_version\lib
- From
twappserver.jar
, extract the filelog4j.xml
to the root Process Designer installation directory. - In
log4j.xml
, change the level value for thecom.lombardisoftware
logger from error to debug.Thelog4j.xml
file should be changed from:
to:<logger name="com.lombardisoftware" additivity="false"> <level value="error" /> <appender-ref ref="TWConsoleAppender" /> <appender-ref ref="TWFileAppender" /> </logger>
<logger name="com.lombardisoftware" additivity="false"> <level value="debug" /> <appender-ref ref="TWConsoleAppender" /> <appender-ref ref="TWFileAppender" /> </logger>
- Open
eclipse.ini
and point to the updatedlog4j.xml
by adding this line:-Dlog4j.configuration=file:<ProcessDesignerInstallationDirectory>/log4j.xml
- Restart Process Designer, recreate the problem, and note down the time stamp. The ae.log file should now contain the debug and error messages from Process Designer.
Enabling java.util.logging
To enable logging for java.util.logging messages, follow these steps:
- Close Process Designer.
- Navigate to the main Process Designer installation directory.
- Open
TraceSettings.properties
. Uncomment the line for the classes that you want to trace. - Restart Process Designer,
recreate the problem and examine the
java.util.log
file for errors. Thejava.util.log
file is located in the Process Designer installation directory.