Enable PE REST log for IBM ECM Widgets 4.5.2

Technote (troubleshooting)


Problem(Abstract)

How to enable PE REST log for IBM ECM Widgets 4.5.2

Symptom

Enable PE REST log for IBM ECM Widgets 4.5.2

Resolving the problem

Some ECM Widgets, such as the In-basket and Work Data widgets, communicate with Process Engine. To determine problems related to Process Engine, you must enable the PE REST log.

The PE REST log configuration file is located in WAS_JRE_HOME directory. For example: C:\Program Files\IBM\WebSphere\AppServer\java\jre\lib\fnlog4j.properties

Below is the sample content of the fnlog4j.properties file:

    #-----------------------------------------------------------------------------------
    # Updated 3/18/08
    # Check TXT.File for system-specific path
    # When enabling a logger, make sure that it has an appender, but you do not want too many
    # appender of the same type (via inheritance.) You may have duplicate messages when
    # both a logger and its parents have specified the same appender.
    #
    # When rootLogger is enabled, CE messages may be traced inadvertently and can be
    # quite verbose
    #-----------------------------------------------------------------------------------

    #log4j.debug=true
    log4j.rootLogger=ERROR, CON, TXT

    log4j.appender.CON=org.apache.log4j.ConsoleAppender
    log4j.appender.CON.layout=org.apache.log4j.PatternLayout
    log4j.appender.CON.layout.ConversionPattern=%d{yyyy/MM/dd HH:mm:ss} [%t] %-5p %c %x %m%n


    # for tracking REST accesses------------------------------------------
    log4j.appender.REST=org.apache.log4j.DailyRollingFileAppender
    log4j.appender.REST.layout=org.apache.log4j.PatternLayout
    log4j.appender.REST.layout.ConversionPattern=%d{yyyy/MM/dd HH:mm:ss} [%t] %m%n
    log4j.appender.REST.File=c:\\RESTLog.txt
    log4j.appender.REST.Append=true



    log4j.appender.TXT=org.apache.log4j.DailyRollingFileAppender
    log4j.appender.TXT.layout=org.apache.log4j.PatternLayout
    log4j.appender.TXT.layout.ConversionPattern=%d{yyyy/MM/dd HH:mm:ss} [%t] %-5p %c %x %m%n
    log4j.appender.TXT.File=c:\\pe.txt
    log4j.appender.TXT.Append=true

    log4j.appender.TTXT=org.apache.log4j.DailyRollingFileAppender
    log4j.appender.TTXT.layout=org.apache.log4j.PatternLayout
    log4j.appender.TTXT.layout.ConversionPattern=%d{yyyy/MM/dd HH:mm:ss} [%t] %-5p %c %x %m%n
    log4j.appender.TTXT.File=c:\\peRPCTimer.txt
    log4j.appender.TTXT.Append=true

    log4j.appender.RSCAPD=filenet.vw.base.logging.ResourcesAppender
    log4j.appender.RSCAPD.layout=org.apache.log4j.PatternLayout
    log4j.appender.RSCAPD.layout.ConversionPattern=%d{yyyy/MM/dd HH:mm:ss} [%t] %-5p %c %x %m%n
    log4j.appender.RSCAPD.File=c:\\peRSCAPD.txt
    log4j.appender.RSCAPD.PollingInterval=60
    log4j.appender.RSCAPD.Append=true



    # ---------------------- filenet.vw.* loggers --------------------
    log4j.logger.filenet.vw=ERROR, CON, TXT
    #
    #Make sure that you have the appender for the individual package
    #if that's the only thing you want to start tracing.#
    # ----------------------------------------------------------------

    # -------- API, BASE

    #log4j.logger.filenet.vw.api=DEBUG
    #log4j.logger.filenet.vw.api.VWWorkBasket=DEBUG
    #log4j.logger.filenet.vw.base=DEBUG
    #log4j.logger.filenet.vw.server=DEBUG
    #log4j.logger.filenet.vw.LoginModule=DEBUG
    #log4j.logger.filenet.vw.idm=DEBUG
    #log4j.logger.filenet.vw.ppm=DEBUG
    #log4j.logger.filenet.vw.router=DEBUG
    #log4j.logger.filenet.vw.soap=DEBUG
    #log4j.logger.filenet.vw.soap.transport=DEBUG
    #log4j.logger.filenet.vw.soap.server=DEBUG
    #log4j.logger.filenet.vw.sysutils=DEBUG
    #log4j.logger.filenet.vw.sysutils.imageservices=DEBUG
    #log4j.logger.filenet.vw.timer=DEBUG


    #------- Apps
    #log4j.logger.filenet.vw.apps.coordinator=DEBUG
    #log4j.logger.filenet.vw.apps.designer=DEBUG
    #log4j.logger.filenet.vw.apps.taskman=DEBUG
    #log4j.logger.filenet.vw.apps.taskman.integrator=DEBUG
    #log4j.logger.filenet.vw.apps.taskman.wfservices=DEBUG
    #log4j.logger.filenet.pe.server=DEBUG

    # ----- Toolkit
    #log4j.logger.filenet.vw.toolkit.utils=DEBUG
    #log4j.logger.filenet.vw.toolkit.utils.ws=DEBUG
    #log4j.logger.filenet.vw.toolkit.utils.uicontrols=DEBUG

    # ------- Component Integrator
    #log4j.logger.filenet.vw.ComponentIntegrator=INFO,TXT
    #log4j.logger.filenet.vw.ComponentIntegrator.WebServices=DEBUG
    #log4j.logger.filenet.vw.ComponentIntegrator.WebServices.Call=DEBUG
    #log4j.logger.filenet.vw.ComponentIntegrator.WebServices.SSL=DEBUG
    #log4j.logger.filenet.vw.ComponentIntegrator.WebServices.eventlistener=DEBUG


    # ---------------------- filenet.ws.* loggers --------------------
    #log4j.logger.filenet.ws=ERROR, CON, TXT
    # ----------------------------------------------------------------

    # ----- WSDL API.

    #log4j.logger.filenet.ws.api=DEBUG
    #log4j.logger.filenet.ws.api.uddi=DEBUG
    #log4j.logger.filenet.ws.api.wsrr=DEBUG
    #log4j.logger.filenet.ws.utils=DEBUG
    #log4j.logger.filenet.ws.utils.schema=DEBUG
    #log4j.logger.filenet.ws.utils.att=DEBUG
    #log4j.logger.filenet.ws.utils.soapaction=DEBUG

    # ------ PEWS API
    #log4j.logger.filenet.vw.ws.server=DEBUG

    # ----- PO / P8BPMWSBroker servlet
    #log4j.logger.filenet.ws.listener.axis=DEBUG
    #log4j.logger.filenet.ws.listener.axis.detail=DEBUG
    #log4j.logger.filenet.ws.listener.axis.rm=DEBUG
    #log4j.logger.filenet.ws.listener.http=DEBUG
    #log4j.logger.filenet.ws.listener.http.request=DEBUG
    #log4j.logger.filenet.ws.listener.uddi=DEBUG
    #log4j.logger.filenet.ws.listener.pssim=DEBUG
    #log4j.logger.filenet.ws.listener.utils=DEBUG
    #log4j.logger.filenet.ws.listener.wsdl=DEBUG
    #log4j.logger.filenet.ws.listener.utils.properties=DEBUG

    # ---------------------- filenet.pe.* loggers --------------------
    #log4j.logger.filenet.pe=ERROR, CON, TXT
    # Note that for the filenet.pe.rpc.resources.tracing to be enabled, the
    # filenet.pe.rpc.timer has to be enabled as well.
    # ----------------------------------------------------------------

    # ------ PE SSO
    # For the client (browser-JRE)
    #log4j.logger.filenet.pe.sso=DEBUG, CON, TXT
    #log4j.logger.filenet.pe.HTTP=DEBUG, CON, TXT
    #log4j.logger.filenet.pe.soap=DEBUG, CON, TXT



    # ------ PE LITTLE PIPE
    #log4j.logger.filenet.pe.ceorb.server=DEBUG

    # ------ PE IIOP 4.0 RPCs

    #log4j.logger.filenet.pe.ceutils=DEBUG
    #log4j.logger.filenet.pe.ceutils.token=DEBUG
    #log4j.logger.filenet.pe.ce.wfeventhandler=DEBUG
    #log4j.logger.filenet.pe.soap=DEBUG
    #log4j.logger.filenet.pe.soap.rpc=DEBUG
    #log4j.logger.filenet.pe.peorb.client=DEBUG
    #log4j.logger.filenet.pe.peorb.client.token=DEBUG
    #log4j.logger.filenet.pe.peorb.orb=DEBUG
    log4j.logger.filenet.pe.peorb.rpc.only=DEBUG,TXT
    #log4j.logger.filenet.pe.peorb.orb.timer=DEBUG
    #log4j.logger.filenet.pe.peorb.system=DEBUG
    log4j.logger.filenet.pe.rpc.parameter.in=DEBUG
    log4j.logger.filenet.pe.rpc.parameter.out=DEBUG
    #log4j.logger.filenet.pe.rpc.timer=DEBUG,TTXT
    log4j.logger.filenet.pe.rpc.exception=DEBUG
    #log4j.logger.filenet.pe.rpc.resources.tracing=DEBUG,RSCAPD
    #log4j.logger.filenet.pe.test.appserver=DEBUG


    #log4j.logger.filenet.vw.shortcircuit=DEBUG
    #log4j.logger.filenet.pe.rpc.call.stack=DEBUG


    # ---------------------- filenet.sim.* loggers --------------------
    log4j.logger.filenet.sim=ERROR, CON, TXT
    # ----------------------------------------------------------------

    #------ SIMULATION
    #log4j.logger.filenet.sim.api=DEBUG
    #log4j.logger.filenet.sim.appserver=DEBUG
    #log4j.logger.filenet.sim.animationdp=DEBUG
    #log4j.logger.filenet.sim.animationdp.retrieval=DEBUG
    #log4j.logger.filenet.sim.apps.console=DEBUG
    #log4j.logger.filenet.sim.toolkit.console=DEBUG

    #--- PS SERVER
    #log4j.logger.simulator=DEBUG
    #log4j.logger.simulator.animation=DEBUG
    #log4j.logger.simulator.core=DEBUG
    #log4j.logger.simulator.core.wo=DEBUG
    #log4j.logger.simulator.publisher=DEBUG
    #log4j.logger.simulator.loader=DEBUG


    # --------------- filenet.pa.* loggers -------------
    #log4j.logger.filenet.pa=INFO, CON, TXT
    #--------------------------------------------------
    #log4j.logger.filenet.pa=DEBUG
    #log4j.logger.filenet.pa.remote=DEBUG
    #log4j.logger.filenet.pa.admin.upgrade=DEBUG
    #log4j.logger.filenet.pa.admin.upgrade.v3200to3300=DEBUG
    #log4j.logger.filenet.pa.apps.rollup=DEBUG
    #log4j.logger.filenet.pa.support=DEBUG
    #log4j.logger.filenet.pa.datacollector=DEBUG
    #log4j.logger.filenet.pa.main=DEBUG
    #log4j.logger.filenet.pa.olap=DEBUG
    #log4j.logger.filenet.pa.publisher=DEBUG
    #log4j.logger.filenet.pa.publisher.fact=DEBUG
    #log4j.logger.filenet.pa.publisher.udf=DEBUG
    #log4j.logger.filenet.pa.rollup.db=DEBUG
    #log4j.logger.filenet.pa.rollup.etl=DEBUG
    #log4j.logger.filenet.pa.sql=DEBUG
    #log4j.logger.filenet.pa.util=DEBUG

    # ---------- filenet.pe.rest.* loggers---------
    log4j.logger.filenet.pe.rest=ERROR
    #--------------------------------------------------
    #log4j.logger.filenet.pe.rest.servlet=DEBUG
    #log4j.logger.filenet.pe.rest.request=DEBUG
    #log4j.logger.filenet.pe.rest.response=DEBUG
    #log4j.logger.filenet.pe.rest.handler=DEBUG
    #log4j.logger.filenet.pe.rest.utils=DEBUG

    log4j.logger.filenet.pe.rest.auditTrail=INFO,REST


There are mutilple sections in this file to control log level for Process Engine. 
To determine the problems related to ECM Widgets, you only need change the level for REST. Change the log level in linelog4j.logger.filenet.pe.rest, and use the right log writer, for example:
log4j.logger.filenet.pe.rest=DEBUG, REST

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

Case Foundation
ECM Widgets

Software version:

4.5.2

Operating system(s):

AIX, Windows

Software edition:

All Editions

Reference #:

1412161

Modified date:

2010-07-04

Translate my page

Machine Translation

Content navigation