Show Menu
THEMEN×

Schritte zur Aktualisierung von Installationen auf Anwendungsservern

In diesem Abschnitt wird die Vorgehensweise zum Aktualisieren von AEM für Anwendungsserverinstallationen beschrieben.
In allen Beispielen in diesem Verfahren wird JBoss als Anwendungsserver verwendet. Zudem wird angenommen, dass Sie bereits eine funktionierende AEM-Version installiert haben. In dieser Anleitung wird die Aktualisierung von Version AEM 5.6 auf 6.3 beschrieben.
  1. Starten Sie zunächst JBoss. In den meisten Fällen können Sie hierzu das Startskript standalone.sh und den folgenden Befehl am Terminal ausführen.
    jboss-install-folder/bin/standalone.sh
    
    
  2. Wenn AEM 5.6 bereits installiert ist, müssen Sie sicherstellen, dass die Bundles ordnungsgemäß funktionieren, indem Sie Folgendes ausführen:
    wget https://<serveraddress:port>/cq/system/console/bundles
    
    
  3. Machen Sie als Nächstes die Bereitstellung von AEM 5.6 rückgängig:
    rm jboss-install-folder/standalone/deployments/cq.war
    
    
  4. Beenden Sie JBoss.
  5. Migrieren Sie das Repository nun mithilfe des CRX2OAK-Migrationstools.
    java -jar crx2oak.jar crx-quickstart/repository/ crx-quickstart/oak-repository
    
    
    In diesem Beispiel ist oak-repository das temporäre Verzeichnis, in dem sich das neu konvertierte Repository befindet. Vergewissern Sie sich vor diesem Schritt, dass Sie über die neueste crx2oak.jar-Version verfügen.
  6. Löschen Sie die erforderlichen Eigenschaften in der Datei sling.properties folgendermaßen:
    1. Open the file located at crx-quickstart/launchpad/sling.properties
    2. Entfernen Sie die folgenden Eigenschaften und speichern Sie die Datei:
      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. Entfernen Sie die nicht mehr benötigten Dateien und Ordner. Insbesondere müssen Sie diese Elemente entfernen:
    • Den Ordner launchpad/startup . Sie können ihn löschen, indem Sie am Terminal den folgenden Befehl ausführen: rm -rf crx-quickstart/launchpad/startup
    • Die Datei base.jar : find crx-quickstart/launchpad -type f -name "org.apache.sling.launchpad.base.jar*" -exec rm -f {} \
    • Die Datei BootstrapCommandFile_timestamp.txt : rm -f crx-quickstart/launchpad/felix/bundle0/BootstrapCommandFile_timestamp.txt
  8. Kopieren Sie den neu migrierten Segmentspeicher an den entsprechenden Speicherort:
    mv crx-quickstart/oak-repository/segmentstore crx-quickstart/repository/segmentstore
    
    
  9. Kopieren Sie auch den Datenspeicher:
    mv crx-quickstart/repository/repository/datastore crx-quickstart/repository/datastore
    
    
  10. Als Nächstes müssen Sie den Ordner für die OSGi-Konfigurationen erstellen, die für die neue aktualisierte Instanz verwendet werden. Genauer gesagt muss ein Ordner mit dem Namen install unter crx-quickstart erstellt werden.
  11. Erstellen Sie nun die Knotenspeicher und Datenspeicher, die mit AEM 6.3 verwendet werden. Sie können zu diesem Zweck zwei Dateien mit den folgenden Namen unter crx-quickstart\install erstellen:
    • org.apache.jackrabbit.oak.segment.SegmentNodeStoreService.cfg
    • org.apache.jackrabbit.oak.plugins.blob.datastore.FileDataStore.cfg
    Diese zwei Dateien legen fest, dass AEM einen „TarMK“-Knotenspeicher und einen „File“-Datenspeicher verwendet.
  12. Bearbeiten Sie die Konfigurationsdateien, damit sie einsatzbereit sind. Gehen Sie dazu folgendermaßen vor:
    • Add the following line to org.apache.jackrabbit.oak.segment.SegmentNodeStoreService.config :
      customBlobStore=true
    • Then add the following lines to org.apache.jackrabbit.oak.plugins.blob.datastore.FileDataStore.config :
      path=./crx-quickstart/repository/datastore
       minRecordLength=4096
      
      
  13. Entfernen Sie den CRX2-Ausführungsmodus, indem Sie Folgendes ausführen:
    find crx-quickstart/launchpad -type f -name "sling.options.file" -exec rm -rf {} \
    
    
  14. Sie müssen nun die Ausführungsmodi in der WAR-Datei für AEM 6.3 ändern. Erstellen Sie dafür zunächst einen temporären Ordner, in dem die WAR-Datei für AEM 6.3 gespeichert wird. Der Name des Ordners in diesem Beispiel lautet temp . Extrahieren Sie nach dem Kopieren der WAR-Datei deren Inhalte im Ordner temp:
    jar xvf aem-quickstart-6.3.0.war
    
    
  15. Wechseln Sie nach dem Extrahieren der Inhalte zum Ordner WEB-INF und bearbeiten Sie die Datei web.xml , um die Ausführungsmodi zu ändern. Suchen Sie nach der Zeichenfolge sling.run.modes , um ihre Position in der XML-Datei zu bestimmen. Wenn Sie sie gefunden haben, ändern Sie die Ausführungsmodi in der nächsten Codezeile, die standardmäßig auf author gesetzt ist:
    <param-value >author</param-value>
    
    
  16. Ändern Sie den oben genannten „author“-Wert und legen Sie die Ausführungsmodi folgendermaßen fest: author,crx3,crx3tar. Der endgültige Codeblock sollte wie folgt aussehen:
    <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. Erstellen Sie die JAR-Datei erneut mit den geänderten Inhalten:
    jar cvf aem62.war
    
    
  18. Stellen Sie die neue WAR-Datei abschließend neu bereit:
    cp temp/aem62.war jboss-install-folder/standalone/deployments/aem61.war