DocumentazioneAEM 6.5 LTSGuida utente

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

Last update: Wed May 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Si applica a:
  • Experience Manager 6.5 LTS
  • Argomenti:

Creato per:

  • Amministratore
NOTE
Questa pagina illustra la procedura di aggiornamento sul posto per AEM 6.5 LTS. 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 tuo sistema soddisfi i requisiti per AEM 6.5 LTS e consulta le considerazioni sulla pianificazione dell'aggiornamento e come Analyzer può aiutarti a stimare la complessità.

Prerequisiti per la migrazione migration-prerequisites

  • Versione Java minima richiesta: Verifica che nel sistema sia installato Oracle Java™ 17/21.

Preparazione del file jar Quickstart di AEM prep-quickstart-file

  1. Scarica il nuovo file jar AEM 6.5 LTS

  2. Determinare il comando di avvio dell'aggiornamento corretto

  3. Arresta l’istanza se è in esecuzione

  4. Utilizza il nuovo file jar AEM 6.5 LTS per sostituire il vecchio all'esterno della cartella crx-quickstart

  5. Esegui una copia di backup del file sling.properties (in genere presente in crx-quickstart/conf/), quindi eliminalo

  6. Decomprimi il nuovo file jar quickstart eseguendo:

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

  7. Se è necessario applicare il file sling.properties personalizzato, crea una nuova istanza AEM locale e recupera il file sling.properties dalla directory crx-quickstart/conf. Applica le modifiche personalizzate richieste a questo file, quindi copialo nella directory crx-quickstart/conf dell’istanza di AEM che viene aggiornata. Se non sono presenti proprietà personalizzate, questo passaggio può essere ignorato.

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 S3 1.60.2 da https://repo1.maven.org/maven2/com/adobe/granite/com.adobe.granite.oak.s3connector/

  3. Estrarre il connettore S3 (versione 1.60.2) e copiare il contenuto delle cartelle seguenti in crx-quickstart/install, come segue:

    1. Copia com.adobe.granite.oak.s3connector-1.60.2/jcr_root/libs/system/install/1 in crx-quickstart/install/1
    2. Copia com.adobe.granite.oak.s3connector-1.60.2/jcr_root/libs/system/install/15 in crx-quickstart/install/15

Ora, avvia l'istanza di AEM utilizzando il nuovo comando determinato utilizzando le informazioni nella sezione Determinazione del comando di avvio dell'aggiornamento corretto.

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

NOTE
Il supporto per alcuni degli argomenti Java 8/11 è stato rimosso in Java 17/21. Vedere documenti Oracle Java™ 17, documenti Oracle Java™ 21 e considerazioni sugli argomenti Java&trade per AEM 6.5 LTS.

Per eseguire l’aggiornamento, è importante avviare AEM utilizzando il file jar per visualizzare l’istanza.

L’avvio di AEM dallo script di avvio non avvierà l’aggiornamento. La maggior parte dei clienti avvia 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, Adobe consiglia di seguire questa procedura per determinare il comando di aggiornamento corretto:

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

    code language-shell 
    ps -ef | grep java

  2. Cerca 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 AEM 6.5 LTS di pari livello della cartella crx-quickstart. Utilizzando il comando precedente come esempio, il comando sarà:

    code language-shell 
    /usr/bin/java -server -Xmx4096m -Djava.awt.headless=true -Dsling.run.modes=author,crx3,crx3tar -jar <AEM-6.5-LTS.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 di AEM sono disponibili nella pagina Aggiorna codice e personalizzazioni.

Eseguire controlli post-aggiornamento e risoluzione dei problemi perform-post-upgrade-check-troubleshooting

Consulta Controlli post aggiornamento e risoluzione dei problemi.

recommendation-more-help
51c6a92d-a39d-46d7-8e3e-2db9a31c06a2