Show Menu
ARGOMENTI×

Esecuzione di un aggiornamento locale

Questa pagina illustra la procedura di aggiornamento per AEM 6.5. Se disponete di un'installazione distribuita su un server applicazione, consultate Procedura di aggiornamento per le installazioni di Application Server.

Passaggi pre-aggiornamento

Prima di eseguire l'aggiornamento, è necessario completare diversi passaggi. Per ulteriori informazioni, consulta Aggiornamento di codice e personalizzazioni e attività di manutenzione pre-aggiornamento. Inoltre, accertatevi che il sistema soddisfi i requisiti per la nuova versione di AEM. Scopri come il Rilevatore di pattern può aiutarti a stimare la complessità dell'aggiornamento e come consultare la sezione Ambito e requisiti dell'aggiornamento di Planning Your Upgrade per ulteriori informazioni.
Infine, è possibile ridurre notevolmente i tempi di inattività durante l'aggiornamento indicizzando il repository prima di eseguire l'aggiornamento. Per ulteriori informazioni, vedere Utilizzo della reindicizzazione offline per ridurre i tempi di inattività durante un aggiornamento

Prerequisiti per la migrazione

  • Versione Java minima richiesta: Lo strumento di migrazione funziona solo con Java versione 7 e versioni successive. Per AEM 6.3 e versioni successive, Oracle's JRE 8 e IBM JRE 7 & 8 sono le uniche versioni supportate.
  • Istanza aggiornata: Se state effettuando l'aggiornamento da una versione precedente alla 5.6 , accertatevi di aver eseguito un aggiornamento locale a AEM 6.0 seguendo la procedura descritta nella versione 6.0 della documentazione relativa all'aggiornamento.

Preparazione del file JAR AEM Quickstart

  1. Arrestate l'istanza se è in esecuzione.
  2. Scaricate il nuovo file AEM jar e utilizzatelo per sostituire il vecchio file esterno alla crx-quickstart cartella.
  3. Estrai il nuovo jar di avvio rapido eseguendo:
    java -Xmx4096m -jar aem-quickstart.jar -unpack
    
    

Migrazione all'archivio dei contenuti

Questa migrazione non è necessaria se effettui 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 della ar del segmento 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. For more information on what the benefits of the new Segment Tar format are, see the Migrating to Oak Segment Tar FAQ .
La migrazione effettiva viene eseguita utilizzando il file Jar AEM QuickStart standard, eseguito con una nuova -x crx2oak opzione che esegue lo strumento crx2oak per semplificare l'aggiornamento e renderlo più affidabile.
Se si esegue la migrazione del contenuto dell'archivio TarMK utilizzando l'estensione CRX2Oak Quickstart, è possibile rimuovere la modalità di esecuzione del contenuto di esempio 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>> sono sostituiti con il profilo e i contrassegni elencati nella seguente tabella:
Repository di origine Repository di Target 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 Nessuna migrazione necessaria
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)
Potete anche richiedere opzioni aggiuntive per i seguenti scenari:
  • Se si esegue l'aggiornamento in un sistema Windows in cui la mappatura della memoria Java non viene gestita correttamente, aggiungere il --disable-mmap parametro al comando.
  • Se utilizzate Java 7, aggiungete il -XX:MaxPermSize=2048m parametro subito dopo il -Xmx parametro.
Per ulteriori istruzioni sull'utilizzo dello strumento crx2oak, vedere Utilizzo dello strumento di migrazione CRX2Oak. Il supporto crx2oak JAR può essere aggiornato manualmente, se necessario, sostituendolo manualmente con le versioni più recenti dopo aver disimballato il QuickStart. Il percorso nella cartella di installazione AEM è: <aem-install>/crx-quickstart/opt/extensions/crx2oak.jar . La versione più recente dello strumento di migrazione CRX2Oak è disponibile per il download dall'archivio Adobi all'indirizzo: https://repo.adobe.com/nexus/content/groups/public/com/adobe/granite/crx2oak/
Se la migrazione è stata completata correttamente, lo strumento uscirà con un codice di uscita pari a zero. Inoltre, verificare la presenza di messaggi WARN e ERROR nel upgrade.log file, situato crx-quickstart/logs nella directory di installazione AEM, in quanto questi potrebbero indicare errori non irreversibili che si sono verificati durante la migrazione.
Controllate i file di configurazione al di sotto della crx-quickstart/install cartella. Se fosse necessaria una migrazione, queste verranno aggiornate per riflettere il repository di destinazione.
Una nota sulle attività di datastores:
Sebbene FileDataStore sia il nuovo valore predefinito per le installazioni AEM 6.3, non è necessario utilizzare un datastore esterno. Anche se l'utilizzo di un archivio dati esterno è consigliato come procedura ottimale per le distribuzioni di produzione, non è un prerequisito per l'aggiornamento. A causa della complessità già presente nel AEM di aggiornamento, si consiglia di eseguire l'aggiornamento senza eseguire una migrazione degli archivi di dati. Se necessario, una migrazione degli archivi di dati può essere eseguita successivamente come sforzo separato.

Risoluzione dei problemi di migrazione

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 volte in cui saranno necessari parametri aggiuntivi. Se si verifica un errore durante la migrazione, è possibile che alcuni aspetti dell'ambiente richiedano ulteriori opzioni di configurazione. In tal caso, si verificherà probabilmente il seguente errore:
I punti di controllo non verranno copiati perché non è stato specificato alcun archivio dati esterno. Questo si tradurrà nella reindicizzazione completa del repository al primo avvio. Utilizzate —skip-checkpoint per forzare la migrazione o consultate https://jackrabbit.apache.org/oak/docs/migration.html#Checkpoints_migration per ulteriori informazioni.
Per qualche motivo, il processo di migrazione ha bisogno dell'accesso ai file binari nel datastore e non è in grado di trovarlo. Per specificare la configurazione del datastore, includi i seguenti flag nella <<ADDITIONAL_FLAGS>> parte del comando di migrazione:
Per i datastores 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 file di archivio dati:
--src-datastore=/path/to/datastore

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

Esecuzione Dell'Aggiornamento

Se si utilizza S3:
  1. Rimuovere eventuali barattoli sotto crx-quickstart/install associati a una versione precedente del connettore S3.
  2. Estraete il pacchetto in una cartella temporanea e copiate il contenuto di tale pacchetto jcr_root/libs/system/install nella crx-quickstart/install cartella.

Determinazione del comando di avvio dell'aggiornamento corretto

Per eseguire l'aggiornamento, è importante iniziare a AEM utilizzando il file jar per visualizzare l'istanza. Per l'aggiornamento alla versione 6.5, potete vedere anche altre opzioni di ristrutturazione e migrazione dei contenuti in Migrazione dei contenuti Lazy che potete scegliere con il comando di aggiornamento.
L'avvio AEM dallo script iniziale non avvia l'aggiornamento. La maggior parte dei clienti inizia AEM utilizzare lo script iniziale e ha personalizzato questo script iniziale per includere opzioni per le configurazioni di ambiente quali le impostazioni di memoria, i certificati di protezione, ecc. Per questo motivo, si consiglia di seguire questa procedura per determinare il comando di aggiornamento corretto:
  1. In un'istanza AEM in esecuzione, eseguire quanto segue dalla riga di comando:
    ps -ef | grep java
    
    
  2. Cercare il processo AEM. Sarà simile a:
    /usr/bin/java -server -Xmx1024m -XX:MaxPermSize=256M -Djava.awt.headless=true -Dsling.run.modes=author,crx3,crx3tar -jar crx-quickstart/app/cq-quickstart-6.2.0-standalone-quickstart.jar start -c crx-quickstart -i launchpad -p 4502 -Dsling.properties=conf/sling.properties
    
    
  3. Modificate il comando sostituendo il percorso della cartella esistente ( crx-quickstart/app/aem-quickstart*.jar in questo caso) con la nuova vasca di pari livello della crx-quickstart cartella. Utilizzando il nostro precedente comando come esempio, il nostro comando sarebbe:
    /usr/bin/java -server -Xmx1024m -XX:MaxPermSize=256M -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 tutte le impostazioni di memoria corrette, le modalità di esecuzione personalizzate e altri parametri ambientali verranno applicati per l'aggiornamento. Al termine dell'aggiornamento, l'istanza potrebbe essere avviata a partire dallo script iniziale per le prossime startup.

Distribuisci Codebase Aggiornata

Una volta completato il processo di aggiornamento locale, è necessario distribuire la base di codice aggiornata. I passaggi per aggiornare la base di codice in modo che funzioni nella versione di destinazione di AEM si trovano nella pagina Aggiornamento di codice e personalizzazioni Aggiorna codice e personalizzazioni.

Esegui verifiche e risoluzione dei problemi post-aggiornamento