DocumentazioneAEM 6.4Guida alla distribuzione

Passaggi di aggiornamento per le installazioni di Application Server upgrade-steps-for-application-server-installations

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

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:

    code language-shell 
    jboss-install-folder/bin/standalone.sh

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

    code language-shell 
    wget https://<serveraddress:port>/cq/system/console/bundles

  3. Quindi, annulla la distribuzione di AEM 5.6:

    code language-shell 
    rm jboss-install-folder/standalone/deployments/cq.war

  4. Ferma JBoss.

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

    code language-shell 
    java -jar crx2oak.jar crx-quickstart/repository/ crx-quickstart/oak-repository
    note note
    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:

    code language-shell 
    mv crx-quickstart/oak-repository/segmentstore crx-quickstart/repository/segmentstore

  9. Copia anche il datastore:

    code language-shell 
    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:

      code language-none 
      path=./crx-quickstart/repository/datastore
 minRecordLength=4096

  13. Rimuovi la modalità runmode crx2 eseguendo:

    code language-shell 
    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:

    code language-shell 
    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:

    code language-shell 
    <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ì:

    code language-none 
    <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:

    code language-shell 
    jar cvf aem62.war

  18. Infine, distribuire il nuovo file war:

    code language-shell 
    cp temp/aem62.war jboss-install-folder/standalone/deployments/aem61.war
recommendation-more-help
6a71a83d-c2e0-4ce7-a6aa-899aa3885b56