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


Para configurar JBoss Application Server para Application Engine:
Procedimento
- Pare a instância do JBoss Application Server se ela estiver em execução.
- 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 - Edite as configurações do arquivo Java run.sh, run.conf ou run.conf.bat:
- 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.
- 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.
- (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.
- 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:
e altere-a para esta (sem retorno de linha):JAVA_OPTS="$JAVA_OPTS
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
Para 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
- Salve suas edições e feche o arquivo.
- 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
- 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 %*
- Salve e feche o arquivo run.sh, run.bat ou run.conf.bat.
- Configure as definições de LDAP no
Application Engine para corresponder
exatamente às definições do
Content Engine.
- No servidor Application Engine, abra login-config.xml, localizado em JBoss_home/server/server_name/conf, para edição.
- Configure a entrada <application-policy name="FileNet"> idêntica à entrada correspondente no arquivo login-config.xml no servidor Content Engine.
- Configure a entrada <application-policy name="FileNetP8Engine"> idêntica à entrada correspondente no arquivo login-config.xml no servidor Content Engine.
- Copie a nova entrada <application-policy name="FileNetP8Engine"> e cole a entrada copiada diretamente antes da entrada que você copiou (<application-policy name="FileNetP8Engine">).
- Altere a primeira instância de <application-policy name="FileNetP8Engine"> para <application-policy name="FileNetP8">.
- Mova todas as entradas <application-policy name=> relacionadas ao FileNet acima da entrada <application-policy name="other">.
- Salve as mudanças no arquivo login-config.xml no servidor Application Engine.
- Inicie a instância do JBoss Application Server.
- 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).
- (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.
- Abra o arquivo log4j.xml (JBOSS_home/server/server_name/conf/log4j.xml) para edição.
- Altere todos os valores de limite e valores de prioridade a partir de INFO, DEBUG ou TRACE para ERROR.
- Exclua ou comente Preservar Mensagens em um Arquivo Local para desativar o log do servidor.
- 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
- 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
- Reinicie a instância do JBoss Application Server.
Última atualização: Outubro de 2015
p8pin061.htm
© Copyright IBM Corporation 2013, 2015.