DocumentationExperience Cloud KCS

Mise à niveau d’AEM Forms 6.5 entre les packs de services sur JEE et OSGi

Dernière mise à jour : 23 juin 2026

Les clients AEM Forms ne sont pas certains du chemin de mise à niveau correct lorsqu’ils passent d’un Service Pack AEM 6.5 à un autre, car les composants Forms sont fournis séparément du Service Pack AEM principal et les déploiements JEE et OSGi utilisent des flux d’installation différents. Adobe distribue plusieurs packages par pack de services (le programme d’installation cumulatif JEE, le module complémentaire OSGi, les correctifs et les packages de compatibilité). Il est donc facile de distinguer ceux qui s’appliquent à un environnement donné. Il s’agit d’une question de configuration, et non d’un défaut logiciel. L’identification de votre type d’exécution, la confirmation de votre version actuelle et l’installation des packages appropriés dans le bon ordre donnent lieu à une mise à niveau épurée.

Description description

Problème : Sélection du chemin de mise à niveau du pack de services AEM Forms 6.5 approprié pour JEE et OSGi

Description

Le passage d’un pack de services AEM 6.5 à un autre (par exemple, SP18 vers SP24, SP20 vers SP23 ou SP23 avec un correctif vers SP24) soulève des questions quant aux packages qui s’appliquent et à l’ordre dans lequel les installer. Les questions courantes consistent à savoir si les mises à niveau directes sont prises en charge, si les correctifs existants doivent être supprimés en premier, quel module complémentaire Forms installer, quel programme d’installation de correctifs JEE est requis et comment gérer les exigences de plateforme telles que WebSphere, JBoss, Windows ou Linux.

Environnement :

  • AEM Forms 6.5 (On-Premise)
  • Exécution OSGi
  • Exécution JEE (WebSphere, WebLogic, JBoss)
  • Plateformes Windows et Linux

Problème/Symptômes :

  • Incertitude quant au pack de services ou au module complémentaire AEM Forms à installer, y compris les différentes versions de module complémentaire pour le même pack de services
  • Confusion quant à la prise en charge d’un chemin de mise à niveau directe (par exemple, SP18 → SP24 ou SP20 → SP23)
  • Questions indiquant si les correctifs existants doivent être supprimés avant d’appliquer un pack de services plus récent
  • Conseils peu clairs sur le moment où les correctifs JEE sont requis par rapport aux packages de modules complémentaires OSGi

Cause principale :

Les mises à niveau d’AEM Forms nécessitent des étapes dépendantes de la plateforme, car les composants de Forms sont fournis séparément du pack de services AEM principal, et les déploiements JEE et OSGi utilisent des flux de correctifs et d’installations différents. Comme Adobe distribue plusieurs packages par pack de services (un programme d’installation cumulatif JEE, un module complémentaire OSGi, des correctifs et des packages de compatibilité), il est facile de mal interpréter les packages qui s’appliquent à un environnement donné. Le problème réside dans l’incertitude de la configuration, et non dans un défaut logiciel.

Comment confirmer

  1. Identifiez le type d’exécution. Connectez-vous à AEM et vérifiez si /lc est présent. Si /lc/login charge, c’est JEE ; si seulement /aem/start.html charge, c’est OSGi. Les environnements JEE utilisent des fichiers EAR/WAR et Configuration Manager.
  2. Confirmez la version actuelle de votre pack de services. Accédez à /system/console/productinfo et vérifiez la section Produits installés (par exemple : Adobe Experience Manager (6.5.23.0)).
  3. Vérifiez la compatibilité de la plateforme. Comparez les versions du système d’exploitation, de Java, du serveur d’applications et de la base de données à la matrice des plateformes prises en charge avant la mise à niveau.

Résolution resolution

  1. Sélectionnez le chemin de mise à niveau approprié en fonction de votre pack de services de départ :

    • À partir du SP18 ou SP20, une mise à niveau directe vers le SP24 ou SP23 est prise en charge.
    • À partir du SP11, mettez d’abord à niveau les composants sous-jacents de la plateforme, puis passez au SP24.
    • Si vous utilisez le SP23 avec un correctif, procédez normalement et ne supprimez pas le correctif ; les packs de services sont cumulatifs.

  2. OSGi — installez le pack de services AEM 6.5 principal : téléchargez aem-service-pkg-6.5.xx.x.zip dans le gestionnaire de packages CRX et cliquez sur Installer. Consultez /system/console/productinfo pour confirmer les mises à jour de la version du SP et vous assurer que tous les lots sont ACTIVE ou FRAGMENT. Si l’installation échoue, recherchez error.log erreurs de dépendance.

  3. OSGi — Installez le package complémentaire Forms approprié : Identifiez et installez la version du module complémentaire correspondant à votre pack de services et à votre plateforme. Vérifiez /system/console/bundles les lots AEM Forms sont à l’état ACTIVE. Si l’installation échoue, redémarrez AEM et réessayez.

  4. OSGi — Installez des correctifs supplémentaires uniquement si nécessaire : appliquez les correctifs requis tels que les correctifs de sécurité Granite. Confirmez la mise à jour des composants sur /system/console/productinfo et vérifiez les conditions préalables du correctif sur la page Détails de la distribution logicielle.

  5. JEE — Installez le programme d’installation du correctif JEE associé : exécutez le programme d’installation du correctif JEE pour votre pack de services cible. Vérifiez que Configuration Manager reconnaît la version mise à jour. En cas d’échec, collectez les journaux de Configuration Manager.

  6. JEE — Redémarrez le serveur d’applications : redémarrez WebSphere, WebLogic ou JBoss à l’aide des scripts natifs du serveur d’applications. Vérifiez que les journaux du serveur d’applications n’affichent aucun échec de déploiement. Si le déploiement des EAR échoue, recherchez les entrées JNDI, les sources de données ou les chemins d’accès au référentiel manquants.

  7. Validez la mise à niveau complète (JEE et OSGi) : Connectez-vous à AEM et confirmez le chargement du Forms adaptatif, des workflows et d’autres fonctionnalités de Forms. Passez en revue les lots et les pages d’informations sur les produits, et recherchez error.log packages manquants ou les erreurs de dépendance.

Validation

  1. Accédez à /system/console/productinfo et vérifiez que la version du SP s’affiche correctement (par exemple : Adobe Experience Manager (6.5.24.0)).
  2. Vérifiez que tous les lots OSGi sont ACTIVE ou FRAGMENT via /system/console/bundles.
  3. Pour JEE, confirmez tous les fichiers EAR déployés sans erreur en examinant les journaux du serveur d’applications après le redémarrage.
  4. Exécutez un workflow Forms de base ou effectuez le rendu d’un formulaire adaptatif pour confirmer la stabilité d’exécution.

Lecture connexe

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