FileNet P8 Workplace XT, Versão 1.1.5       Servidor de Aplicativos:  JBOSS Application Server     

Configurando o JBoss Application Server para o Workplace XT

Antes de poder usar o aplicativo da Web Workplace XT, é necessário configurá-lo primeiro para que ele funcione com o JBoss Application Server.

Para configurar o JBoss Application Server:
  1. Pare o JBoss Application Server, se ele estiver executando.
  2. Configure as definições de LDAP no servidor Workplace XT para que correspondam exatamente às configurações de Content Engine.
    Dica: Crie um backup do arquivo login-config.xml antes de fazer as mudanças.
    1. No servidor Workplace XT, abra login-config.xml, localizado em JBoss_home/server/server_name/conf, para edição.
    2. Inclua uma entrada <application-policy name="FileNet"> idêntica para que corresponda à entrada correspondente no arquivo login-config.xml do servidor Content Engine. Isso deve ser incluído no final do arquivos, antes da linha </policy> final.
      <authentication>
      <login-module code="org.jboss.security.auth.spi.UsersRolesLoginModule" 
      flag="required"/>
      </authentication>
      </application-policy>
      <application-policy name="FileNet">
      <authentication>
      <login-module
      code="org.jboss.security.auth.spi.LdapExtLoginModule" 
      flag="sufficient">
      <module-option name="java.naming.provider.url">ldap://cm-nihuevm9:389
      </module-option>
      <module-option name="java.naming.security.authentication">simple
      </module-option>
      <module-option name="allowEmptyPasswords">false</module-option>
      <module-option name="bindDN">cn=ceadmin,ou=shared,ou=engineering,
      ou=filenet,dc=apple</module-option>
      <module-option name="bindCredential">Password1</module-option>
      <module-option name="baseCtxDN">dc=apple</module-option>
      <module-option name="baseFilter">(cn={0})</module-option>
      <module-option name="rolesCtxDN">dc=apple</module-option>
      <module-option name="roleFilter">(cn={0})</module-option>
      <module-option name="roleAttributeID">memberOf</module-option>
      <module-option name="roleAttributeIsDN">true</module-option>
      <module-option name="roleRecursion">-1</module-option>
      </login-module>
      </authentication>
      </application-policy>
      </policy>

    Você pode copiar esta entrada a partir do arquivo Content Engine login-config.xml. Se você não tiver entradas customizadas no arquivo em seu servidor Workplace XT, poderá copiar todo o arquivo a partir de Content Engine, e substituir o arquivo login-config.xml no servidor Workplace XT.

  3. Configure permissões para o usuário executando o servidor de aplicativos.

    Se o usuário que estiver executando o servidor de aplicativos for diferente do usuário que instalou o Workplace XT, forneça permissões de leitura/gravação na seguinte pasta:

    install_path/IBM/FileNet/WebClient

    Para Windows, isso só é necessário para partições formatadas por NTFS.

  4. (Apenas JBoss Application Server 5.0.1) Remova o JSF 1.2 que faz parte da instalação do JBoss Application Server 5.0.1.

    A remoção dos arquivos e das referências dos arquivos no arquivo web.xml permite que o JBoss Application Server use o JSF 1.1 fornecido pelo Workplace XT.

    1. Exclua todos os arquivos jar localizados na pasta jsf-libs do servidor da Web, mas não exclua a pasta jsf-libs:

      JBoss_home/server/server_name/deploy/jbossweb.sar/jsf-libs

    2. Abra o arquivo web.xml (JBoss_home/server/default/deployers/jbossweb.deployer/web.xml) para edição.
    3. Modifique o arquivo web.xml para comentar as referências para a implementação do JSF 1.2, como mostrado na amostra a seguir.
      <!--
      <context-param>
      <param-name>com.sun.faces.injectionProvider</param-name>
      <param-value>org.jboss.web.jsf.integration.injection.
      JBossDelegatingInjectionProvider</param-value>
      </context-param>
       -->
      <!--
      <listener>
      <listener-class>org.jboss.web.jsf.integration.config.
      JBossJSFConfigureListener</listener-class>
      </listener>
      -->
      
      <!--
      <listener>
      <listener-class>com.sun.faces.application.WebappLifecycleListener
      </listener-class>
      </listener>
       -->
      
       <!--
      <init-param>
      <description>JSF standard tlds</description>
       <param-name>tagLibJar0</param-name>
      <param-value>jsf-libs/jsf-impl.jar</param-value>
      </init-param>
      <init-param>
      <description>JSTL standard tlds</description>
      <param-name>tagLibJar1</param-name>
      <param-value>jstl.jar</param-value>
      </init-param>
       -->
  5. Limpe todos os arquivos e pastas nos seguintes diretórios temporários:

    JBoss_home/server/server_name/tmp/deploy

    JBoss_home/server/server_name/work/jboss.web/localhost

  6. Desative a criação de log do JBoss Application Server para evitar o comportamento inesperado no software implementado do IBM® FileNet.

    Quando a criação de log for desativada, mensagens de erro ainda serão exibidas no console do JBoss Application Server.

    1. Abra o arquivo log4j.xml ou jboss-log4j.xml (JBoss_home/server/server_name/conf/log4j.xml) para edição.
    2. Inclua a linha a seguir (em negrito) ao anexador FILE, na seção Preservar Mensagens em um Arquivo Local:
      <!-- A time/date based rolling appender -->
      <appender name="FILE" class= "org.jboss.logging.appender.
      DailyRollingFileAppender">
      <errorHandler class="org.jboss.logging.util.OnlyOnceErrorHandler"/>
      <param name="File" value="${jboss.server.log.dir}/server.log"/>
      <param name="Append" value="false"/>
      <param name="Threshold" value="ERROR"/>
    3. Altere todos os valores de limite e de prioridade de

      INFO

      DEBUG

      TRACE

      para

      ERROR

      exceto para o valor de limite do anexador CONSOLE, que deve ser configurado como INFO, como mostrado em negrito abaixo:
      <appender name="CONSOLE" class="org.apache.log4j.ConsoleAppender">
      <errorHandler class="org.jboss.logging.util.OnlyOnceErrorHandler"/>
      <param name="Target" value="System.out"/>
      <param name="Threshold" value="INFO"/>
    4. Inclua as categorias específicas do IBM FileNet para evitar mensagens de rastreio excessivas no console, que podem impactar o desempenho. Inclua o seguinte no final da seção Limitar Categorias, antes da seção Configurar a Categoria-raiz:
      <category name="filenet_error.api">
      <priority value="ERROR"/>
      </category>
      <category name="filenet_tracing.api">
      <priority value="OFF"/>
      </category>
      
      <category name="com.filenet.wcm.api">
      <priority value="ERROR"/>
      </category>
      
      <category name="com.filenet-trace">
      <priority value="OFF"/>
      </category>
      
      <category name="com.filenet-debug">
      <priority value="ERROR"/>
      </category>

      Se outra mensagem de rastreio específica do IBM FileNet no console de comandos afetar o desempenho, inclua categorias adicionais nessas mensagens.

    5. Remova o valor de prioridade da categoria-raiz, se houver, como mostrado em negrito abaixo:
      <!-- ======================= -->
      <!-- Setup the Root category -->
      <!-- ======================= -->
      <root>
      <priority value="ERROR"/>
      <appender-ref ref="CONSOLE"/>
      <appender-ref ref="FILE"/>
      </root>
    6. Salve e feche o arquivo log4j.xml.
  7. Opcional: Inicie JBoss Application Server, como a seguir, para verificar se as mudanças na configuração tiveram êxito:
    Opção Descrição
    UNIX ./run.sh
    Windows run.bat


Feedback

Última atualização: Março de 2013
wxtip031.htm

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