Questa pagina illustra la procedura di aggiornamento per AEM 6.5. Se si dispone di un'installazione distribuita in un server applicazioni, vedere Passaggi per l'aggiornamento delle installazioni di Application Server.
Prima di eseguire l’aggiornamento, è necessario completare diversi passaggi. Consulta Aggiornamento del codice e delle personalizzazioni e Attività di manutenzione pre-aggiornamento per ulteriori informazioni. Inoltre, assicurati che il sistema soddisfi i requisiti per la nuova versione dell’AEM. Scopri in che modo il rilevatore pattern può aiutarti a stimare la complessità dell’aggiornamento e consulta anche la sezione Ambito e requisiti dell’aggiornamento di Pianificazione dell'aggiornamento per ulteriori informazioni.
Versione Java minima richiesta: Lo strumento di migrazione funziona solo con Java versioni 7 e successive. Tieni presente che per AEM 6.3 e versioni successive, le uniche versioni supportate sono JRE 8 di Oracle e JRE 7 e 8 di IBM.
Istanza aggiornata: Se si esegue l'aggiornamento da una versione più vecchio di 5,6, accertarsi di aver eseguito un aggiornamento sul posto a AEM 6.0 seguendo la procedura descritta nella versione 6.0 della documentazione relativa all’aggiornamento.
Arresta l'istanza se è in esecuzione.
Scarica il nuovo file JAR dell’AEM e utilizzalo per sostituire il vecchio al di fuori del crx-quickstart
cartella.
Decomprimi il nuovo file jar quickstart eseguendo:
java -Xmx4096m -jar aem-quickstart.jar -unpack
Questa migrazione non è necessaria per l’aggiornamento da AEM 6.3. Per le versioni precedenti alla 6.3, Adobe fornisce uno strumento che può essere utilizzato per migrare l’archivio alla nuova versione del Tar del segmento Oak presente nell’AEM 6.3. Viene fornito come parte del pacchetto quickstart ed è obbligatorio per tutti gli aggiornamenti che utilizzeranno TarMK. Gli aggiornamenti per gli ambienti che utilizzano MongoMK non richiedono la migrazione dell’archivio. Per ulteriori informazioni sui vantaggi del nuovo formato Tar segmento, consulta la sezione Domande frequenti sulla migrazione a Oak Segment Tar.
La migrazione effettiva viene eseguita utilizzando il file JAR standard per l’avvio rapido dell’AEM, con un nuovo -x crx2oak
opzione che esegue lo strumento crx2oak per semplificare l’aggiornamento e renderlo più robusto.
Se esegui la migrazione del contenuto dell’archivio TarMK utilizzando l’estensione Quickstart di CRX2Oak, puoi rimuovere samplecontent runmode aggiungendo quanto segue alla riga di comando di migrazione:
--promote-runmode nosamplecontent
Per determinare il comando da eseguire, utilizzare il comando seguente:
java -Xmx4096m -jar aem-quickstart.jar -v -x crx2oak -xargs -- --load-profile <<YOUR_PROFILE>> <<ADDITIONAL_FLAGS>>
Dove <<YOUR_PROFILE>>
e <<ADDITIONAL_FLAGS>>
vengono sostituiti con il profilo e i flag elencati nella tabella seguente:
Archivio di origine | Archivio di destinazione | Profilo | Flag aggiuntivi |
crx2 o TarMK con FileDataStore |
TarMK | segment-fds | Consulta la sezione Risoluzione dei problemi di seguito |
crx2 | MongoMK | mongo-from-crx2 | -T mongo-uri=mongo://mongo-host:mongo-port -T mongo-db=mongo-database-name |
TarMK o crx2 con S3DataStore |
TarMK | segment-custom-ds | Consulta la sezione Risoluzione dei problemi di seguito |
TarMK senza datastore | TarMK | segment-no-ds | |
MongoMK | MongoMK | Non è necessaria alcuna migrazione |
Dove:
mongo-host
è l’IP del server MongoDB (ad esempio, 127.0.0.1)
mongo-port
è la porta del server MongoDB (ad esempio: 27017)
mongo-database-name
rappresenta il nome del database (ad esempio: aem-author)
È inoltre possibile che siano necessari switch aggiuntivi per i seguenti scenari:
--disable-mmap
al comando.Per ulteriori istruzioni sull'utilizzo dello strumento crx2oak, consultate Utilizzo di Strumento di migrazione CRX2Oak. Il JAR helper crx2oak può essere aggiornato manualmente, se necessario, sostituendolo manualmente con versioni più recenti dopo aver decompresso quickstart. La sua posizione nella cartella di installazione dell’AEM è: <aem-install>/crx-quickstart/opt/extensions/crx2oak.jar
. La versione più recente dello strumento di migrazione CRX2Oak è disponibile per il download dall’archivio di Adobe all’indirizzo: https://repo1.maven.org/maven2/com/adobe/granite/crx2oak/
Se la migrazione è stata completata correttamente, lo strumento verrà chiuso con un codice di uscita pari a zero. Inoltre, verifica la presenza di messaggi WARN ed ERROR nella upgrade.log
file, che si trova sotto crx-quickstart/logs
nella directory di installazione dell’AEM, in quanto potrebbero indicare errori non mortali che si sono verificati durante la migrazione.
Controlla i file di configurazione sotto crx-quickstart/install
cartella. Se era necessaria una migrazione, questa verrà aggiornata per riflettere l’archivio di destinazione.
Una nota sugli archivi dati:
Mentre FileDataStore
è la nuova impostazione predefinita per le installazioni AEM 6.3, non è necessario utilizzare un datastore esterno. L’utilizzo di un archivio dati esterno è consigliato come best practice per le distribuzioni di produzione, ma non è un prerequisito per l’aggiornamento. A causa della complessità già presente nell’aggiornamento dell’AEM, Adobe consiglia di eseguire l’aggiornamento senza eseguire una migrazione dell’archivio dati. Se lo desideri, puoi eseguire successivamente una migrazione dell’archivio dati come sforzo separato.
Ignorare questa sezione se si esegue l'aggiornamento dalla versione 6.3. Anche se i profili crx2oak forniti devono soddisfare le esigenze della maggior parte dei clienti, ci sono momenti in cui saranno necessari parametri aggiuntivi. Se riscontri un errore durante la migrazione, è possibile che alcuni aspetti dell’ambiente richiedano l’inserimento di opzioni di configurazione aggiuntive. In tal caso, è probabile che si verifichi il seguente errore:
I punti di controllo non verranno copiati perché non è stato specificato alcun archivio dati esterno. Questo comporterà la reindicizzazione completa dell’archivio al primo avvio. Utilizza —skip-checkpoint per forzare la migrazione oppure consulta https://jackrabbit.apache.org/oak/docs/migration.html#Checkpoints_migration per ulteriori informazioni.
Per qualche motivo, il processo di migrazione necessita dell’accesso ai dati binari nell’archivio dati e non è in grado di trovarli. Per specificare la configurazione dell’archivio dati, includi i seguenti flag nella <<ADDITIONAL_FLAGS>>
parte del comando di migrazione:
Per gli archivi dati S3:
--src-s3config=/path/to/SharedS3DataStore.config --src-s3datastore=/path/to/datastore
Dove /path/to/SharedS3DataStore.config
rappresenta il percorso del file di configurazione dell’archivio dati S3 e /path/to/datastore
rappresenta il percorso dell’archivio dati S3.
Per gli archivi dati dei file:
--src-datastore=/path/to/datastore
Dove /path/to/datastore
rappresenta il percorso del file datastore.
Se si utilizza S3:
Rimuovi eventuali file jar sotto crx-quickstart/install
associato a una versione precedente del connettore S3.
Scarica la versione più recente del connettore 1.10.x S3 da https://repo1.maven.org/maven2/com/adobe/granite/com.adobe.granite.oak.s3connector/
Estrarre il pacchetto in una cartella temporanea e copiare il contenuto di jcr_root/libs/system/install
al crx-quickstart/install
cartella.
Per eseguire l’aggiornamento, è importante avviare AEM utilizzando il file jar per visualizzare l’istanza. Per l’aggiornamento alla versione 6.5, consulta anche altre opzioni di ristrutturazione e migrazione dei contenuti in Migrazione dei contenuti differita che è possibile scegliere con il comando di aggiornamento.
Se esegui Oracle Java 11 (o in genere versioni di Java più recenti di 8), sarà necessario aggiungere opzioni aggiuntive alla riga di comando all’avvio dell’AEM. Per ulteriori informazioni, consulta Considerazioni su Java 11.
Tieni presente che l’avvio dell’AEM dallo script di avvio non avvierà l’aggiornamento. La maggior parte dei clienti inizia l’AEM utilizzando lo script di avvio e ha personalizzato questo script di avvio in modo da includere switch per configurazioni di ambiente come impostazioni di memoria, certificati di sicurezza, ecc. Per questo motivo, l’Adobe consiglia di seguire questa procedura per determinare il comando di aggiornamento corretto:
In un’istanza AEM in esecuzione, esegui quanto segue dalla riga di comando:
ps -ef | grep java
Cercare il processo AEM. Avrà un aspetto simile a:
/usr/bin/java -server -Xmx1024m -Djava.awt.headless=true -Dsling.run.modes=author,crx3,crx3tar -jar crx-quickstart/app/cq-quickstart-6.5.0-standalone-quickstart.jar start -c crx-quickstart -i launchpad -p 4502 -Dsling.properties=conf/sling.properties
Modifica il comando sostituendo il percorso del file jar esistente ( crx-quickstart/app/aem-quickstart*.jar
in questo caso) con il nuovo jar di pari livello del crx-quickstart
cartella. Utilizzando il comando precedente come esempio, il comando sarà:
/usr/bin/java -server -Xmx1024m -Djava.awt.headless=true -Dsling.run.modes=author,crx3,crx3tar -jar cq-quickstart-6.5.0.jar -c crx-quickstart -p 4502 -Dsling.properties=conf/sling.properties
In questo modo, per l’aggiornamento verranno applicate tutte le impostazioni di memoria appropriate, le modalità di esecuzione personalizzate e altri parametri ambientali. Al termine dell’aggiornamento, l’istanza può essere avviata dallo script di avvio alle avviazioni future.
Al termine del processo di aggiornamento sul posto, deve essere distribuita la base di codice aggiornata. I passaggi per aggiornare la base di codice in modo che funzioni nella versione di destinazione dell’AEM si trovano in Pagina Aggiorna codice e personalizzazioni.
Consulta Controlli post-aggiornamento e risoluzione dei problemi.