Upgrade auf AEM 6.5 Forms LTS unter OSGi upgrade-to-aem-forms-osgi

Installieren des AEM Forms-Add-on-Pakets. Die Schritte sind hier aufgeführt:

1. Öffnen Sie Software Distribution. Zum Anmelden bei Software Distribution benötigen Sie eine Adobe ID.

2. Wählen Sie im Kopfzeilenmenü Adobe Experience Manager aus.

3. Im Abschnitt Filter:

   1. Wählen Sie Formulare aus der Dropdown-Liste Lösung aus.
   2. Wählen Sie die Version aus und geben Sie sie für das Paket ein. Sie können auch die Option Downloads durchsuchen verwenden, um die Ergebnisse zu filtern.

4. Wählen Sie den für Ihr Betriebssystem zutreffenden Paketnamen, dann EULA-Bedingungen akzeptieren und dann Herunterladen aus.

5. Öffnen Sie den Paket-Manager und klicken Sie auf Paket hochladen, um das Paket hochzuladen.

6. Wählen Sie das Paket aus und klicken Sie auf Installieren.

   Sie können das Paket auch über den direkten Link herunterladen, der im Artikel AEM Forms-Versionen aufgeführt ist.

   Sobald das Paket installiert ist, werden Sie aufgefordert, die AEM-Instanz neu zu starten. Halten Sie den Server nicht sofort an. Warten Sie vor dem Anhalten des AEM Forms-Servers, bis die Meldungen „ServiceEvent REGISTERED“ und „ServiceEvent UNREGISTERED“ nicht mehr in der Datei <crx-repository>/error.log angezeigt werden und das Protokoll stabil ist. Beachten Sie außerdem, dass einige Pakete im installierten Zustand verbleiben können. Sie können den Status dieser Pakete ignorieren.

   Starten Sie die AEM-Instanz mit den folgenden zusätzlichen JVM-Befehlszeilenparametern neu:
   --add-opens java.base/java.util=ALL-UNNAMED --add-exports=java.xml/com.sun.org.apache.xml.internal.serialize=ALL-UNNAMED

   Wenn der Server über ein Skript oder einen Service gestartet wird, aktualisieren Sie ihn entsprechend, um die oben genannten einzuschließen, damit diese auch nach nachfolgenden Neustarts wirksam werden.

   note note
   NOTE
   Es wird empfohlen, den Befehl „Strg+C“ zu verwenden, um das SDK neu zu starten. Das Neustarten des AEM SDK mit anderen Methoden, z. B. dem Beenden von Java-Prozessen, kann zu Inkonsistenzen in der AEM-Entwicklungsumgebung führen.

Führen Sie nach der Installation folgende Aktivitäten durch.

• Ausführen des Migrationsdienstprogramms

  Das Migrationsdienstprogramm macht die adaptiven Formulare und Korrespondenzmanagement-Assets aus früheren Versionen kompatibel mit AEM 6.5 Forms. Sie können das Dienstprogramm von der AEM Software Distribution herunterladen. Informationen in Einzelschritten zur Konfiguration und Verwendung des Migrationsdienstprogramms finden Sie in der Dokumentation zum Migrationsdienstprogramm.

  Wenn Sie Beispiel zur Integrierung der Komponente für Entwurf und Übermittlung mit der Datenbank verwenden und von einer früheren Version aktualisieren, führen Sie nach der Aktualisierung die folgenden SQL-Abfragen aus:

  code language-sql
  UPDATE metadata m, additionalmetadatatable am SET m.dataType = am.value WHERE m.id = am.id AND am.key = 'dataType'

  code language-sql
  DELETE from additionalmetadatatable WHERE `key` = 'dataType'

• (Nur wenn Sie von AEM 6.2 Forms oder früheren Versionen aktualisieren) Konfigurieren Sie Adobe Sign neu

  Wenn Sie Adobe Sign in der vorherigen Version von AEM Forms konfiguriert haben, konfigurieren Sie Adobe Sign über AEM Cloud Services neu. Weitere Informationen finden Sie unter Adobe Sign mit AEM Forms integrieren.

• Unterstützung für jQuery

  In AEM 6.5 Forms wird die jQuery-Version auf 3.2.1 aktualisiert und die jQuery-UI-Version wird auf 1.12.1 aktualisiert. AEM Form verwendet JQuery im noConflict-Modus. Wenn Sie also eine andere jQuery-Version verwenden, werden bei der Durchführung eines Upgrades keine Probleme angezeigt. Wenn Sie jedoch auf AEM 6.5 Forms aktualisieren:

  • Stellen Sie sicher, dass Ihre benutzerdefinierten Komponenten, falls vorhanden, mit unterstützten jQuery-Versionen kompatibel sind.
  • Entfernen Sie nicht unterstützte APIs aus den benutzerdefinierten Komponenten. Siehe Upgrade-Handbuch für die Liste der entfernten APIs. Beispielsweise wird die Unterstützung für die APIs load(), .unload() und .error() entfernt. Verwenden Sie die Methode .on() anstelle der oben genannten APIs. Ändern Sie beispielsweise $("img").load(fn) to $("img").on("load", fn).

• (Nur wenn Sie von AEM 6.2 Forms oder früheren Versionen aktualisieren) Konfigurieren Sie Analysen und Berichte neu

  In AEM 6.4 Forms sind keine Traffic-Variablen für Quelle und Erfolgsereignis für Impressionen verfügbar. Wenn Sie von AEM 6.2 Forms oder vorherigen Versionen aktualisieren, sendet AEM Forms daher keine Daten mehr an den Adobe Analytics-Server und es stehen keine Analyseberichte für adaptive Formulare zur Verfügung. Darüber hinaus führt AEM 6.4 Forms Traffic-Variablen für die Version der Formularanalyse und das Erfolgsereignis für die auf einem Feld verbrachte Zeit ein. Konfigurieren Sie daher die Analyse und die Berichte für Ihre AEM Forms-Umgebung neu. Ausführliche Anweisungen finden Sie unter Konfigurieren von Analysen und Berichten.

Vergewissern Sie sich, dass der Server erfolgreich aktualisiert und alle Daten migriert wurden und dass der Server einwandfrei funktioniert.

• Überprüfen Sie den Status der Pakete: Stellen Sie sicher, dass alle Pakete sich im aktiven Status befinden.

• Überprüfen Sie die Replikation und Rückwärtsreplikation: Veröffentlichen Sie einige migrierte Formulare, füllen Sie sie aus und senden Sie sie. Überprüfen Sie auch die gesendeten Daten.

• Überprüfen Sie den Zugriff auf die Administrator- und Entwicklerbenutzeroberflächen: Melden Sie sich über ein Administratorkonto bei der AEM-Instanz an und stellen Sie sicher, dass Sie Zugriff auf die folgenden URLs haben:

  • https://'[server]:[port]'/crx/packmgr
  • https://'[server]:[port]'/crx/de
  • https://'[server]:[port]'/aem/forms.html/content/dam/formsanddocuments

Navigieren Sie zum Red Hat Developer Portal:
https://developers.redhat.com/products/eap/download

Laden Sie die JBoss EAP 8 ZIP-Distribution für Windows herunter.

Extrahieren Sie die heruntergeladene ZIP-Datei in das bevorzugte Installationsverzeichnis.

Notieren Sie sich diesen Ordnerpfad, der in diesem Handbuch <JBOSS_HOME> wird.

Beispiel:
C:\jboss-eap-8.0

Erstellen Sie ein temporäres Arbeitsverzeichnis:

C:\aem\war-config

Kopieren Sie cq-quickstart.war in diesen Ordner.

Öffnen Sie Eingabeaufforderung und navigieren Sie zum Arbeitsverzeichnis:

cd C:\aem\war-config

Extrahieren Sie die WAR-Datei:

jar -xvf cq-quickstart.war

Dadurch wird eine Verzeichnisstruktur mit WEB-INF und anderen Anwendungsdateien erstellt.

Navigieren Sie zum WEB-INF-Verzeichnis in Ihrem extrahierten WAR:

cd WEB-INF

Erstellen Sie eine neue Datei mit dem Namen jboss-deployment-structure.xml.

Fügen Sie den folgenden XML-Inhalt hinzu:

<?xml version="1.0" encoding="UTF-8"?>
<jboss-deployment-structure xmlns="urn:jboss:deployment-structure:1.2">
    <deployment>
        <dependencies>
            <module name="jdk.unsupported" />
        </dependencies>
    </deployment>
</jboss-deployment-structure>

Speichern und schließen Sie die Datei.

Öffnen Sie WEB-INF\web.xml in einem Texteditor.

Suchen Sie den <servlet> Abschnitt, der die Ausführungsmodus-Konfiguration enthält:

<!-- Set the runmode per default to author -->
<init-param>
    <param-name>sling.run.modes</param-name>
    <param-value>author</param-value>
</init-param>
<load-on-startup>100</load-on-startup>
</servlet>

Ersetzen Sie das schließende </servlet>-Tag und die vorangehende Zeile durch:

<init-param>
    <param-name>sling.run.modes</param-name>
    <param-value>author</param-value>
</init-param>
<multipart-config>
    <max-file-size>1048576000</max-file-size>
    <max-request-size>1048576000</max-request-size>
    <file-size-threshold>0</file-size-threshold>
</multipart-config>
<load-on-startup>100</load-on-startup>
</servlet>

Speichern und schließen Sie web.xml.

Navigieren Sie zurück zum Arbeitsverzeichnis, das den extrahierten Inhalt enthält:

cd C:\aem\war-config

Erstellen Sie die neue WAR-Datei:

jar -cvf cq-quickstart.war *

Kopieren Sie die neu gepackten cq-quickstart.war in das JBoss-Bereitstellungsverzeichnis:

<JBOSS_HOME>\standalone\deployments

Beispiel:
C:\jboss-eap-8.0\standalone\deployments

Öffnen Sie <JBOSS_HOME>\bin\standalone.conf.bat in einem Texteditor.

Ändern Sie die folgende Zeile, um den Heap-Speicher festzulegen, oder fügen Sie sie hinzu:

set "JAVA_OPTS=-Xms4096m -Xmx4096m -XX:MaxMetaspaceSize=512m"

Öffnen Sie Eingabeaufforderung als Administrator.

Navigieren Sie zum Ordner JBoss bin :

cd <JBOSS_HOME>\bin

Beispiel:
cmd cd C:\jboss-eap-8.0\bin

Starten Sie den JBoss-Server:

standalone.bat -b 0.0.0.0 -bmanagement 0.0.0.0

Parameter:

• -b 0.0.0.0 - Bindet den Server an alle Netzwerkschnittstellen
• -bmanagement 0.0.0.0 - Bindet die Verwaltungsschnittstelle an alle Netzwerkschnittstellen