Esecuzione di un aggiornamento sul posto performing-an-in-place-upgrade

NOTE
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 del server applicazioni.

Passaggi di pre-aggiornamento pre-upgrade-steps

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.

Prerequisiti per la migrazione migration-prerequisites

  • Versione Java minima richiesta: Lo strumento di migrazione funziona solo con le versioni Java 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 stai eseguendo l'aggiornamento da una versione precedente alla 5.6, assicurati di aver eseguito un aggiornamento sul posto a AEM 6.0 seguendo la procedura descritta nella versione 6.0 della documentazione per l'aggiornamento.

Preparazione del file JAR Quickstart per l’AEM prep-quickstart-file

  1. Arresta l'istanza se è in esecuzione.

  2. Scaricare il nuovo file JAR dell'AEM e utilizzarlo per sostituire il vecchio file all'esterno della cartella crx-quickstart.

  3. Decomprimi il nuovo file jar quickstart eseguendo:

    code language-shell
    java -Xmx4096m -jar aem-quickstart.jar -unpack
    

Migrazione archivio contenuti content-repository-migration

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 di Oak presente in 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 le Domande frequenti sulla migrazione ad Oak Segment Tar.

La migrazione effettiva viene eseguita utilizzando il file jar quickstart AEM standard, eseguito con una nuova opzione -x crx2oak che esegue lo strumento crx2oak per semplificare l'aggiornamento e renderlo più robusto.

NOTE
Se esegui la migrazione del contenuto dell'archivio TarMK utilizzando l'estensione Quickstart di CRX2Oak, puoi rimuovere la modalità di esecuzione samplecontent 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 Source
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)

Potrebbero essere necessari ulteriori switch per i seguenti scenari:

  • Se l'aggiornamento viene eseguito su un sistema Windows in cui il mapping della memoria Java non viene gestito correttamente, aggiungere il parametro --disable-mmap al comando.

Per ulteriori istruzioni sull'utilizzo dello strumento crx2oak, vedere Utilizzo dello 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 posizione nella cartella di installazione AEM è: <aem-install>/crx-quickstart/opt/extensions/crx2oak.jar. La versione più recente dello strumento di migrazione di CRX2Oak è disponibile per il download dall'archivio 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. Verificare inoltre la presenza di messaggi WARN ed ERROR nel file upgrade.log, che si trova in crx-quickstart/logs nella directory di installazione dell'AEM, poiché potrebbero indicare errori non irreversibili che si sono verificati durante la migrazione.

Controllare i file di configurazione nella cartella crx-quickstart/install. Se era necessaria una migrazione, questa verrà aggiornata per riflettere l’archivio di destinazione.

Nota sugli archivi dati:

Sebbene FileDataStore sia il nuovo valore predefinito per le installazioni di AEM 6.3, l'utilizzo di un datastore esterno non è richiesto. 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.

Risoluzione dei problemi di migrazione troubleshooting-migration-issues

Ignora questa sezione se stai eseguendo l'aggiornamento da 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 vengono copiati perché non è stato specificato alcun archivio dati esterno. Questo comporterà la reindicizzazione completa dell’archivio al primo avvio. Utilizzare —skip-checkpoint per forzare la migrazione o visitare il sito 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, includere i seguenti flag nella sezione <<ADDITIONAL_FLAGS>> del comando di migrazione:

Per 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 archivi dati file:

--src-datastore=/path/to/datastore

Dove /path/to/datastore rappresenta il percorso del file datastore.

Esecuzione Dell'Aggiornamento performing-the-upgrade

Se si utilizza S3:

  1. Rimuovi eventuali file jar al di sotto di crx-quickstart/install associati a una versione precedente del connettore S3.

  2. 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/

  3. Estrarre il pacchetto in una cartella temporanea e copiare il contenuto di jcr_root/libs/system/install nella cartella crx-quickstart/install.

Determinazione del comando di avvio dell'aggiornamento corretto determining-the-correct-upgrade-start-command

Per eseguire l’aggiornamento, è importante avviare AEM utilizzando il file jar per visualizzare l’istanza. Per l'aggiornamento alla versione 6.5, vedere altre opzioni di ristrutturazione e migrazione dei contenuti in Lazy Content Migration che è possibile scegliere con il comando di aggiornamento.

IMPORTANT
Se si esegue Oracle Java 11 (o generalmente versioni di Java più recenti di 8), è necessario aggiungere opzioni aggiuntive alla riga di comando all'avvio dell'AEM. Per ulteriori informazioni, vedere Java 11 Considerazioni.

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 gli switch per le configurazioni dell’ambiente, ad esempio le impostazioni di memoria, i certificati di sicurezza e così via. Per questo motivo, l’Adobe consiglia di seguire questa procedura per determinare il comando di aggiornamento corretto:

  1. In un’istanza AEM in esecuzione, esegui quanto segue dalla riga di comando:

    code language-shell
    ps -ef | grep java
    
  2. Cercare il processo AEM. Avrà un aspetto simile a:

    code language-shell
    /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
    
  3. Modificare il comando sostituendo il percorso del file jar esistente ( crx-quickstart/app/aem-quickstart*.jar in questo caso) con il nuovo file jar di pari livello della cartella crx-quickstart. Utilizzando il comando precedente come esempio, il comando sarà:

    code language-shell
    /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.

Distribuisci codebase aggiornata deploy-upgraded-codebase

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 sono disponibili nella pagina Aggiorna codice e personalizzazioni.

Esecuzione di controlli e risoluzione dei problemi relativi all'aggiornamento di Post perform-post-upgrade-check-troubleshooting

Consulta Verifica e risoluzione dei problemi relativi all'aggiornamento di Post.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2