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

Passaggi pre-aggiornamento pre-upgrade-steps

Prima di eseguire l’aggiornamento, è necessario completare diversi passaggi. Vedi Aggiornamento di codice e personalizzazioni e Attività di manutenzione pre-aggiornamento per ulteriori informazioni. Inoltre, assicurati che il sistema soddisfi i requisiti per la nuova versione di AEM. Scopri come il rilevatore pattern può aiutarti a stimare la complessità dell’aggiornamento e consulta anche la sezione Ambito di aggiornamento e requisiti di Pianificazione dell'aggiornamento per ulteriori informazioni.

Prerequisiti per la migrazione migration-prerequisites

Preparazione del file jar AEM Quickstart prep-quickstart-file

Migrazione dall’archivio dei contenuti content-repository-migration

Questa migrazione non è necessaria se esegui 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 Segment Tar Oak presente nella 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 Segment Tar, consulta la sezione Domande frequenti sulla migrazione a Oak Segment Tar.

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

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>> sono sostituiti dal profilo e dai flag elencati nella tabella seguente:

Dove:

È inoltre possibile richiedere opzioni aggiuntive per i seguenti scenari:

Per ulteriori istruzioni sull'uso dello strumento crx2oak, consulta Utilizzo del Strumento di migrazione CRX2Oak. L'helper crx2oak JAR può essere aggiornato manualmente, se necessario, sostituendolo manualmente con le versioni più recenti dopo aver decompresso l'avvio rapido. La posizione nella cartella di installazione AEM è: <aem-install>/crx-quickstart/opt/extensions/crx2oak.jar. L’ultima versione dello strumento di migrazione CRX2Oak è disponibile per il download dall’archivio Adobe all’indirizzo: https://repo.adobe.com/nexus/content/groups/public/com/adobe/granite/crx2oak/

Se la migrazione è stata completata con successo, lo strumento uscirà con un codice di uscita pari a zero. Inoltre, controlla la presenza di messaggi WARN ed ERROR nella upgrade.log file, situato in crx-quickstart/logs nella directory di installazione di AEM, in quanto potrebbero indicare errori non fatali che si sono verificati durante la migrazione.

Controlla i file di configurazione sotto crx-quickstart/install cartella. Se è stata necessaria una migrazione, queste verranno aggiornate per riflettere l’archivio di destinazione.

Risoluzione dei problemi di migrazione troubleshooting-migration-issues

Ignora questa sezione se stai effettuando 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 si verifica un errore durante la migrazione, è possibile che ci siano alcuni aspetti dell’ambiente che richiedono opzioni di configurazione aggiuntive da fornire. In tal caso, si verificherà probabilmente il seguente errore:

I checkpoint non verranno copiati perché non è stato specificato alcun datastore esterno. Questo si tradurrà nella reindicizzazione completa del repository al primo avvio. Utilizza —salta-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 richiede l’accesso ai binari nel datastore e non è in grado di trovarlo. Per specificare la configurazione del datastore, includi i seguenti flag nel <<ADDITIONAL_FLAGS>> parte del comando di migrazione:

Per i datastore S3:

--src-s3config=/path/to/SharedS3DataStore.config --src-s3datastore=/path/to/datastore

Dove /path/to/SharedS3DataStore.config rappresenta il percorso del file di configurazione del datastore S3 e /path/to/datastore rappresenta il percorso del datastore S3.

Per i datastore dei 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:

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

Per eseguire l'aggiornamento, è importante iniziare a AEM utilizzando il file jar per visualizzare l'istanza. Per l’aggiornamento alla versione 6.4, consulta anche altre opzioni di ristrutturazione e migrazione dei contenuti in Migrazione dei contenuti Lazy che è possibile scegliere con il comando di aggiornamento.

Tieni presente che l’avvio AEM dallo script iniziale non avvierà l’aggiornamento. La maggior parte dei clienti inizia a AEM utilizzando lo script di avvio e ha personalizzato questo script di avvio per includere switch per configurazioni di ambiente quali impostazioni di memoria, certificati di sicurezza, ecc. Per questo motivo, si consiglia di seguire questa procedura per determinare il comando di aggiornamento corretto:

Distribuire una base di codice aggiornata deploy-upgraded-codebase

Una volta completato il processo di aggiornamento sul posto, la base di codice aggiornata deve essere distribuita. I passaggi per aggiornare la base di codice in modo che funzioni nella versione di destinazione di AEM si trovano in Pagina Aggiorna codice e personalizzazioni.

Esegui verifiche e risoluzione dei problemi post-aggiornamento perform-post-upgrade-check-troubleshooting

Vedi Controlli e risoluzione dei problemi post-aggiornamento.