FileNet P8 Application Engine, Versão 5.0.+       Servidor de Aplicativos:  JBOSS Application Server     

Configurando o Application Engine no JBoss Application Server

Após instalar o servidor Application Engine, você deve configurar o JBoss Application Server para trabalhar com Application Engine. Também é possível configurar mudanças para modos opcionais como SSO.

High availability Lembre-se: Em ambientes farm e cluster, configure o Application Engine no JBoss Application Server em todos os nós.
High availability clustered server environments Lembre-se: Em configurações de servidor de cluster de alta disponibilidade, para as etapas que necessitam que configurações da Java Virtual Machine (JVM) sejam feitas, certifique-se de fazer essas mudanças em cada nó na configuração do servidor de aplicativos.

Para configurar JBoss Application Server para Application Engine:

  1. Pare o JBoss Application Server se ele estiver em execução.
  2. Faça uma cópia de backup do arquivo run.conf e script de inicialização, dependendo da sua plataforma:
    Opção Descrição
    UNIX run.sh
    Windows run.bat
  3. Edite as configurações Java do arquivo run.conf.
    1. Inclua uma linha para especificar o caminho para o JDK fornecido pelo JBoss Application Server, conforme mostrado no seguinte exemplo (Windows): set JAVA_HOME=C:\Program Files\Java\jdk1.5.0_06

      Se seu JDK for diferente da versão 1.5.0, substitua sua versão pela listada.

    2. Atualize as configurações de memória JAVA_OPTS.

      O ajuste dessa configuração evita que o servidor de aplicativos fique sem memória, uma condição na qual os usuários podem não conseguir efetuar login no Workplace.

      Na linha JAVA_OPTS, altere os valores -Xms e -Xmx para sua configuração.

      Exemplo (Windows): set JAVA_OPTS=%JAVA_OPTS% -Xms 128m -Xmx 512 m

      Consulte a recomendação do fornecedor do servidor de aplicativos para os valores de tamanho de heap Inicial e Máximo. Para recomendações específicas do IBM®, consulte IBM FileNet P8 Performance Tuning Guide.

    3. (Apenas usuários Sun JVM) Configure o valor de MaxPermSize em JAVA_OPTS como 128m da seguinte forma:

      UNIX

      JAVA_OPTS=%JAVA_OPTS% -Xms128m -Xmx512m -XX:MaxPermSize=128m

      Windows

      set JAVA_OPTS=%JAVA_OPTS% -Xms128m -Xmx512m -XX:MaxPermSize=128m

      Esse valor aumentado evita erros de falta de memória que podem interromper o JBoss Application Server.

    4. Se seu servidor de aplicativos utilizar o IBM JVM, edite a variável JAVA_OPTS no arquivo run.conf imediatamente após a linha na subetapa anterior. Essa edição JAVA_OPTS melhora o desempenho.
      UNIX
      Localize a seguinte linha no arquivo run.conf:

      JAVA_OPTS="$JAVA_OPTS

      e altere-a para esta (sem retorno de linha):

      JAVA_OPTS="$JAVA_OPTS -Dfilenet.pe.peorb.pool.min=2 -Dfilenet.pe.peorb.pool.max=5"

      Windows
      Localize a seguinte linha no arquivo run.conf:

      set JAVA_OPTS=%JAVA_OPTS%

      e altere-a para esta (sem retorno de linha):

      set JAVA_OPTS=%JAVA_OPTS% -Dfilenet.pe.peorb.pool.min=2 -Dfilenet.pe.peorb.pool.max=5

    5. Salve suas edições e feche o arquivo.
  4. Configure o login do JAAS.

    Inclua uma das opções a seguir após a entrada "$JAVA" $JAVA_OPTS (UNIX) ou "%JAVA%" %JAVA_OPTS (Windows) no arquivo run.sh para UNIX ou o run.bat para Windows.

    Importante: Insira a entrada jaas_login como uma única linha sem quebras de linha. Não copie e cole o texto desse guia porque uma formatação oculta pode causar problemas com a entrada. Em vez disso, digite a entrada no script.

    Seu caminho pode ser um pouco diferente dependendo da versão das instalações clientes ou se você tiver escolhido um caminho customizado para instalação. Verifique o local do arquivo antes de inserir o caminho.

    UNIX
    "$JAVA" $JAVA_OPTS 
    -Djava.security.auth.login.config=
    "/opt/FileNet/AE/CE_API/config/jaas.conf.JBoss"
    "-Djava.endorsed.dirs=$JBOSS_ENDORSED_DIRS" -classpath
    "$JBOSS_CLASSPATH" org.jboss.Main $@
    Windows
    "%JAVA%" %JAVA_OPTS%
    "-Djava.security.auth.login.config=C:\Program
    Files\FileNet\AE\CE_API\config\jaas.conf.JBoss"
    "-Djava.endorsed.dirs=%JBOSS_ENDORSED_DIRS%" -classpath
    "%JBOSS_CLASSPATH%" org.jboss.Main %*
  5. Salve e feche o arquivo run.sh ou run.bat.
  6. Configure as definições de LDAP no Application Engine para corresponder exatamente às definições do Content Engine.
    1. No servidor Application Engine, abra login-config.xml, localizado em JBoss_home/server/server_name/conf, para edição.
    2. Configure a entrada <application-policy name="FileNet"> idêntica à entrada correspondente no arquivo login-config.xml no servidor Content Engine.
    3. Configure a entrada <application-policy name="FileNetP8Engine"> idêntica à entrada correspondente no arquivo login-config.xml no servidor Content Engine.
    4. Copie a nova entrada <application-policy name="FileNetP8Engine"> e cole a entrada copiada diretamente antes da entrada que você copiou (<application-policy name="FileNetP8Engine">).
    5. Altere a primeira instância de <application-policy name="FileNetP8Engine"> para <application-policy name="FileNetP8">.
    6. Mova todas as entradas <application-policy name=> relacionadas ao FileNet acima da entrada <application-policy name="other">.
    7. Salve as mudanças no arquivo login-config.xml no servidor Application Engine.
    8. Reinicie o JBoss Application Server.
  7. Configure permissões para o usuário executando o servidor de aplicativos.

    No Windows, as opções a seguir só são necessárias para partições formatadas por NTFS.

    Se o usuário que executa o servidor de aplicativos for diferente do usuário que instalou o Application Engine, você deverá fornecer ao usuário permissões de leitura e gravação na pasta onde você instalou o Application Engine (AE_install_path).

  8. (Opcional) Desative a criação de log do JBoss Application Server.

    No modo de desenvolvimento, o JBoss Application Server cria várias mensagens de log HTTP Access, "INFO", "DEBUG" e "TRACE". Isso pode causar um comportamento inesperado no software IBM FileNet implementado. É possível limitar esse tipo de criação de log excessiva do JBoss Application Server.

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

    1. Abra o arquivo log4j.xml (JBOSS_home/server/server_name/conf/log4j.xml) para edição.
    2. Altere todos os valores de limite e valores de prioridade de "INFO", "DEBUG" ou "TRACE" para "ERROR".
    3. Exclua ou comente uma linha de "Preservar mensagens em um arquivo local" para desativar o log do servidor.
    4. Para desativar a criação de logs de acesso HTTP, abra jboss-service.xml com um editor de texto e exclua ou comente uma linha da seção "Criador de Logs de Acesso".

      Local de jboss-service.xml:

      JBoss_Home/server/server_name/deploy/jbossweb-tomcat55.sar/META-INF

    5. Abra web.xml para editar e alterar logVerbosityLevel para "FATAL".

      Local de web.xml:

      JBoss_Home/server/server_name/deploy/jbossweb-tomcat55.sar/conf

    6. Reinicie o servidor JBoss Application Server.


Feedback

Última atualização: novembro de 2010


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