Atualização para o AEM 6.5 Forms LTS no OSGi upgrade-to-aem-forms-osgi

Instale o pacote complementar do AEM Forms. As etapas estão listadas abaixo:

1. Abra a Distribuição de softwares. Você precisa de uma Adobe ID para fazer logon na Distribuição de softwares.

2. Selecione Adobe Experience Manager, disponível no menu de cabeçalho.

3. Na seção Filtros:

   1. Selecione Forms na lista suspensa Solução.
   2. Selecione a versão e o tipo do pacote. Você também pode usar a opção Downloads de Pesquisa para filtrar os resultados.

4. Selecione o nome do pacote aplicável ao seu sistema operacional, selecione Aceitar termos do EULA e selecione Baixar.

5. Abra o Gerenciador de Pacotes e clique em Carregar Pacote para carregar o pacote.

6. Selecione o pacote e clique em Instalar.

   Você também pode baixar o pacote usando o link direto listado no artigo versões do AEM Forms.

   Depois que o pacote for instalado, você será solicitado a reiniciar a instância do AEM. Não interromper imediatamente o servidor. Antes de interromper o servidor do AEM Forms, aguarde até que as mensagens ServiceEvent REGISTERED e ServiceEvent UNREGISTERED parem de aparecer no arquivo <crx-repository>/error.log e o log fique estável. Observe também que alguns pacotes podem permanecer no estado instalado. Você pode ignorar com segurança o estado desses pacotes.

   Reinicie a instância do AEM com os seguintes parâmetros de linha de comando JVM adicionais:
   --add-opens java.base/java.util=ALL-UNNAMED --add-exports=java.xml/com.sun.org.apache.xml.internal.serialize=ALL-UNNAMED

   Se o servidor for iniciado por meio de um script ou serviço, atualize-o de acordo para incluir os itens acima, de modo que eles também sejam efetivos após as reinicializações subsequentes.

   note note
   NOTE
   É recomendável usar o comando 'Ctrl + C' para reiniciar o SDK. Reiniciar o AEM SDK usando métodos alternativos, por exemplo, parar processos Java, pode levar a inconsistências no ambiente de desenvolvimento do AEM.

Executar atividades de pós-instalação.

• Executar Utilitário de Migração

  O utilitário de migração torna os formulários adaptáveis e os ativos de gerenciamento de correspondência das versões anteriores compatíveis com os formulários do AEM 6.5. Você pode baixar o utilitário da Distribuição de software da AEM. Para obter informações detalhadas sobre como configurar e usar o utilitário de migração, consulte utilitário de migração.

  Se você estiver usando a Amostra para integrar o componente de rascunhos e envios ao banco de dados e atualizar de uma versão anterior, execute as seguintes consultas SQL após executar a atualização:

  code language-sql
  UPDATE metadata m, additionalmetadatatable am SET m.dataType = am.value WHERE m.id = am.id AND am.key = 'dataType'

  code language-sql
  DELETE from additionalmetadatatable WHERE `key` = 'dataType'

• (Se estiver atualizando a partir do AEM 6.2 Forms ou apenas de versões anteriores) Reconfigure o Adobe Sign

  Se você tiver o Adobe Sign configurado na versão anterior do AEM Forms, reconfigure-o a partir dos serviços em nuvem da AEM. Para obter mais detalhes, consulte Integrar o Adobe Sign com o AEM Forms.

• Suporte para jQuery

  No AEM 6.5 Forms, a versão do jQuery foi atualizada para 3.2.1 e a versão da interface do usuário do jQuery foi atualizada para 1.12.1. O AEM Form usa JQuery no modo noConflict. Portanto, se você estiver usando qualquer outra versão do jQuery, nenhum problema será exibido ao executar um upgrade. No entanto, ao atualizar para o AEM 6.5 Forms:

  • Certifique-se de que os componentes personalizados, se houver, sejam compatíveis com as versões do jQuery compatíveis.
  • Remova APIs não compatíveis dos componentes personalizados. Consulte o guia de atualização para obter a lista de APIs removidas. Por exemplo, o suporte para as APIs load(), .unload() e .error() é removido. Use o método .on() no lugar das APIs mencionadas anteriormente. Por exemplo, altere $("img").load(fn) para $("img").on("load", fn).

• (Se estiver atualizando a partir do AEM 6.2 Forms ou somente versões anteriores) Reconfigure a análise e os relatórios

  No AEM 6.4 Forms, a variável de tráfego para origem e o evento bem-sucedido para impressão não estão disponíveis. Assim, ao atualizar do AEM 6.2 Forms ou de versões anteriores, o AEM Forms para de enviar dados para o servidor do Adobe Analytics e os relatórios do Analytics para formulários adaptáveis não estão disponíveis. Além disso, o AEM 6.4 Forms introduz a variável de tráfego para a versão da análise de formulário e o evento bem-sucedido para o tempo gasto em um campo. Portanto, reconfigure as análises e os relatórios para o ambiente do AEM Forms. Para obter etapas detalhadas, consulte Configuração de análises e relatórios.

Verifique se o servidor foi atualizado com êxito, se todos os dados também foram migrados com êxito e se ele pode funcionar normalmente.

• Verifique o status dos pacotes: Verifique se todos os pacotes estão no estado ativo.

• Verifique a replicação e a replicação inversa: Publique, preencha e envie alguns formulários migrados. Verifique também os dados enviados.

• Verifique o acesso às interfaces de usuário do administrador e do desenvolvedor: Faça logon na instância do AEM a partir de uma conta de administrador e verifique se você tem acesso às seguintes URLs:

  • https://'[server]:[port]'/crx/packmgr
  • https://'[server]:[port]'/crx/de
  • https://'[server]:[port]'/aem/forms.html/content/dam/formsanddocuments

Navegue até o portal Desenvolvedor Red Hat:
https://developers.redhat.com/products/eap/download

Baixe a distribuição ZIP JBoss EAP 8 para Windows.

Extraia o arquivo ZIP baixado para o diretório de instalação de sua preferência.

Anote este caminho de diretório como <JBOSS_HOME> para uso neste guia.

Exemplo:
C:\jboss-eap-8.0

Crie um diretório de trabalho temporário:

C:\aem\war-config

Copie cq-quickstart.war para este diretório.

Abra o Prompt de Comando e navegue até o seu diretório de trabalho:

cd C:\aem\war-config

Extraia o arquivo WAR:

jar -xvf cq-quickstart.war

Isso cria uma estrutura de diretório com WEB-INF e outros arquivos de aplicativo.

Navegue até o diretório WEB-INF dentro do WAR extraído:

cd WEB-INF

Crie um novo arquivo chamado jboss-deployment-structure.xml.

Adicione o seguinte conteúdo XML:

<?xml version="1.0" encoding="UTF-8"?>
<jboss-deployment-structure xmlns="urn:jboss:deployment-structure:1.2">
    <deployment>
        <dependencies>
            <module name="jdk.unsupported" />
        </dependencies>
    </deployment>
</jboss-deployment-structure>

Salvar e fechar o arquivo.

Abra WEB-INF\web.xml em um editor de texto.

Localize a seção <servlet> que contém a configuração do modo de execução:

<!-- Set the runmode per default to author -->
<init-param>
    <param-name>sling.run.modes</param-name>
    <param-value>author</param-value>
</init-param>
<load-on-startup>100</load-on-startup>
</servlet>

Substituir a marca de fechamento </servlet> e a linha anterior por:

<init-param>
    <param-name>sling.run.modes</param-name>
    <param-value>author</param-value>
</init-param>
<multipart-config>
    <max-file-size>1048576000</max-file-size>
    <max-request-size>1048576000</max-request-size>
    <file-size-threshold>0</file-size-threshold>
</multipart-config>
<load-on-startup>100</load-on-startup>
</servlet>

Salvar e fechar web.xml.

Volte para o diretório de trabalho que contém o conteúdo extraído:

cd C:\aem\war-config

Crie o novo arquivo WAR:

jar -cvf cq-quickstart.war *

Copie o cq-quickstart.war reempacotado para o diretório de implantações do JBoss:

<JBOSS_HOME>\standalone\deployments

Exemplo:
C:\jboss-eap-8.0\standalone\deployments

Abra <JBOSS_HOME>\bin\standalone.conf.bat em um editor de texto.

Modifique ou adicione a seguinte linha para definir a memória heap:

set "JAVA_OPTS=-Xms4096m -Xmx4096m -XX:MaxMetaspaceSize=512m"

Abra o Prompt de Comando como Administrador.

Navegue até o diretório bin JBoss:

cd <JBOSS_HOME>\bin

Exemplo:
cmd cd C:\jboss-eap-8.0\bin

Inicie o servidor JBoss:

standalone.bat -b 0.0.0.0 -bmanagement 0.0.0.0

Parâmetros:

• -b 0.0.0.0 — Associa o servidor a todas as interfaces de rede
• -bmanagement 0.0.0.0 — Associa a interface de gerenciamento a todas as interfaces de rede