FileNet P8 Application Engine, Versão 5.2.1       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.

Sobre Esta Tarefa

High availabilityLembre-se: Em ambientes farm e cluster, configure o Application Engine no JBoss Application Server em todos os nós.
High availability clustered server environmentsLembre-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:

Procedimento

  1. Pare a instância do JBoss Application Server se ela estiver em execução.
  2. Faça uma cópia de backup do arquivo run.conf (AIX, HPUX, Linux, Linux on System z, Solaris) ou run.conf.bat (Windows) e do script de inicialização, dependendo da sua plataforma:
    Opção Descrição
    AIX, HPUX, Linux, Linux em System z, Solaris run.sh
    Windows e JBoss 5.0 run.bat
    Windows e JBoss 5.1 run.conf.bat
  3. Edite as configurações do arquivo Java run.sh, run.conf ou run.conf.bat:
    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 obter recomendações específicas da IBM®, consulte Ajuste de desempenho de componentes do IBM FileNet P8.

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

      AIX, HPUX, Linux, Linux em System z, Solaris

      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 o seu servidor de aplicativos usar o IBM JVM, edite a variável JAVA_OPTS no arquivo run.conf ou run.conf.bat imediatamente após a linha na subetapa anterior. Essa edição JAVA_OPTS melhora o desempenho.
      AIX, HPUX, Linux, Linux em System z, Solaris
      Localize a linha a seguir 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 linha a seguir no arquivo run.bat ou run.conf.bat:

      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. High availabilityPara ambientes de alta disponibilidade, configure a consulta do JNDI para se conectar ao Content Engine e permitir failover.
      Em cada nó, edite o arquivo run.bat ou o arquivo run.sh para incluir o seguinte, inserido como uma linha única:
      -DFileNet.EJB.ContextProperties=java.naming.factory.initial=
      org.jboss.naming.NamingContextFactory
    6. Salve suas edições e feche o arquivo.
  4. Configure o login do JAAS.

    Inclua um dos seguintes logo após o "$JAVA" $JAVA_OPTS (AIX, HPUX, Linux, Linux on System z, Solaris) ou o "%JAVA%" %JAVA_OPTS (Windows) entrada no arquivo run.sh ou no arquivo run.bat, respectivamente

    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.

    AIX, HPUX, Linux, Linux em System z, Solaris
    "$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, run.bat ou run.conf.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. Inicie a instância do JBoss Application Server.
  7. Configure permissões para o usuário executando o servidor de aplicativos.

    No Windows, o requisito a seguir aplica-se apenas a 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 a partir de INFO, DEBUG ou TRACE para ERROR.
    3. Exclua ou comente 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 edição e altere logVerbosityLevel para FATAL.

      Local de web.xml:

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

    6. Reinicie a instância do JBoss Application Server.


Última atualização: Outubro de 2015
p8pin061.htm

© Copyright IBM Corporation 2013, 2015.