Migration d’AEM Forms de Red Hat JBoss vers JBoss groupé avec Adobe
Cet article explique comment migrer Adobe Experience Manager (AEM) Forms d’une installation Red Hat JBoss vers un environnement JBoss groupé avec Adobe et résoudre les problèmes de migration courants.
Description description
Environnement
Adobe Experience Manager (AEM) Forms (toutes les versions)
Problème/Symptômes
Les organisations qui utilisent AEM Forms sur Red Hat JBoss peuvent avoir besoin de migrer vers l’environnement JBoss groupé avec Adobe. La migration peut entraîner des incohérences de configuration et des problèmes de déploiement, en particulier avec les paramètres de la source de données, les alias de magasin d’informations d’identification et le déploiement de l’application.
Lors de la migration de Red Hat JBoss vers Adobe-bundled JBoss, les problèmes suivants peuvent se produire :
- Erreurs de configuration de la source de données en raison d’alias de magasin d’informations d’identification incohérents.
- Syntaxe d’URL de connexion SQL Server incorrecte, par exemple utiliser
::1433au lieu de:1433. - Problèmes liés au statut de déploiement des fichiers EAR requis.
- L’étape Vérifier la connexion au serveur de Configuration Manager échoue avec des erreurs HTTP 401 ou HTTP 404 lors de l’accès à l’URL de démarrage de Configuration Manager.
- Des erreurs telles que les erreurs d’appel
RMServiceEJBHelper ClassNotFoundExceptionou DSC se produisent après le démarrage.
Cause
La migration peut exposer des incohérences de configuration, telles que les alias de banque d’informations d’identification et la syntaxe de l’URL de connexion, et les ressources manquantes requises par Configuration Manager. Résolvez ces problèmes pour garantir la réussite de la migration et de l’environnement opérationnel.
Résolution resolution
Suivez les étapes ci-dessous pour résoudre le problème :
- Préparez la migration en sauvegardant votre environnement Red Hat JBoss existant et tous les fichiers de configuration pertinents, et en documentant toutes les configurations personnalisées, les sources de données et les applications déployées.
- Installez l’environnement JBoss fourni avec Adobe pour AEM Forms en suivant la documentation Adobe officielle de votre version.
- Migrez les configurations de source de données en mettant à jour les fichiers de configuration de source de données pour référencer les alias corrects du magasin d’informations d’identification. Si le script de migration Adobe crée de nouveaux alias, assurez-vous que vos sources de données référencent ces alias ou ajoutez l’alias requis à votre banque d’informations d’identification avec le mot de passe de base de données correct. Corrigez les erreurs de syntaxe de l’URL de connexion SQL Server et assurez-vous que le port est spécifié comme
:1433, et non::1433. - Déployez des composants d’application en démarrant JBoss à l’aide de la commande appropriée pour votre fichier de configuration et votre environnement. Déployez manuellement les fichiers EAR requis et vérifiez que tous les déploiements affichent le statut OK.
- Validez la connectivité de la base de données en testant toutes les sources de données configurées et en confirmant les connexions réussies.
- Vérifiez l’état du serveur et de l’application en accédant à l’interface utilisateur d’administration d’AEM Forms et en vérifiant que tous les lots sont actifs sur la page
/lc/system/console/bundles. Utilisez Configuration Manager pour exécuter l’étape de vérification de la connexion au serveur. Si vous rencontrez des erreurs HTTP 401 ou HTTP 404 au niveau de l’URL de démarrage du gestionnaire de configuration, vérifiez que la ressource existe et que le chemin d’accès au référentiel est correct. Si la ressource est manquante, mais que les composants de DSC sont déjà déployés et actifs, cela peut ne pas avoir d’impact sur les implémentations actuelles. Le problème peut être résolu après la prochaine installation du correctif et une exécution complète de Configuration Manager. - Résolvez les erreurs restantes en examinant les erreurs d’appel
ClassNotFoundExceptionou DSC, en examinant les journaux et en s’assurant que tous les composants requis sont déployés.
Vérifiez que la migration a réussi en confirmant que tous les services sont en cours d’exécution, que les lots sont actifs et que les connexions à la base de données ont réussi.