Migrieren von AEM Forms von Red Hat JBoss zu Adobe-gebündeltem JBoss
In diesem Artikel wird beschrieben, wie Sie Adobe Experience Manager (AEM) Forms von einer Red Hat JBoss-Installation in die Adobe-gebündelte JBoss-Umgebung migrieren und gängige Migrationsprobleme beheben.
Beschreibung description
Umgebung
Adobe Experience Manager (AEM) Forms (alle Versionen)
Problem/Symptome
Organisationen, die AEM Forms unter Red Hat JBoss verwenden, müssen möglicherweise zur Adobe-gebündelten JBoss-Umgebung migrieren. Die Migration kann zu Konfigurationskonflikten und Bereitstellungsproblemen führen, insbesondere bei den Datenquelleneinstellungen, den Aliassen für den Berechtigungsspeicher und der Anwendungsbereitstellung.
Bei der Migration von Red Hat JBoss zu Adobe-gebündeltem JBoss können die folgenden Probleme auftreten:
- Datenquellenkonfigurationsfehler aufgrund von nicht übereinstimmenden Berechtigungsspeicher-Aliassen.
- Falsche Syntax der SQL Server-Verbindungs-URL, z. B. Verwendung von
::1433anstelle von:1433. - Bereitstellungsstatusprobleme für erforderliche EAR-Dateien.
- Der Schritt Überprüfen der Serververbindung von Configuration Manager schlägt beim Zugriff auf die Configuration Manager-Start-URL mit HTTP 401- oder HTTP 404-Fehlern fehl.
- Nach dem Start treten Fehler wie
RMServiceEJBHelper ClassNotFoundException- oder DSC-Aufruffehler auf.
Ursache
Die Migration kann Konfigurationskonflikte aufdecken, z. B. Aliase für den Berechtigungsspeicher und die Syntax der Verbindungs-URL sowie fehlende Ressourcen, die für Configuration Manager erforderlich sind. Beheben Sie diese Probleme, um eine erfolgreiche Migration und ein funktionierendes Umfeld sicherzustellen.
Lösung resolution
Gehen Sie wie folgt vor, um das Problem zu beheben:
- Bereiten Sie sich auf die Migration vor, indem Sie Ihre bestehende Red Hat JBoss-Umgebung und alle relevanten Konfigurationsdateien sichern und alle benutzerdefinierten Konfigurationen, Datenquellen und bereitgestellten Anwendungen dokumentieren.
- Installieren Sie die Adobe-gebündelte JBoss-Umgebung für AEM Forms, indem Sie der offiziellen Adobe-Dokumentation für Ihre Version folgen.
- Migrieren Sie Datenquellenkonfigurationen, indem Sie die Datenquellenkonfigurationsdateien aktualisieren, sodass sie auf die richtigen Aliase für den Berechtigungsspeicher verweisen. Wenn das Adobe-Migrationsskript neue Aliase erstellt, stellen Sie sicher, dass Ihre Datenquellen auf diese Aliase verweisen, oder fügen Sie den erforderlichen Alias mit dem richtigen Datenbankkennwort zu Ihrem Berechtigungsspeicher hinzu. Korrigieren Sie alle SQL Server-Verbindungs-URL-Syntaxfehler und stellen Sie sicher, dass der Port als
:1433und nicht::1433angegeben ist. - Stellen Sie Anwendungskomponenten bereit, indem Sie JBoss mit dem entsprechenden Befehl für Ihre Konfigurationsdatei und Umgebung starten. Stellen Sie die erforderlichen EAR-Dateien manuell bereit und überprüfen Sie, ob alle Bereitstellungen den Status „OK“ aufweisen.
- Überprüfen Sie die Datenbankkonnektivität, indem Sie alle konfigurierten Datenquellen testen und erfolgreiche Verbindungen bestätigen.
- Überprüfen Sie den Server- und Anwendungsstatus, indem Sie auf die Admin-Benutzeroberfläche von AEM Forms zugreifen und überprüfen, ob alle Bundles auf der
/lc/system/console/bundlesaktiv sind. Verwenden Sie Configuration Manager, um den Schritt Serververbindung überprüfen auszuführen. Wenn HTTP 401- oder HTTP 404-Fehler an der Configuration Manager-Start-URL auftreten, überprüfen Sie, ob die Ressource vorhanden ist und der Repository-Pfad korrekt ist. Wenn die Ressource fehlt, DSC-Komponenten jedoch bereits bereitgestellt und aktiv sind, hat dies möglicherweise keine Auswirkungen auf aktuelle Implementierungen. Das Problem kann sich nach der nächsten Patch-Installation und einer vollständigen Ausführung von Configuration Manager beheben. - Beheben Sie die verbleibenden Fehler, indem Sie alle Fehler beim
ClassNotFoundException- oder DSC-Aufruf untersuchen, die Protokolle überprüfen und sicherstellen, dass alle erforderlichen Komponenten bereitgestellt werden.
Überprüfen Sie, ob die Migration erfolgreich war, indem Sie sicherstellen, dass alle Services ausgeführt werden, Pakete aktiv sind und die Datenbankverbindungen erfolgreich waren.