Após fazer o upgrade do servidor
Application Engine a partir da
versão 3.5, você deve configurar o
JBoss Application Server para trabalhar
com o Application Engine. Também é possível configurar mudanças para modos opcionais como SSO.
Importante: Em um ambiente altamente disponível, você deve configurar os upgrades do
Application Engine no servidor de aplicativos em todos os nós.
Para configurar
JBoss Application Server para
Application Engine:
- Pare o JBoss Application Server se
ele estiver em execução.
- 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 |
- Edite as configurações Java do arquivo
run.conf.
- 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
Importante: Se seu JDK for diferente da versão 1.5.0,
substitua sua versão por uma listada acima.
- 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 da IBM, consulte
IBM® FileNet P8 Performance Tuning
Guide.
- (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.
- Se seu servidor de aplicativos utilizar 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
- Salve as edições.
- 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 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.
Dica: 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 %*
- Salve e feche o arquivo run.sh ou o arquivo
run.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 acima da entrada que você copiou
(<application-policy name="FileNetP8Engine">).
- Altere a primeira instância de <application-policy
name="FileNetP8Engine"> para
<application-policy name="FileNetP8">.
- Salve as mudanças no arquivo
login-config.xml no servidor Application Engine.
- Reinicie o JBoss Application Server.
- 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 executará 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 um número
grande de mensagens de log HTTP Access, "INFO", "DEBUG" e "TRACE".
Isso pode causar um comportamento inesperado no software IBM FileNet
implementado.
Utilizando o procedimento a seguir, você pode limitar
esse tipo de criação de log do
JBoss Application Server excessiva.
Quando a criação de log for desativada, mensagens de erro ainda
serã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 de
"INFO", "DEBUG" ou "TRACE" para "ERROR".
- Exclua ou comente uma linha de "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 editar e alterar
logVerbosityLevel para "FATAL".
Local de web.xml:
JBoss_Home/server/server_name/deploy/jbossweb-tomcat55.sar/conf
- Reinicie o servidor
JBoss Application Server.