Passaggi per l'aggiornamento delle installazioni di Application Server (WLP) upgrade-steps-for-application-server-installations-wlp
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.
Controlla Pianificazione dell'aggiornamento e come AEM Analyzer può aiutarti a stimare la complessità dell'aggiornamento di AEM.
Prerequisiti per la migrazione migration-prerequisites
- Versione Java minima richiesta: assicurati di aver installato IBM® Sumeru JRE 17/21 sul tuo server WLP.
Esecuzione dell'aggiornamento performing-the-upgrade
-
Assicurati di aver completato i passaggi precedenti all'aggiornamento come il backup del server AEM 6.5 prima di eseguire qualsiasi attività di aggiornamento
-
A seconda delle esigenze, scegli uno dei seguenti percorsi di aggiornamento:
- Aggiornamento sul posto: se il server WLP corrente supporta il Servlet 6, è possibile eseguire un aggiornamento sul posto e continuare con il passaggio 3.
- Sidegrade: se preferisci una nuova configurazione o se il server WLP non supporta il Servlet 6, configura una nuova istanza WLP con AEM 6.5 LTS e migra il contenuto seguendo la guida AEM 6.5 in AEM 6.5 LTS Content Migration Using Oak-upgrade e passa alla sezione Deploy Upgraded Codebase
-
Arresta l’istanza di AEM. In genere può essere eseguita utilizzando questo comando:
code language-shell <path-to-wlp-directory>/bin/server stop server_name
-
Rimuovere i file e le cartelle non più necessari. Gli elementi da rimuovere in modo specifico sono:
-
La cartella cq-quickstart-65.war dalla cartella
dropins
e la cartellaexpanded
si trovano rispettivamente in<path-to-aem-server>/dropins/cq-quickstart-65.war
e<path-to-aem-server>/apps/expanded/cq-quickstart-65.war
-
La cartella
launchpad/startup
. È possibile eliminarlo eseguendo il comando seguente nel terminale, supponendo che ci si trovi nella cartella del server:code language-shell rm -rf crx-quickstart/launchpad/startup
-
Il file
base.jar
. Per eseguire questa operazione, eseguire i comandi seguenti:code language-shell find crx-quickstart/launchpad -type f -name "org.apache.sling.launchpad.base.jar*" -exec rm -f {} \;
-
Il file
BootstrapCommandFile_timestamp.txt
:code language-shell rm -f crx-quickstart/launchpad/felix/bundle0/BootstrapCommandFile_timestamp.txt
-
Rimuovere il file
sling.options
eseguendo:code language-shell find crx-quickstart/launchpad -type f -name "sling.options.file" -exec rm -rf {} \;
-
Rimuovi il file
sling.bootstrap.txt
:code language-shell rm -rf crx-quickstart/launchpad/sling_bootstrap.txt
-
-
Creare un backup del file
sling.properties
(in genere presente incrx-quickstart/conf/
) ed eliminarlo -
Cambia la versione del servlet in 6.0 nel file
server.xml
-
Installa Java 17/Java 21 e assicurati che sia installato correttamente eseguendo:
code language-shell java -version
-
Esamina i parametri di avvio per il server AEM e assicurati di aggiornarli in base alle tue esigenze. Per ulteriori informazioni, vedere Java 17/Java 21 Considerazioni.
-
Scarica il nuovo file .war 6.5 LTS e copialo nella cartella dei dropin che si trova in:
/<path-to-aem-server>/dropins/
-
Avvia istanza di AEM: in genere può essere eseguita utilizzando questo comando:
code language-shell <path-to-wlp-directory>/bin/server start server_name
-
Se sono presenti modifiche personalizzate in
sling.properties
, seguire le istruzioni seguenti:- Arrestare l'istanza di AEM eseguendo
<path-to-wlp-directory>/bin/server stop server_name
- Applica le
sling.properties
modifiche personalizzate al filesling.properties
appena generato (facendo riferimento al file di backup creato al passaggio 5) - Avvia l’istanza di AEM. In genere è possibile eseguirlo eseguendo:
<path-to-wlp-directory>/bin/server start server_name
- Arrestare l'istanza di AEM eseguendo
Distribuisci codebase aggiornata deploy-upgraded-codebase
Una volta completato il processo di aggiornamento, 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 sono disponibili nella pagina Aggiorna codice e personalizzazioni.
Eseguire Controlli E Risoluzione Dei Problemi Dopo L'Aggiornamento perform-post-upgrade-checks-and-troubleshooting
Consulta Controlli post aggiornamento e risoluzione dei problemi.