Aggiornamento ad AEM 6.5 Forms LTS su OSGi upgrade-to-aem-forms-osgi

Installa il pacchetto del componente aggiuntivo AEM Forms. I passaggi sono elencati di seguito:

1. Apri Software Distribution. Per accedere a Software Distribution è necessario disporre di un Adobe ID.

2. Seleziona Adobe Experience Manager disponibile nel menu intestazione.

3. Nella sezione Filtri:

   1. Selezionare Forms dall'elenco a discesa Soluzione.
   2. Seleziona la versione e digita per il pacchetto. Puoi anche utilizzare l'opzione Cerca download per filtrare i risultati.

4. Selezionare il nome del pacchetto applicabile al sistema operativo in uso, selezionare Accetta termini EULA e selezionare Scarica.

5. Apri Gestione pacchetti e fai clic su Carica pacchetto per caricare il pacchetto.

6. Selezionare il pacchetto e fare clic su Installa.

   Puoi scaricare il pacchetto anche utilizzando il collegamento diretto elencato nell'articolo Versioni di AEM Forms.

   Dopo l’installazione del pacchetto, viene richiesto di riavviare l’istanza di AEM. Non arrestare immediatamente il server. Prima di arrestare il server AEM Forms, attendere che i messaggi ServiceEvent REGISTERED e ServiceEvent UNREGISTERED non vengano più visualizzati nel file <crx-repository>/error.log e che il registro sia stabile. Inoltre, alcuni pacchetti possono rimanere nello stato di installazione. Puoi ignorare lo stato di questi pacchetti.

   Riavviare l'istanza di AEM con i seguenti parametri della riga di comando JVM aggiuntivi:
   --add-opens java.base/java.util=ALL-UNNAMED --add-exports=java.xml/com.sun.org.apache.xml.internal.serialize=ALL-UNNAMED

   Se il server viene avviato tramite uno script o un servizio, aggiornarlo di conseguenza in modo da includere quanto riportato sopra, in modo che siano effettivi anche dopo i riavvii successivi.

   note note
   NOTE
   Si consiglia di utilizzare il comando “Ctrl + C” per riavviare SDK. Il riavvio di AEM SDK utilizzando metodi alternativi, ad esempio l’arresto dei processi Java, può causare incoerenze nell’ambiente di sviluppo AEM.

Eseguire attività successive all'installazione.

• Esegui utilità di migrazione

  L’utility di migrazione rende compatibili con AEM 6.5 forms i moduli adattivi e le risorse di gestione della corrispondenza delle versioni precedenti. Puoi scaricare l’utility da AEM Software Distribution. Per informazioni dettagliate sulla configurazione e l'utilizzo dell'utilità di migrazione, vedere utilità di migrazione.

  Se si utilizza Esempio per l'integrazione del componente Bozze e invii con il database e l'aggiornamento da una versione precedente, eseguire le query SQL seguenti dopo l'aggiornamento:

  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 si esegue l'aggiornamento da AEM 6.2 Forms o solo dalle versioni precedenti) Riconfigura Adobe Sign

  Se nella versione precedente di AEM Forms hai configurato Adobe Sign, riconfigura Adobe Sign da AEM Cloud Services. Per ulteriori dettagli, consulta Integrare Adobe Sign con AEM Forms.

• Supporto per jQuery

  In AEM 6.5 Forms, la versione di jQuery è aggiornata alla 3.2.1 e la versione dell’interfaccia utente jQuery è aggiornata alla 1.12.1. AEM Form utilizza JQuery in modalità noConflict. Pertanto, se utilizzi un’altra versione di jQuery, non vengono visualizzati problemi durante l’esecuzione di un aggiornamento. Tuttavia, quando esegui l’aggiornamento a AEM 6.5 Forms:

  • Assicurati che gli eventuali componenti personalizzati siano compatibili con le versioni di jQuery supportate.
  • Rimuovi le API non supportate dai componenti personalizzati. Per l'elenco delle API rimosse, consulta la guida all'aggiornamento. Ad esempio, viene rimosso il supporto per le API load(), .unload() ed .error(). Utilizza il metodo .on() al posto delle API di cui sopra. Ad esempio, modificare $("img").load(fn) in $("img").on("load", fn).

• (Se si esegue l'aggiornamento da AEM 6.2 Forms o solo da versioni precedenti) Riconfigura analisi e report

  In AEM 6.4 Forms, la variabile di traffico per la sorgente e l’evento di successo per le impression non sono disponibili. Pertanto, quando esegui l’aggiornamento da AEM 6.2 Forms o versioni precedenti, AEM Forms smette di inviare dati al server Adobe Analytics e i rapporti di analisi per i moduli adattivi non sono disponibili. Inoltre, AEM 6.4 Forms introduce la variabile di traffico per la versione di analisi dei moduli e l’evento di successo per la quantità di tempo trascorso su un campo. Quindi, riconfigura le analisi e i rapporti per il tuo ambiente AEM Forms. Per i passaggi dettagliati, vedi Configurazione di analisi e rapporti.

Verificare che il server sia stato aggiornato correttamente, che anche tutti i dati siano stati migrati correttamente e che possa funzionare normalmente.

• Verifica lo stato dei bundle: Verifica che tutti i bundle siano in stato attivo.

• Verifica replica e replica inversa: Pubblicare, compilare e inviare alcuni moduli migrati. Verifica anche i dati inviati.

• Verificare l'accesso alle interfacce utente amministratore e sviluppatore: Accedere all'istanza di AEM da un account amministratore e verificare di disporre dell'accesso ai seguenti URL:

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

Accedi al portale per sviluppatori Red Hat:
https://developers.redhat.com/products/eap/download

Scarica la distribuzione ZIP JBoss EAP 8 per Windows.

Estrarre il file ZIP scaricato nella directory di installazione preferita.

Prendere nota del percorso di questa directory come <JBOSS_HOME> da utilizzare in questa guida.

Esempio:
C:\jboss-eap-8.0

Creare una directory di lavoro temporanea:

C:\aem\war-config

Copia il file cq-quickstart.war in questa directory.

Apri Prompt dei comandi e passa alla directory di lavoro:

cd C:\aem\war-config

Estrai il file WAR:

jar -xvf cq-quickstart.war

Viene creata una struttura di directory con WEB-INF e altri file dell'applicazione.

Passare alla directory WEB-INF all'interno del file WAR estratto:

cd WEB-INF

Creare un nuovo file denominato jboss-deployment-structure.xml.

Aggiungi il seguente contenuto 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>

Salva e chiudi il file.

Apri WEB-INF\web.xml in un editor di testo.

Individuare la sezione <servlet> contenente la configurazione della modalità di esecuzione:

<!-- 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>

Sostituire il tag di chiusura </servlet> e la riga precedente con:

<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>

Salva e chiudi web.xml.

Tornate alla directory di lavoro contenente il contenuto estratto:

cd C:\aem\war-config

Creare il nuovo file WAR:

jar -cvf cq-quickstart.war *

Copia cq-quickstart.war ricompilato nella directory delle distribuzioni JBoss:

<JBOSS_HOME>\standalone\deployments

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

Apri <JBOSS_HOME>\bin\standalone.conf.bat in un editor di testo.

Modificare o aggiungere la riga seguente per impostare la memoria heap:

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

Apri Prompt dei comandi come Amministratore.

Passa alla directory bin JBoss:

cd <JBOSS_HOME>\bin

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

Avvia il server JBoss:

standalone.bat -b 0.0.0.0 -bmanagement 0.0.0.0

Parametri:

• -b 0.0.0.0 - Associa il server a tutte le interfacce di rete
• -bmanagement 0.0.0.0 - Associa l'interfaccia di gestione a tutte le interfacce di rete