DokumentationExperience Cloud KCS

Aktualisieren von AEM Forms 6.5 zwischen Service Packs auf JEE und OSGi

Letzte Aktualisierung: 23. Juni 2026

AEM Forms-Kunden sehen sich beim Wechsel zwischen AEM 6.5 Service Packs mit Unsicherheit hinsichtlich des richtigen Upgrade-Pfads konfrontiert, da Forms-Komponenten getrennt vom Haupt-Service Pack von AEM bereitgestellt werden und JEE- und OSGi-Bereitstellungen unterschiedliche Installationsabläufe verwenden. Adobe verteilt mehrere Pakete pro Service Pack - das kumulative JEE-Installationsprogramm, das OSGi-Add-on, Hotfixes und Kompatibilitätspakete -, sodass Sie leicht falsch identifizieren können, welche für eine bestimmte Umgebung gelten. Dies ist eine Konfigurationsfrage, kein Softwarefehler. Das Ermitteln Ihres Laufzeittyps, das Bestätigen Ihrer aktuellen Version und das Installieren der richtigen Pakete in der richtigen Reihenfolge führt zu einem sauberen Upgrade.

Beschreibung description

Problem: Auswählen des richtigen AEM Forms 6.5 Service Pack-Aktualisierungspfads für JEE und OSGi

Beschreibung

Der Wechsel von einem AEM 6.5 Service Pack zu einem anderen - z. B. SP18 zu SP24, SP20 zu SP23 oder SP23 mit einem Hotfix zu SP24 - wirft die Frage auf, welche Pakete gelten und in welcher Reihenfolge sie installiert werden sollen. Häufig gestellte Fragen beziehen sich darauf, ob direkte Upgrades unterstützt werden, ob bestehende Hotfixes zuerst entfernt werden müssen, welches Forms-Add-on installiert werden muss, welches JEE-Patch-Installationsprogramm erforderlich ist und wie Plattformanforderungen wie WebSphere, JBoss, Windows oder Linux gehandhabt werden müssen.

Umgebung:

  • AEM Forms 6.5 (On-Premise)
  • OSGi-Laufzeit
  • JEE-Laufzeit (WebSphere, WebLogic, JBoss)
  • Windows- und Linux-Plattformen

Problem/Symptome:

  • Unsicherheit darüber, welches AEM Forms Service Pack oder Add-on installiert werden soll, einschließlich mehrerer Add-on-Builds für dasselbe Service Pack
  • Verwirrung darüber, ob ein direkter Aktualisierungspfad unterstützt wird (z. B. SP18 → SP24 oder SP20 → SP23)
  • Fragen dazu, ob vorhandene Hotfixes entfernt werden müssen, bevor ein neueres Service Pack angewendet wird
  • Unklare Anleitungen dazu, wann JEE-Patches erforderlich sind im Vergleich zu OSGi-Add-on-Paketen

Grundursache:

AEM Forms-Upgrades erfordern plattformabhängige Schritte, da Forms-Komponenten getrennt vom AEM Service Pack bereitgestellt werden und JEE- und OSGi-Bereitstellungen unterschiedliche Patch- und Installationsabläufe verwenden. Da Adobe mehrere Pakete pro Service Pack verteilt - ein kumulatives JEE-Installationsprogramm, ein OSGi-Add-on, Hotfixes und Kompatibilitätspakete - ist es einfach, falsch zu interpretieren, welche Pakete für eine bestimmte Umgebung gelten. Das Problem ist Konfigurationsunsicherheit, kein Software-Fehler.

Wie kann ich bestätigen

  1. Identifizieren Sie Ihren Laufzeittyp. Melden Sie sich bei AEM an und überprüfen Sie, ob /lc vorhanden ist. Wenn /lc/login geladen wird, handelt es sich um JEE. Wenn nur /aem/start.html geladen wird, ist es OSGi. JEE-Umgebungen verwenden EAR-/WAR-Dateien und den Configuration Manager.
  2. Bestätigen Sie Ihre aktuelle Service Pack-Version. Navigieren Sie zu /system/console/productinfo und überprüfen Sie den Abschnitt Installierte Produkte (zum Beispiel: Adobe Experience Manager (6.5.23.0)).
  3. Überprüfen Sie die Plattformkompatibilität. Vergleichen Sie vor dem Upgrade Ihre Betriebssystem-, Java-, Anwendungs-Server- und Datenbankversionen mit der Matrix der unterstützten Plattformen.

Lösung resolution

  1. Wählen Sie den richtigen Aktualisierungspfad basierend auf Ihrem anfänglichen Service Pack:

    • Vom SP18 oder SP20 wird ein direktes Upgrade auf SP24 oder SP23 unterstützt.
    • Aktualisieren Sie vom SP11 zunächst die zugrunde liegenden Plattformkomponenten und dann auf SP24.
    • Wenn Sie SP23 mit einem Hotfix verwenden, fahren Sie normal fort und entfernen Sie den Hotfix nicht. Service Packs sind kumulativ.

  2. OSGi - Installieren Sie das Haupt-Service Pack von AEM 6.5: Laden Sie aem-service-pkg-6.5.xx.x.zip in CRX Package Manager hoch und klicken Sie auf Installieren. Besuchen Sie die /system/console/productinfo, um die Aktualisierungen der SP-Version zu bestätigen, und stellen Sie sicher, dass alle Pakete ACTIVE oder FRAGMENT sind. Wenn die Installation fehlschlägt, überprüfen Sie error.log auf Abhängigkeitsfehler.

  3. OSGi - Installieren Sie das richtige Forms-Add-on-Paket: Identifizieren und installieren Sie den Add-on-Build, der Ihrem Service Pack und Ihrer Plattform entspricht. Überprüfen Sie, /system/console/bundles sich die AEM Forms-Pakete im ACTIVE befinden. Wenn die Installation fehlschlägt, starten Sie AEM neu und versuchen es erneut.

  4. OSGi - Installieren Sie zusätzliche Hotfixes nur, wenn relevant: Wenden Sie erforderliche Fehlerbehebungen wie Granite-Sicherheits-Hotfixes an. Bestätigen Sie die aktualisierten Komponenten unter /system/console/productinfo und überprüfen Sie die Hotfix-Voraussetzungen auf der Detailseite zur Software Distribution.

  5. JEE - Installieren des zugehörigen JEE-Patch-Installationsprogramms: Führen Sie das JEE-Patch-Installationsprogramm für Ihr Ziel-Service Pack aus. Bestätigen Sie, dass Configuration Manager die aktualisierte Version erkennt. Wenn dies fehlschlägt, erfassen Sie die Configuration Manager-Protokolle.

  6. JEE - Anwendungsserver neu starten Durchführen eines sauberen Neustarts von WebSphere, WebLogic oder JBoss unter Verwendung der nativen Anwendungsserver-Skripte. Vergewissern Sie sich, dass in den Protokollen des Anwendungsservers keine Bereitstellungsfehler angezeigt werden. Wenn EARs nicht bereitgestellt werden können, überprüfen Sie sie auf fehlende JNDI-Einträge, Datenquellen oder Repository-Pfade.

  7. Vollständiges Upgrade (JEE und OSGi) validieren Melden Sie sich bei AEM an und bestätigen Sie das Laden von Adaptive Forms, Workflows und anderen Forms-Funktionen. Überprüfen Sie die Bundles und Produktinformationsseiten und überprüfen Sie error.log auf fehlende Pakete oder Abhängigkeitsfehler.

Validierung

  1. Navigieren Sie zu /system/console/productinfo und bestätigen Sie, dass die SP-Version korrekt angezeigt wird (Beispiel: Adobe Experience Manager (6.5.24.0)).
  2. Überprüfen Sie, ob alle OSGi-Bundles über /system/console/bundles ACTIVE oder FRAGMENT sind.
  3. Bestätigen Sie für JEE alle ohne Fehler bereitgestellten EARs, indem Sie die Anwendungs-Server-Protokolle nach dem Neustart überprüfen.
  4. Führen Sie einen einfachen Forms-Workflow aus oder rendern Sie ein adaptives Formular, um die Laufzeitstabilität zu bestätigen.

Verwandtes Lesen

recommendation-more-help
experience-cloud-kcs-help-kbarticles