AEM Forms JEE-Upgrade-Anleitung für Kompatibilität mit Version, Betriebssystem, JBoss und Plattform
Kunden, die ein Upgrade von AEM Forms on JEE durchführen - ob sie auf ein neueres Service Pack umsteigen, zwischen RHEL-Versionen migrieren oder zwischen 6.5.x und 6.5 LTS wählen -, benötigen eine Bestätigung der unterstützten Plattformen, bevor sie fortfahren. AEM Forms on JEE erzwingt eine strikte Kompatibilität zwischen den Betriebssystem-, JBoss-, Java- und Datenbankebenen, und die unterstützten Kombinationen sind in der Adobe-Plattformmatrix verfügbar, müssen jedoch Ihrer spezifischen Umgebung zugeordnet werden. Wenn Sie diese Validierung überspringen, riskieren Sie die Installation nicht unterstützter Binärdateien oder die Festlegung auf einen Aktualisierungspfad, der nicht erfolgreich sein kann. Durch die Bestätigung der Kombination aus Betriebssystem, JBoss und Java mit der Matrix, das Abrufen der richtigen Installationsprogramme und das nacheinander Anwenden des Service Packs oder LTS-Upgrades wird die Unsicherheit behoben.
Beschreibung description
Umgebungen:
- Adobe Experience Manager Forms on JEE
- Adobe Experience Manager 6.5 (On-Premise)
- Adobe Experience Manager 6.5 LTS
- JBoss EAP 7.4.x und JBoss EAP 8
- Red Hat Enterprise Linux und Windows Server
Problem/Symptome:
- Es ist nicht sicher, welche AEM Forms-Versionen bestimmte Betriebssystemplattformen wie RHEL 8, RHEL 9 und Windows Server 2022 unterstützen.
- Es besteht Unsicherheit über kompatible JBoss EAP- oder Java-Versionen für eine bestimmte AEM Forms-Version, z. B. JBoss 7.4.22 mit SP22 oder Java 17 und 21 mit LTS.
- Bei der Anfrage handelt es sich um eine autoritative Bestätigung der unterstützten Plattformen, Verfügbarkeit des Installationsprogramms, Voraussetzungen und Upgrade-Reihenfolge, nicht um Fehlerbehebung bzw. -behebung.
Grundursache:
AEM Forms on JEE erzwingt eine strikte Kompatibilität zwischen den Betriebssystem-, JBoss-, Java- und Datenbankebenen, sodass Kombinationen vor dem Upgrade oder der Anwendung eines Service Packs überprüft werden müssen. Adobe dokumentiert die unterstützten Kombinationen in seiner Plattformmatrix, sie benötigen jedoch eine korrekte Interpretation und Zuordnung zu Ihrer Umgebung. Wenn Sie die unterstützten Kombinationen nicht bestätigen, riskieren Sie, nicht unterstützte Binärdateien zu installieren oder einen Aktualisierungspfad zu planen, der nicht erfolgreich sein kann.
Lösung resolution
Führen Sie zur Behebung des Problems folgende Schritte aus:
- Identifizieren Sie Ihre aktuelle AEM Forms JEE-Version und Plattformkomponenten. Erfassen Sie die Betriebssystemversion, JBoss EAP-Version, Java-Version und den Datenbanktyp. Bestätigen Sie diese, indem Sie
java -versionausführen, die JBoss EAP-Konsolenversion überprüfen und Betriebssystemversionsbefehle wiecat /etc/redhat-releaseauf RHEL ausführen. - Ermitteln Sie, ob es sich bei Ihrem Ziel um ein Service Pack-Upgrade oder eine LTS-Migration handelt. 6.5 LTS erfordert Java 17 oder 21 und JBoss EAP 8, während 6.5.x Service Pack-Upgrades auf Java 8 oder 11 und JBoss 7.4.x bleiben. Dadurch wird angezeigt, ob 6.5.24 (SP24) oder 6.5 LTS als Ziel ausgewählt werden soll.
- Validieren Sie die Plattformunterstützung mithilfe der offiziellen Matrix der unterstützten Plattformen. Überprüfen Sie, ob Ihr Betriebssystem (RHEL 8, RHEL 9 oder Windows Server 2022) und die JBoss-Version in der Matrix für Ihre Zielversion angezeigt werden. Wenn Ihre Plattform nicht aufgeführt ist, wählen Sie eine Betriebssystem- und JBoss-Version aus, die vor dem Upgrade explizit unterstützt wird.
- Für OS-Migrationen (RHEL 7 zu RHEL 8 oder RHEL 8 zu RHEL 9), bestätigen Sie die Durchführbarkeit. RHEL 8 erfordert SP11 oder höher, und RHEL 9 unterstützt SP23 und SP24. Passen Sie Ihr Ziel-Betriebssystem an die unterstützten Versionen in der Matrix an. Wenn Ihre Version das Zielbetriebssystem nicht unterstützt, planen Sie eine dezentrale Migration mit einem neuen Server.
- Laden Sie das richtige vollständige Installationsprogramm und Service Pack von Adobe Software Distribution herunter, einschließlich des SP23-Vollinstallationsprogramms, des SP24-Patches und der Forms-Add-ons. Dateinamen entsprechen Mustern wie
aemforms_server_6_5_0_jboss_all_unix.tar.gzoderadobe-aem-forms-jee-servicepack-6.5.24.0-win-jboss.zip. Wenn die Dateien nicht in Software Distribution angezeigt werden, überprüfen Sie, ob Ihr Adobe ID über die richtigen Berechtigungen in der Admin Console verfügt. - Vorbereiten des Upgrades. Sichern Sie die CRX-Ordner, den globalen Dokumentenspeicher, die TEMP-Datei und die Datenbank, und bestätigen Sie, dass die Sicherungen mit Zeitstempeln vorhanden sind, bevor Sie fortfahren.
- Installieren Sie das neue Vollinstallationsprogramm für AEM Forms JEE. Starten Sie JBoss und bestätigen Sie, dass
/lcgeladen wird. Wenn die Bereitstellung fehlschlägt, überprüfen Sie die JBoss-Protokolle auf Bereitstellungsfehler und validieren Sie die Betriebssystembibliotheken. - Wenden Sie das neueste Service Pack (SP24) und die neuesten Forms-Add-ons an. Installieren Sie den SP24-Patch für JBoss unter Linux oder Windows und installieren Sie dann die SP24-OSGi-Komponenten (Servlet-Fragment, Service Pack und Forms-Add-on). Überprüfen Sie
/lc/system/console/bundles, um zu bestätigen, dass die Pakete keine rollierenden Fehler mehr erzeugen. Wenn dies nicht der Fall ist, installieren Sie das Servlet-Fragment neu oder überprüfen Sieerror.logauf fehlende Abhängigkeiten. - Überprüfen Sie bei JBoss-Upgrades die erforderlichen Umgebungsvariablen. Legen Sie
DISABLE_JDK_SERIAL_FILTER= true beim Upgrade von JBoss EAP 7.4.x fest und bestätigen Sie dann, dass JBoss ohne Serialisierungsfehler gestartet wird. Wenn die Serialisierungsfehler bestehen bleiben, überprüfen Sie im JBoss-Startskript, ob die Variable korrekt exportiert wurde. - Validieren der aktualisierten Umgebung. Starten Sie JBoss, greifen Sie auf
/adminuizu und testen Sie wichtige Module wie PDF Generator, Workbench-Konnektivität und Reader-Erweiterungen. Überprüfen Sie dieerror.logauf neue Stacktraces oder rollierende Nachrichten.