Passaggi di aggiornamento per le installazioni di Application Server

Ultimo aggiornamento: 4 maggio 2023

Creato per:

  • Developer
CAUTION
AEM 6.4 ha raggiunto la fine del supporto esteso e questa documentazione non viene più aggiornata. Per maggiori dettagli, consulta la nostra periodi di assistenza tecnica. Trova le versioni supportate qui.

Questa sezione descrive la procedura da seguire per aggiornare AEM per le installazioni di Application Server.

Tutti gli esempi in questa procedura utilizzano JBoss come Application Server e implicano che una versione funzionante di AEM è già distribuita. La procedura è destinata a documentare gli aggiornamenti eseguiti da AEM versione da 5.6 a 6.3.

  1. Innanzitutto, avvia JBoss. Nella maggior parte delle situazioni, puoi farlo eseguendo il comando standalone.sh script di avvio, eseguendo questo comando dal terminale:

    jboss-install-folder/bin/standalone.sh

  2. Se AEM 5.6 è già distribuito, controlla che i bundle funzionino correttamente eseguendo:

    wget https://<serveraddress:port>/cq/system/console/bundles

  3. Quindi, annulla la distribuzione di AEM 5.6:

    rm jboss-install-folder/standalone/deployments/cq.war

  4. Ferma JBoss.

  5. Ora, esegui la migrazione dell'archivio utilizzando lo strumento di migrazione crx2oak:

    java -jar crx2oak.jar crx-quickstart/repository/ crx-quickstart/oak-repository
    NOTE
    In questo esempio, oak-repository è la directory temporanea in cui risiederà il repository appena convertito. Prima di eseguire questo passaggio, assicurati di disporre dell’ultima versione di crx2oak.jar.

  6. Elimina le proprietà necessarie nel file sling.properties facendo quanto segue:

    1. Apri il file che si trova in crx-quickstart/launchpad/sling.properties

    2. Testo del passaggio Rimuovi le seguenti proprietà e salva il file:

      1. sling.installer.dir
      2. felix.cm.dir
      3. granite.product.version
      4. org.osgi.framework.system.packages
      5. osgi-core-packages
      6. osgi-compendium-services
      7. jre-*
      8. sling.run.mode.install.options

  7. Rimuovi i file e le cartelle non più necessari. Gli elementi da rimuovere sono:

    • La cartella launchpad/avvio. È possibile eliminarlo eseguendo il seguente comando nel terminale: rm -rf crx-quickstart/launchpad/startup
    • La file base.jar: find crx-quickstart/launchpad -type f -name "org.apache.sling.launchpad.base.jar*" -exec rm -f {} \
    • La FileFile_timestamp.txt di BootstrapCommand: rm -f crx-quickstart/launchpad/felix/bundle0/BootstrapCommandFile_timestamp.txt

  8. Copia l'archivio segmenti appena migrato nella posizione corretta:

    mv crx-quickstart/oak-repository/segmentstore crx-quickstart/repository/segmentstore

  9. Copia anche il datastore:

    mv crx-quickstart/repository/repository/datastore crx-quickstart/repository/datastore

  10. Successivamente, devi creare la cartella che conterrà le configurazioni OSGi che verranno utilizzate con la nuova istanza aggiornata. Più specificamente, una cartella denominata install deve essere creata in crx-quickstart.

  11. A questo punto, crea l'archivio nodi e l'archivio dati che verranno utilizzati con AEM 6.3. Puoi farlo creando due file con i seguenti nomi in crx-quickstart\install:

    • org.apache.jackrabbit.oak.segment.SegmentNodeStoreService.cfg

    • org.apache.jackrabbit.oak.plugins.blob.datastore.FileDataStore.cfg

    Questi due file configureranno AEM per utilizzare un archivio nodi TarMK e un archivio dati File.

  12. Modifica i file di configurazione per renderli pronti all’uso. Più precisamente:

    • Aggiungi la riga seguente a org.apache.jackrabbit.oak.segment.SegmentNodeStoreService.config:

      customBlobStore=true

    • Quindi aggiungi le seguenti righe a org.apache.jackrabbit.oak.plugins.blob.datastore.FileDataStore.config:

      path=./crx-quickstart/repository/datastore
 minRecordLength=4096

  13. Rimuovi la modalità runmode crx2 eseguendo:

    find crx-quickstart/launchpad -type f -name "sling.options.file" -exec rm -rf {} \

  14. È ora necessario modificare le modalità di esecuzione nel file di guerra AEM 6.3. Per farlo, crea innanzitutto una cartella temporanea che ospiterà la guerra AEM 6.3. Il nome della cartella in questo esempio sarà temp. Una volta copiato il file WAR, estrarne il contenuto eseguendo la cartella temporanea:

    jar xvf aem-quickstart-6.3.0.war

  15. Una volta estratto il contenuto, vai alla WEB-INF e modifica la web.xml per modificare le modalità di esecuzione. Per trovare la posizione in cui sono impostati nell'XML, cerca il sling.run.modes stringa. Una volta trovato, modifica le modalità di esecuzione nella riga di codice successiva, che per impostazione predefinita è impostata per l’authoring:

    <param-value >author</param-value>

  16. Modifica il valore dell'autore riportato sopra e imposta le modalità di esecuzione su: autore,crx3,crx3tar Il blocco di codice finale dovrebbe essere così:

    <init-param>
<param-name>sling.run.modes</param-name>
<param-value>author,crx3,crx3tar</param-value>
</init-param>
<load-on-startup>100</load-on-startup>
</servlet>

  17. Ricrea il jar con il contenuto modificato:

    jar cvf aem62.war

  18. Infine, distribuire il nuovo file war:

    cp temp/aem62.war jboss-install-folder/standalone/deployments/aem61.war

Experience Cloud