How to enable FileNet P8 client tracing with Content Collector for SAP

Answer

Perform the following steps on the Content Collector for SAP server to enable FileNet P8 client tracing:

1. Create a file named log4j.properties with the following content:
   
   log4j.rootLogger=FATAL, FA
   log4j.logger.filenet_tracing.api=DEBUG, FA
   
   log4j.appender.FA=org.apache.log4j.RollingFileAppender
   log4j.appender.FA.File=/opt/IBM/iccsap/instances/logs/p8_api_trace.log
   log4j.appender.FA.MaxFileSize=200MB
   log4j.appender.FA.MaxBackupIndex=20
   log4j.appender.FA.layout=org.apache.log4j.PatternLayout
   log4j.appender.FA.layout.ConversionPattern=%d %5p [%t] - %m\r\n
   
2. Adjust the value of log4j.appender.FA.File to the desired log file location in your environment. For example,
• Unix:
  log4j.appender.FA.File=/opt/IBM/iccsap/instances/logs/p8_api_trace.log
• Windows:
  log4j.appender.FA.File=c:\\IBM\\iccsap\\instances\\logs\\p8_api_trace.log
3. Place log4j.properties in the same location where log4j.jar for the FileNet P8 Content Engine Client is found. For example,
• Unix:
  /opt/FileNet/CEClient/lib/
• Windows:
  C:\IBM\FileNet\CEClient\lib
4. In archint.ini, under JAVA_OPTIONS, add the following JVM parameter to point to the log4j.properties you just created. For example,
• Unix:
  JAVA_OPTIONS -Dlog4j.configuration=file:///opt/FileNet/CEClient/lib/log4j.properties
• Windows:
  JAVA_OPTIONS -Dlog4j.configuration=file:c:\IBM\FileNet\CEClient\lib\log4j.properties

Enclose the value in a pair of double quotes if there are spaces in the path.

1. Restart archpro to take effect.