Conseils de mise à niveau d’AEM Forms JEE pour la compatibilité des versions, des systèmes d’exploitation, de JBoss et des plateformes
Les clients qui effectuent une mise à niveau d’AEM Forms sur JEE (passer à un Service Pack plus récent, migrer entre les versions RHEL ou choisir entre les versions 6.5.x et 6.5 LTS) ont besoin d’une confirmation officielle des plateformes prises en charge avant de continuer. AEM Forms on JEE applique une compatibilité stricte entre les couches de système d’exploitation, JBoss, Java et de base de données. Les combinaisons prises en charge résident dans la matrice de plateforme Adobe, mais doivent être associées à votre environnement spécifique. Si vous ignorez cette validation, vous risquez d’installer des fichiers binaires non pris en charge ou de vous engager dans un chemin de mise à niveau infructueux. Confirmer votre combinaison de systèmes d’exploitation, JBoss et Java par rapport à la matrice, obtenir les programmes d’installation corrects et appliquer le pack de services ou la mise à niveau LTS en séquence résout l’incertitude.
Description description
Environnements :
- Adobe Experience Manager Forms sur JEE
- Adobe Experience Manager 6.5 (sur site)
- Adobe Experience Manager 6.5 LTS
- JBoss EAP 7.4.x et JBoss EAP 8
- Red Hat Enterprise Linux et Windows Server
Problème/Symptômes :
- Il n’est pas certain que les versions d’AEM Forms prennent en charge des plateformes de système d’exploitation spécifiques telles que RHEL 8, RHEL 9 et Windows Server 2022.
- Il existe une incertitude quant à la compatibilité des versions de JBoss EAP ou Java pour une version d’AEM Forms spécifique, telle que JBoss 7.4.22 avec SP22 ou Java 17 et 21 avec LTS.
- La demande vise à obtenir une confirmation faisant autorité des plateformes prises en charge, de la disponibilité des programmes d’installation, des conditions préalables et du séquencement des mises à niveau plutôt qu’à résoudre les problèmes.
Cause principale :
AEM Forms on JEE applique une compatibilité stricte entre les couches de système d’exploitation, JBoss, Java et de base de données. Les combinaisons doivent donc être validées avant la mise à niveau ou l’application d’un pack de services. Adobe documente les combinaisons prises en charge dans sa matrice de plateforme, mais elles ont besoin d’être interprétées et mappées correctement à votre environnement. Si vous ne confirmez pas les combinaisons prises en charge, vous risquez d’installer des fichiers binaires non pris en charge ou de planifier un chemin de mise à niveau infructueux.
Résolution resolution
Pour résoudre ce problème, procédez comme suit :
- Identifiez la version AEM Forms JEE actuelle et les composants de la plateforme. Collectez la version du système d’exploitation, la version JBoss EAP, la version Java et le type de base de données. Confirmez-les en exécutant
java -version, en vérifiant la version de la console JBoss EAP et en exécutant des commandes de mise à jour du système d’exploitation, telles quecat /etc/redhat-releasesous RHEL. - Déterminez si votre cible est une mise à niveau du Service Pack ou une migration LTS. 6.5 LTS nécessite Java 17 ou 21 et JBoss EAP 8, tandis que les mises à niveau du pack de services 6.5.x restent sur Java 8 ou 11 et JBoss 7.4.x. Vous indiquez ainsi s’il faut cibler 6.5.24 (SP24) ou 6.5 LTS.
- Validez la prise en charge des plateformes à l’aide de la Matrice des plateformes prises en charge officielle. Confirmez que votre système d’exploitation (RHEL 8, RHEL 9 ou Windows Server 2022) et la version de JBoss apparaissent dans la matrice pour votre version cible. Si votre plateforme n’est pas répertoriée, sélectionnez une version du système d’exploitation et de JBoss explicitement prise en charge avant la mise à niveau.
- Pour les migrations du système d’exploitation (RHEL 7 vers RHEL 8 ou RHEL 8 vers RHEL 9), confirmez la faisabilité. RHEL 8 nécessite SP11 ou une version ultérieure et RHEL 9 prend en charge SP23 et SP24. Faites correspondre votre système d’exploitation cible aux versions prises en charge dans la matrice. Si votre version ne prend pas en charge le système d’exploitation cible, planifiez une migration dynamique à l’aide d’un nouveau serveur.
- Téléchargez le programme d’installation complet et le pack de services appropriés à partir de la distribution logicielle d’Adobe, y compris le programme d’installation complet du SP23, le correctif du SP24 et les modules complémentaires de Forms. Les noms de fichier correspondent à des modèles tels que
aemforms_server_6_5_0_jboss_all_unix.tar.gzouadobe-aem-forms-jee-servicepack-6.5.24.0-win-jboss.zip. Si les fichiers n’apparaissent pas dans la Distribution logicielle, vérifiez que votre Adobe ID dispose des droits appropriés dans Admin Console. - Préparez la mise à niveau. Sauvegardez les répertoires CRX, le répertoire de stockage global de documents, TEMP et la base de données, et vérifiez que les sauvegardes existent avec les horodatages avant de continuer.
- Installez le nouveau programme d’installation complet d’AEM Forms JEE. Démarrez JBoss et confirmez le chargement du
/lc. Si le déploiement échoue, recherchez les erreurs de déploiement dans les journaux JBoss et validez les bibliothèques du système d’exploitation. - Appliquez le dernier pack de services (SP24) et les modules complémentaires Forms. Installez le correctif SP24 pour JBoss sous Linux ou Windows, puis installez les composants OSGi SP24 (fragment de servlet, pack de services et module complémentaire Forms). Vérifiez
/lc/system/console/bundlespour confirmer que les lots ne produisent plus d’erreurs en continu. Dans le cas contraire, réinstallez le fragment de servlet ou recherchezerror.logdépendances manquantes. - Pour les mises à niveau de JBoss, vérifiez les variables d’environnement requises. Définissez
DISABLE_JDK_SERIAL_FILTER= true lors de la mise à niveau de JBoss EAP 7.4.x, puis confirmez que JBoss démarre sans erreurs de sérialisation. Si les erreurs de sérialisation persistent, vérifiez que la variable est correctement exportée dans le script de démarrage de JBoss. - Validez l’environnement mis à niveau. Démarrez JBoss, accédez à
/adminuiet testez des modules clés tels que PDF Generator, la connectivité de Workbench et les extensions Reader. Recherchez de nouvelles traces de pile ou des messages en continu dans laerror.log.