Problema
Erros de memória Insuficiente (OOM) podem ocorrer em uma instalação turnkey do JBoss do AdobeLiveCycle ES Update 1 (Service Pack 2) ou manual do JBoss com a instalação do MySQL. Esse problema está relacionado à versão do driver JDBC do MySQL e às configurações de conexão da fonte de dados.
Cuidado: essa atualização recomenda encerrar os serviços JBoss e MySQL antes de executar o instalador do Service Pack 2 (conforme indicado nas instruções de instalação).
Motivo
Solução
A versão 5.1.6 do driver JDBC deve ser instalada para reduzir o número de conjuntos de resultados abertos e resolver os problemas de memória insuficiente. A fonte de dados e as configurações da JVM também devem ser alteradas.
Obtenção e Instalação do driver JDBC
Esta seção descreve as tarefas necessárias para obter e instalar o driver JDBC do MySQL apropriado.
Para obter e instalar o driver para o JBoss não turnkey:
Observação:
no turnkey do JBoss, essa tarefa é executada pelo instalador do LiveCycle ES e não é necessária.
-
Localize e elimine o arquivo mysql-connector-java-3.1.12-bin.jar no diretório [JBoss_root]\server\all\lib. O local padrão é C:\Adobe\LiveCycle8.2\jboss\server\all\lib.
-
Localize e copie o arquivo [LiveCycleES_root]\patch\SP2\mysql-connsctor-java-5.1.6-bin.jar para o diretório [JBoss_root]\server\all\lib.
Alteração das configurações da fonte de dados
As configurações da fonte de dados, conforme definido no arquivo adobe-ds.xml, destinam-se a uma carga pesada com muitas conexões simultâneas e um tempo limite de conexão ociosa longa (10 minutos). Isso resulta em um grande número de instruções preparadas sendo armazenadas em cache no heap. Reduzir o tempo limite da conexão ociosa, o número de conexões abertas máximas e o tamanho do cache de instruções preparado para IDP_DS e EDC_DS resultará em uma redução da memória heap alocada para as conexões JDBC.
Para modificar as configurações da fonte de dados:
-
Localize e abra o arquivo adobe-ds.xml em um editor. Por padrão, ele está localizado em C:\Adobe\LiveCycle8.2\jboss\server\all\deploy.
-
Localize a linha <idle-timeout-minutes>10</idle-timeout-minutes> e altere o valor de 10 para 1.
Observação:
modifique esse valor para as definições IDP_DS e EDC_DS.
-
Na definição IDP_DS, localize <max-pool-size> e altere o valor para 20.
-
Na definição EDC_DS, localize <max-pool-size> e altere o valor para 10.
Observação:
se o número de solicitações do Gerenciamento de direitos for alto, o valor padrão de EDC_DS como 20 pode ser mantido.
-
Para ambas as definições, IDP_DS e EDC_DS, localize <prepared-statement-cache-size> e altere ambos os valores para 20.
Observação:
definir esse valor reduz a memória usada pelo cache e pode precisar ser ajustado com precisão com base na carga da transação no sistema.
Alteração das configurações da JVM
A instalação turnkey do JBoss define vários argumentos da JVM no arquivo run.bat e na definição de serviço do JBoss para Adobe LiveCycle ES. Após atualizar o driver JDBC, é possível modificar o arquivo run.bat.
Para modificar o arquivo run.bat:
-
Em um editor de texto, abra o arquivo run.bat localizado em C:\Adobe\LiveCycle8.2\jboss\bin.
-
Exclua os seguintes argumentos:
-XX:NewSize=500 -XX:MaxNewSize=500 -XX:SurvivorRatio=6
Se os Serviços de conteúdo não estiver instalado, o valor PermSize poderá ser reduzido para 128 MB.
-
Localize a definição XX: PermSize e modifique o valor para 128M.
-
Salve e feche o arquivo.
Para modificar a definição de serviço do JBoss para Adobe LiveCycle ES, é necessário desinstalar e reinstalar o serviço com novos argumentos da JVM especificados.
Alteração das configurações do JBossService
O servidor JBoss é configurado usando um arquivo em lote, o InstallJBossService.bat que é criado durante a instalação do sistema. Durante a configuração turnkey do LiveCycle, o LiveCycle PDF Generator ES que oferece suporte para conversão de documentos nativos é um recurso opcional. O arquivo em lote irá variar um pouco, dependendo se esse recurso está ativado.
Se durante a instalação você escolheu incluir este recurso, você inseriu um nome de usuário e senha na configuração do LiveCycle. Será necessário usar este nome de usuário e senha para completar a reinstalação do serviço JBoss.
Para desinstalar e reinstalar o serviço do JBoss para Adobe LiveCycle ES:
-
Em um editor de texto, abra o arquivo InstallJBossService.bat localizado em C:\Adobe\LiveCycle8.2\jboss.
-
Exclua os seguintes argumentos (Observação: no JBoss Turnkey, essa tarefa é executada pelo programa de instalação do LiveCycle ES e essa etapa não é necessária):
-XX:NewSize=500 -XX:MaxNewSize=500 -XX:SurvivorRatio=6
Se os Serviços de conteúdo não estiver instalado, o valor PermSize poderá ser reduzido para 128 MB.
-
(Opcional) Localize a definição XX: PermSize e altere o valor para 128M.
-
Verifique se a última parte do arquivo .bat contém -user %1 -password %2. Em caso afirmativo, a conversão do documento nativo foi configurada e será necessário inserir o nome de usuário e a senha ao reinstalar o serviço.
Observação:
esse não é o usuário do serviço JBoss, mas as credenciais do usuário para a conta usada na instalação do software do aplicativo nativo (como o Microsoft Office).
-
Salve e feche o arquivo.
Observação: é necessário o nome de usuário e senha que o serviço está usando. Para encontrar o nome de usuário, abra o Painel de controle dos serviços, clique com o botão direito do mouse em JBoss para o Adobe LiveCycle ES,
selecione Propriedades no menu e selecione a guia Logon. A mesma combinação de nome de usuário e senha usada durante a instalação original deve ser usada.
-
No Painel de controle dos serviços, interrompa o serviço JBoss para Adobe LiveCycle ES.
-
Verifique se o serviço não está sendo executado no Painel de controle do serviço ou ao digitar o seguinte comando:
JBossService -status "Jboss for Adobe LiveCycle ES"
A mensagem resultante indicará que o serviço foi interrompido.
-
Em um prompt de comando, mude para o diretório C:\Adobe\LiveCycle8.2\jboss e digite o seguinte comando para desinstalar o serviço:
JBossService -uninstall "Jboss for Adobe LiveCycle ES"
-
Após a desinstalação do serviço, reinstale-o executando o arquivo InstallJbossService.bat modificado.
-
Se a conversão de documentos nativos estiver ativada, o nome de usuário e a senha devem ser especificados digitando o seguinte comando:
InstallJBossService [domínio\nome de usuário][senha]
Onde [domínio\nome de usuário] e [senha] são as credenciais usadas durante a instalação original. Se a ID for um usuário local, ele será especificado usando a sintaxe NOME DO COMPUTADOR\NOME DE USUÁRIO. Uma ID de login do domínio deve ser especificado como DOMÍNIO\NOME DE USUÁRIO.
-
Verifique se o serviço está sendo executado no Painel de controle do serviço ou ao digitar o seguinte comando:
JBossService -status "Jboss for Adobe LiveCycle ES"