IBM FileNet P8, Versão 5.1.+            

Configurar log de erros

Para ajudar os administradores a investigar problemas entre um cliente WebDAV e o Servlet WebDAV do FileNet P8, é possível ativar a criação de log no lado do servidor usando log4j, que registrará mensagens que sejam significativas no ambiente do Workplace XT.

O servlet WebDAV registra os seguintes tipos de informações:

Tipo Informações
Solicitação Quando um cliente WebDAV emite um pedido para o servlet WebDAV, os cabeçalhos e quaisquer conteúdos contidos no corpo do pedido são registrados em log.
Resposta Ao despachar uma resposta para um pedido de um cliente WebDAV, quaisquer cabeçalhos da resposta e conteúdos contidos no corpo da resposta serão registrados em log.
Exceção Quando erros são encontrados e o código de resposta enviado de volta para o cliente não é informativo, as informações específicas do P8 são registradas em log.
Condição de aviso Quando são encontrados erros considerados avisos, mas que não se manifestam em um código de erro enviado para o cliente, um aviso é registrado em log com um texto explanatório.

Para configurar a criação de log de erros:

  1. Se você ainda não tiver feito isso, efetue logon no servidor do Workplace XT como um administrador.
  2. Localize o local padrão no Windows ou UNIX do arquivo log4j.properties. Por exemplo, o local no Windows pode ser C:\Program Files\IBM\FileNet\WebClient\log4j.properties. e o local no UNIX pode ser /opt/IBM/FileNet/WebClient/log4j.properties.
  3. Faça o seguinte:
    • Para ativar a conexão com JBoss e WebLogic, inclua o parâmetro log4j ao script de inicialização e, em seguida, inicie o servidor do Workplace XT. Por exemplo, você pode incluir o seguinte ao script de inicialização para:
      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
      Adicione a seção %log_conf% depois das configurações de CLASSPATH. Por exemplo:
      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
      Inclua a seção %log_conf% depois das configurações de CLASSPATH, como indicado em negrito no exemplo abaixo:
      # Log4j properties file 
       LOG_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
      Inclua a seção %log_conf% nas configurações de WLS_REDIRECT_LOG, como indicado em negrito no exemplo abaixo:
      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
      Inclua a seção %log_conf% nas configurações de WLS_REDIRECT_LOG, como indicado em negrito no exemplo abaixo:
      ${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
    • Para ativar a conexão com o WebSphere, inclua o parâmetro log4j ao console administrativo WAS e, em seguida, inicie o servidor Workplace XT. Por exemplo, você pode fazer o que se segue.
      1. Abra o console administrativo WAS no WebSphere 6.0 e navegue até Servidores > Servidores de Aplicativos > server1 > Definição de Processo > Java Virtual Machine. Localize um caminho semelhante se não estiver usando o WebSphere 6.0.
      2. Na caixa de argumentos JVM genérica, adicione um dos seguintes:
        Windows
        -Dlog4j.configuration=
          C:\Progra~1\IBM\FileNet\WebClient\log4j.properties
        Solaris
        -Dlog4j.configuration=
          file:/opt/IBM/FileNet/WebClient/log4j.properties
  4. Salve e feche o script de inicialização do servidor.


Feedback

Última atualização: Julho de 2011


© Copyright IBM Corporation 2011.
Este centro de informações foi desenvolvido com a tecnologia Eclipse. (http://www.eclipse.org)