Orientação de atualização do AEM Forms JEE para compatibilidade de versão, SO, JBoss e plataforma
Os clientes que estão atualizando o AEM Forms no JEE — migrando para um service pack mais recente, migrando entre versões do RHEL ou escolhendo entre as versões 6.5.x e 6.5 LTS — precisam de confirmação oficial das plataformas compatíveis antes de continuar. O AEM Forms no JEE impõe compatibilidade estrita entre as camadas de SO, JBoss, Java e banco de dados, e as combinações compatíveis residem na matriz de plataforma da Adobe, mas precisam de mapeamento para o seu ambiente específico. Ignorar essa validação corre o risco de instalar binários sem suporte ou confirmar um caminho de atualização que não pode ser bem-sucedido. Confirmar sua combinação de SO, JBoss e Java em relação à matriz, obter os instaladores corretos e aplicar o service pack ou a atualização LTS em sequência resolve a incerteza.
Descrição description
Ambientes:
- Adobe Experience Manager Forms no JEE
- Adobe Experience Manager 6.5 (no local)
- Adobe Experience Manager 6.5 LTS
- JBoss EAP 7.4.x e JBoss EAP 8
- Red Hat Enterprise Linux e Windows Server
Problema/sintomas:
- Há incerteza sobre quais versões do AEM Forms oferecem suporte a plataformas de SO específicas, como RHEL 8, RHEL 9 e Windows Server 2022.
- Há incerteza sobre versões compatíveis do JBoss EAP ou do Java para uma versão específica do AEM Forms, como o JBoss 7.4.22 com SP22 ou o Java 17 e 21 com LTS.
- A solicitação é para confirmação oficial de plataformas compatíveis, disponibilidade do instalador, pré-requisitos e sequenciamento de atualizações, em vez de solução de problemas de quebra/conserto.
Causa raiz:
O AEM Forms no JEE impõe compatibilidade estrita entre as camadas de SO, JBoss, Java e banco de dados, portanto, as combinações precisam de validação antes de atualizar ou aplicar um service pack. O Adobe documenta as combinações compatíveis em sua matriz de plataforma, mas elas precisam de interpretação e mapeamento adequados para o seu ambiente. Sem confirmar as combinações compatíveis, você corre o risco de instalar binários não compatíveis ou planejar um caminho de atualização que não terá êxito.
Resolução resolution
Siga estas etapas para resolver o problema:
- Identifique a versão atual do AEM Forms JEE e os componentes da plataforma. Colete a versão do SO, a versão EAP JBoss, a versão Java e o tipo de banco de dados. Confirme executando
java -version, verificando a versão do console JBoss EAP e executando comandos de versão do SO, comocat /etc/redhat-releaseno RHEL. - Determine se seu destino é uma atualização de service pack ou uma migração LTS. O 6.5 LTS requer Java 17 ou 21 e JBoss EAP 8, enquanto as atualizações do service pack 6.5.x permanecem no Java 8 ou 11 e no JBoss 7.4.x. Isso informa se o destino deve ser 6.5.24 (SP24) ou 6.5 LTS.
- Validar o suporte à plataforma usando a Matriz oficial de plataformas compatíveis. Confirme se o sistema operacional (RHEL 8, RHEL 9 ou Windows Server 2022) e a versão JBoss aparecem na matriz para a versão de destino. Se sua plataforma não estiver listada, selecione uma versão de SO e JBoss explicitamente compatível antes da atualização.
- Para migrações de SO (RHEL 7 para RHEL 8 ou RHEL 8 para RHEL 9), confirme a viabilidade. O RHEL 8 requer SP11 ou posterior, e o RHEL 9 é compatível com SP23 e SP24. Faça a correspondência do sistema operacional de destino com as versões compatíveis na matriz. Se sua versão não for compatível com o sistema operacional de destino, planeje uma migração fora do local usando um novo servidor.
- Baixe o instalador e o service pack completos corretos da Distribuição de software da Adobe, incluindo o instalador completo do SP23, o patch do SP24 e os complementos do Forms. Os nomes de arquivo correspondem a padrões como
aemforms_server_6_5_0_jboss_all_unix.tar.gzouadobe-aem-forms-jee-servicepack-6.5.24.0-win-jboss.zip. Se os arquivos não forem exibidos na Distribuição de software, confirme se a Adobe ID tem os direitos corretos na Admin Console. - Prepare-se para a atualização. Faça backup dos diretórios do CRX, GDS, TEMP e do banco de dados e confirme se os backups existem com carimbos de data e hora antes de continuar.
- Instale o novo instalador completo do AEM Forms JEE. Inicie o JBoss e confirme se o
/lcestá carregado. Se a implantação falhar, verifique os logs JBoss em busca de erros de implantação e valide as bibliotecas do sistema operacional. - Aplique o service pack (SP24) e os complementos Forms mais recentes. Instale o patch do SP24 para JBoss no Linux ou Windows e, em seguida, instale os componentes OSGi do SP24 (fragmento de servlet, service pack e complemento Forms). Verifique
/lc/system/console/bundlespara confirmar se os pacotes param de produzir erros contínuos. Caso contrário, reinstale o fragmento do servlet ou verifique seerror.logtem dependências ausentes. - Para atualizações do JBoss, verifique as variáveis de ambiente necessárias. Defina
DISABLE_JDK_SERIAL_FILTER= true ao atualizar o JBoss EAP 7.4.x e confirme se o JBoss é iniciado sem erros de serialização. Se os erros de serialização persistirem, confirme se a variável foi exportada corretamente no script de inicialização JBoss. - Valide o ambiente atualizado. Inicie o JBoss, acesse o
/adminuie teste os módulos principais, como o PDF Generator, a conectividade do Workbench e as extensões do Reader. Verifique se há novos rastreamentos de pilha ou mensagens em andamento emerror.log.