DocumentaçãoKCS da Experience Cloud

Atualização do AEM Forms 6.5 entre service packs no JEE e OSGi

Última atualização: 23 de junho de 2026

Os clientes da AEM Forms enfrentam incerteza sobre o caminho de atualização correto ao alternar entre os service packs do AEM 6.5, pois os componentes do Forms são enviados separadamente das principais implantações do AEM Service Pack e do JEE e OSGi e usam fluxos de instalação diferentes. A Adobe distribui vários pacotes por service pack — o instalador cumulativo JEE, o complemento OSGi, hotfixes e pacotes de compatibilidade — para que seja fácil identificar incorretamente quais se aplicam a um determinado ambiente. Essa é uma questão de configuração, não um defeito de software. Identificar o tipo de tempo de execução, confirmar a versão atual e instalar os pacotes certos na ordem correta produz uma atualização limpa.

Descrição description

Problema: Seleção do caminho de atualização correto do pacote de serviços do AEM Forms 6.5 para JEE e OSGi

Descrição

A mudança de um service pack do AEM 6.5 para outro — por exemplo, SP18 para SP24, SP20 para SP23 ou SP23 com um hotfix para SP24 — levanta questões sobre quais pacotes se aplicam e em que ordem instalá-los. Perguntas comuns abordam se atualizações diretas são compatíveis, se os hotfixes existentes devem ser removidos primeiro, qual complemento do Forms deve ser instalado, qual instalador de patch JEE é necessário e como lidar com requisitos de plataforma, como WebSphere, JBoss, Windows ou Linux.

Ambiente:

  • AEM Forms 6.5 (no local)
  • Tempo de execução do OSGi
  • Tempo de execução do JEE (WebSphere, WebLogic, JBoss)
  • Plataformas Windows e Linux

Problema/sintomas:

  • Incerteza sobre qual service pack ou complemento do AEM Forms instalar, incluindo várias builds complementares para o mesmo service pack
  • Confusão sobre se um caminho de upgrade direto é suportado (por exemplo, SP18 → SP24 ou SP20 → SP23)
  • Perguntas sobre a necessidade de remover hotfixes existentes antes de aplicar um service pack mais recente
  • Orientações pouco claras sobre quando são necessários patches do JEE em relação a pacotes complementares do OSGi

Causa raiz:

As atualizações do AEM Forms exigem etapas dependentes da plataforma, pois os componentes do Forms são entregues separadamente do AEM Service Pack principal, e as implantações JEE e OSGi usam fluxos de patch e instalação diferentes. Como a Adobe distribui vários pacotes por service pack — um instalador cumulativo JEE, um complemento OSGi, hotfixes e pacotes de compatibilidade — é fácil interpretar incorretamente quais pacotes se aplicam a um determinado ambiente. O problema é a incerteza de configuração, não um defeito de software.

Como confirmar

  1. Identifique o tipo de tempo de execução. Faça logon no AEM e verifique se /lc está presente. Se /lc/login for carregado, será JEE; se apenas /aem/start.html for carregado, será OSGi. Os ambientes JEE usam arquivos EAR/WAR e o Gerenciador de configurações.
  2. Confirme sua versão atual do service pack. Navegue até /system/console/productinfo e verifique a seção Produtos Instalados (Por exemplo: Adobe Experience Manager (6.5.23.0)).
  3. Verifique a compatibilidade da plataforma. Compare suas versões de SO, Java, servidor de aplicativos e banco de dados com a matriz de plataformas compatíveis antes da atualização.

Resolução resolution

  1. Selecione o caminho de atualização correto com base no seu service pack inicial:

    • A partir do SP18 ou SP20, há suporte para upgrade direto para o SP24 ou SP23.
    • A partir do SP11, atualize primeiro os componentes da plataforma subjacente e, em seguida, mude para o SP24.
    • Se você estiver usando o SP23 com uma correção, prossiga normalmente e não remova a correção: os service packs são cumulativos.

  2. OSGi — instale o AEM 6.5 Service Pack principal: Carregue aem-service-pkg-6.5.xx.x.zip no Gerenciador de Pacotes do CRX e clique em Instalar. Visite /system/console/productinfo para confirmar as atualizações de versão do SP e verificar se todos os pacotes são ACTIVE ou FRAGMENT. Se a instalação falhar, verifique se há erros de dependência em error.log.

  3. OSGi — instale o pacote complementar correto do Forms: Identifique e instale a compilação complementar que corresponde ao seu service pack e plataforma. Verifique /system/console/bundles para confirmar se os pacotes AEM Forms estão no estado ACTIVE. Se a instalação falhar, reinicie o AEM e tente novamente.

  4. OSGi — instale hotfixes adicionais apenas se relevante: Aplique correções necessárias, como hotfixes de segurança do Granite. Confirme os componentes atualizados em /system/console/productinfo e verifique os pré-requisitos de hotfix na página de detalhes da Distribuição de Software.

  5. JEE — instale o instalador de patch associado do JEE: Execute o instalador de patch do JEE para o service pack de destino. Confirme se o Configuration Manager reconhece a versão atualizada. Se falhar, colete os logs do Configuration Manager.

  6. JEE — reinicie o servidor de aplicativos: Execute uma reinicialização limpa do WebSphere, WebLogic ou JBoss usando os scripts nativos do servidor de aplicativos. Confirme se os logs do servidor de aplicativos não mostram falhas de implantação. Se os EARs não forem implantados, verifique se há entradas JNDI, fontes de dados ou caminhos de repositório ausentes.

  7. Valide a atualização completa (JEE e OSGi): Faça logon no AEM e confirme se o Adaptive Forms, os fluxos de trabalho e outros recursos do Forms foram carregados. Revise os pacotes e as páginas de informações do produto e verifique error.log se há pacotes ausentes ou erros de dependência.

Validação

  1. Navegue até /system/console/productinfo e confirme se a versão do SP é exibida corretamente (Por exemplo: Adobe Experience Manager (6.5.24.0)).
  2. Verifique se todos os pacotes OSGi são ACTIVE ou FRAGMENT via /system/console/bundles.
  3. Para o JEE, confirme todos os EARs implantados sem erros revisando os logs do servidor de aplicações após a reinicialização.
  4. Execute um fluxo de trabalho básico do Forms ou renderize um Formulário adaptável para confirmar a estabilidade do tempo de execução.

Leitura relacionada

recommendation-more-help
experience-cloud-kcs-help-kbarticles