IBM FileNet P8, Version 5.2.1            

Enabling client logging for Bulk Import Tool

If you want more detailed debug logging information than the information that is provided in the default logging in the journals file, you can enable client-side logging.

Procedure

To enable Bulk Import Tool client logging:

  1. In the directory where the tool is started, create a file that is named log4j.properties.
  2. Open the file and add the following lines:
    log4j.rootLogger=ERROR, TXT
    # log4j.logger.com.filenet.wcm.api.impl.RemoteCommand=WARN
    # log4j.logger.com.filenet.wcm.api.impl.RemoteCommand=DEBUG
    
    log4j.appender.TXT=org.apache.log4j.FileAppender
    log4j.appender.TXT.layout=org.apache.log4j.PatternLayout
    log4j.appender.TXT.layout.ConversionPattern=%-4r %d [%t] %-5p %c{1} %x - %m%n
    log4j.appender.TXT.File=c:\\cebiClientLog.txt
    log4j.appender.TXT.Append=false
    
    log4j.logger.filenet_tracing = off
    log4j.logger.filenet_tracing.api.detail.moderate.summary = debug
    log4j.logger.filenet_tracing.api.detail.moderate = debug
    log4j.logger.filenet_tracing.api.detail = debug
  3. Modify the log4j.appender.TXT.File= entry in the properties file so that it uses a valid path and file name. Modifying the entry specifies the location and name of the output log file.
  4. Modify the logging levels in the properties file to return the appropriate level of logging that you want.
  5. To enable the logging in Bulk Import Tool, modify the startup script and add the following entry: -Dlog4j.configuration=file:log4j.properties
    Important: Client logging can increase system usage. Enable client logging only for debugging purposes.

Example

Here is an example of a startup script with the path specified:

"C:\Program Files (x86)\IBM\FileNet\ContentEngine\tools\_jvm17\jre\bin\java" -Dlog4j.configuration=file:log4j.properties -classpath "C:\Program Files (x86)\IBM\FileNet\ContentEngine\lib\Jace.jar;C:\Program Files (x86)\IBM\FileNet\ContentEngine\lib\log4j.jar;C:\Program Files (x86)\IBM\FileNet\ContentEngine\tools\CEBI\bulkimport.jar" bulkImport.BI_Start -h C:\CB521\config1



Last updated: October 2015
p8pit028.htm

© Copyright IBM Corporation 2015.