IBM FileNet P8, V5.1.+            

配置错误日志记录

要协助管理员调查 WebDAV 客户机与 FileNet® P8 WebDAV Servlet 之间的问题,可以使用 log4j 来启用服务器端日志记录,这将在 Workplace XT 环境中记录有意义的日志消息。

WebDAV Servlet 将记录以下类型的信息:

类型 信息
请求 当 WebDAV 客户机向 WebDAV Servlet 发出请求时,该请求主体中包含的标题及所有内容都会被记录下来。
响应 当向 WebDAV 客户机请求分派响应时,该响应主体中包含的所有响应头及内容都会被记录下来。
异常 如果遇到错误且发送回客户机的响应代码可能不包含信息,那么特定于 P8 的信息会被记录下来。
警告条件 如果遇到被视为警告但并不在发送给客户机的错误代码中指出的错误,那么会将警告连同一些说明性文本记录下来。

要配置错误日志记录,请完成下列步骤:

  1. 如果您尚未执行此操作,请以管理员身份登录 Workplace XT 服务器。
  2. 找到 log4j.properties 文件的缺省 Windows 或 UNIX 位置。例如,Windows 位置可能是 C:\Program Files\IBM\FileNet\WebClient\log4j.properties。UNIX 位置可能是 /opt/IBM/FileNet/WebClient/log4j.properties
  3. 执行以下操作之一:
    • 要启用 JBoss 和 WebLogic 的日志记录,请将 log4j 参数添加到启动脚本,然后启动 Workplace XT 服务器。例如,您可以将以下内容添加到启动脚本:
      Windows
      @REM log4j config @REM set
        log_conf="-Dlog4j.configuration=
        file:/C:\Progra~1\IBM\FileNet\WebClient\log4j.properties"
      UNIX
      # log4j config LOG_CONF="-Dlog4j.configuration=
        /opt/IBM/FileNet/WebClient/log4j.properties"
      WebLogic 8 - Windows
      %log_conf% 部分添加到 CLASSPATH 设置之后。例如:
        echo .  echo CLASSPATH=%CLASSPATH%  echo .  echo PATH=%PATH%  echo .  echo ***************************************************  echo * To start WebLogic Server, use a user name and *  echo * password assigned to an admin-level user. For *  echo * server administration, use the WebLogic Server *  echo * console at http:\[host_name]:[port]\console *  echo ***************************************************%JAVA_HOME%\bin\java %JAVA_VM% %MEM_ARGS% %JAVA_OPTIONS% %log_conf%
      - Dweblogic.Name=%SERVER_NAME%
      -Dweblogic.management.username=%WLS_USER%
      - Dweblogic.management.password=%WLS_PW%
      - Dweblogic.ProductionModeEnabled=%PRODUCTION_MODE%
      - Djava.security.policy="%WL_HOME%\server\lib\weblogic.policy" weblogic.Server
      WebLogic 8 - UNIX
      %log_conf% 部分添加到 CLASSPATH 设置之后,如下例中粗体部分所示:
      # Log4j properties fileLOG_CONF="-Dlog4j.configuration=/opt/IBM/FileNet/WebClient/log4j.properties"
      # Call WebLogic Server echo "."
      echo "CLASSPATH=${CLASSPATH}"
      echo "."
      echo "PATH=${PATH}"
      echo "."
      echo "***************************************************"
      echo "* To start WebLogic Server, use a user name and *"
      echo "* password assigned to an admin-level user. For *"
      echo "* server administration, use the WebLogic Server *"
      echo "* console at http://[host_name]:[port]/console *"
      echo "***************************************************"
      ${JAVA_HOME}/bin/java ${JAVA_VM} ${MEM_ARGS} ${JAVA_OPTIONS} ${LOG_CONF}
      - Dweblogic.Name=${SERVER_NAME}
      - Dweblogic.ProductionModeEnabled=${PRODUCTION_MODE}
      - Djava.security.policy="${WL_HOME}/server/lib/weblogic.policy" weblogic.Server
      WebLogic 9 - Windows
      %log_conf% 部分添加到 WLS_REDIRECT_LOG 设置中,如下例中粗体部分所示:
      If "%WLS_REDIRECT_LOG%"==""(
        echo Starting WLS with line:  echo %JAVA_HOME%\bin\java %JAVA_VM% %MEM_ARGS% %JAVA_OPTIONS% %jaas_login%-Dweblogic.Name=%SERVER_NAME%
      - Djava.security.policy=%WL_HOME%\server\lib\weblogic.policy
        %PROXY_SETTINGS% %SERVER_CLASS%
      %JAVA_HOME%\bin\java %JAVA_VM% %MEM_ARGS% %JAVA_OPTIONS% %log_conf%
      - Dweblogic.Name=%SERVER_NAME%
      -Dweblogic.management.username=%WLS_USER%
      - Dweblogic.management.password=%WLS_PW%
      - Djava.security.policy=%WL_HOME%\server\lib\weblogic.policy
      %PROXY_SETTINGS% %SERVER_CLASS%
        ) else (  echo Redirecting output from WLS window to %WLS_REDIRECT_LOG%%JAVA_HOME%\bin\java %JAVA_VM% %MEM_ARGS% %JAVA_OPTIONS% %jaas_login%
      - Dweblogic.Name=%SERVER_NAME%
      -Dweblogic.management.username=%WLS_USER%
      - Dweblogic.management.password=%WLS_PW%
      - Djava.security.policy=%WL_HOME%\server\lib\weblogic.policy
      %PROXY_SETTINGS% %SERVER_CLASS% >â€%WLS_REDIRECT_LOG%†2>&1 )
      WebLogic 9 - UNIX
      %log_conf% 部分添加到 WLS_REDIRECT_LOG 设置中,如下例中粗体部分所示:
      ${JAVA_HOME}/bin/java ${JAVA_VM} -version
      if [ "${WLS_REDIRECT_LOG}" = "" ] ; then
      echo "Starting WLS with line:"
      echo "${JAVA_HOME}/bin/java ${JAVA_VM} ${MEM_ARGS} ${JAVA_OPTIONS}
      - Dweblogic.Name=${SERVER_NAME}
      -Djava.security.policy=${WL_HOME}/server/lib/weblogic.policy
      ${PROXY_SETTINGS} ${SERVER_CLASS }"
      ${JAVA_HOME}/bin/java ${JAVA_VM} ${MEM_ARGS} ${JAVA_OPTIONS} ${JAAS_LOGIN}
      -Dweblogic.Name=${SERVER_NAME}
      -Djava.security.policy=${WL_HOME}/server/lib/weblogic.policy
      ${PROXY_SETTINGS} ${SERVER_CLASS}
      else echo "Redirecting output from WLS window to ${WLS_REDIRECT_LOG}"
      ${JAVA_HOME}/bin/java ${JAVA_VM} ${MEM_ARGS} ${JAVA_OPTIONS}
      ${LOG_CONF}
      -Dweblogic.Name=${SERVER_NAME}
      -Djava.security.policy=${WL_HOME}/server/lib/weblogic.policy
      ${PROXY_SETTINGS} ${SERVER_CLASS} >"${WLS_REDIRECT_LOG}" 2>&1
    • 要对 WebSphere® 启用日志记录,请将 log4j 参数添加到 WAS 管理控制台,然后启动 Workplace XT 服务器。例如,您可以进行以下操作。
      1. 在 WebSphere 6.0 中打开 WAS 管理控制台,并浏览至服务器 > 应用程序服务器 > server1 > 流程定义 > Java 虚拟机。如果您未使用 WebSphere 6.0,请查找相似的路径。
      2. 在“通用 JVM 参数”框中,添加下列其中一项:
        Windows
        -Dlog4j.configuration=
          C:\Progra~1\IBM\FileNet\WebClient\log4j.properties
        Solaris
        -Dlog4j.configuration=
          file:/opt/IBM/FileNet/WebClient/log4j.properties
  4. 保存并关闭服务器启动脚本。


反馈

最近一次更新时间: 2011 年 7 月


© Copyright IBM Corporation 2011.
本信息中心基于 Eclipse 技术。(http://www.eclipse.org)