Échec de l’installation et de la mise à niveau d’AEM Dispatcher en raison de discordances de système d’exploitation ou de dépendance

L’installation ou la mise à niveau de Adobe Experience Manager (AEM) Dispatcher échoue lorsqu’Apache ne démarre pas, que les modules ne se chargent pas ou que les dépendances ne correspondent pas après les mises à jour du système d’exploitation, d’OpenSSL ou de l’architecture. Ce problème se produit en raison de binaires Dispatcher incompatibles avec les bibliothèques système, d’une sélection de module incorrecte ou d’une architecture non prise en charge lors des mises à niveau de l’environnement. Pour résoudre le problème, sélectionnez le fichier binaire correct, validez les dépendances et alignez la configuration.

Description description

Environnement

Adobe Experience Manager as a Cloud Service (AEMaaCS)

Problème/Symptômes

  • Le démarrage d’Apache échoue après une mise à niveau en raison de dépendances libssl ou libcrypto manquantes.
  • Le module Dispatcher ne se charge pas ou se charge incorrectement en raison d’une architecture incompatible.
  • L’environnement affiche des erreurs lors de la migration entre les versions OpenSSL, telles que 1.1 à 3.0.
  • Le système présente des incertitudes ou des incohérences pour les versions de système d’exploitation prises en charge, telles que RHEL 8, RHEL 9 ou Amazon Linux 2023.

Cause première

Le problème se produit lorsque le module Dispatcher ne correspond pas à l’environnement système, car il dépend d’une architecture CPU spécifique, de la version OpenSSL, de la version Apache et des bibliothèques au niveau du système d’exploitation. Lorsque l’environnement est mis à niveau ou modifié, le module existant ne parvient pas à se charger en raison de non-correspondances de dépendance, d’une sélection binaire incorrecte ou d’une architecture non prise en charge, telle que ARM64 dans les versions plus anciennes.

Résolution resolution

Pour identifier l’environnement et installer un module Dispatcher compatible, procédez comme suit.

  1. Identifiez l’environnement d’exploitation en vérifiant le système d’exploitation, Apache, l’architecture CPU et les versions OpenSSL à l’aide des commandes système.
  2. Déterminez le bon package Dispatcher en sélectionnant des fichiers binaires en fonction de la version OpenSSL, du système d’exploitation et de l’architecture, tels que ssl1.1, ssl3.0 ou les versions prises en charge par ARM64.
  3. Téléchargez et extrayez le package Dispatcher sur le serveur et vérifiez que le fichier de module est disponible après l’extraction.
  4. Copiez le fichier du module Dispatcher dans le répertoire des modules Apache et assurez-vous que le fichier existe à l’emplacement approprié.
  5. Mettez à jour la configuration Apache en ajoutant la directive LoadModule Dispatcher avec le chemin d’accès au module approprié.
  6. Validez les dépendances de module en vérifiant que toutes les bibliothèques requises sont présentes et correspondent à la version OpenSSL.
  7. Redémarrez Apache et vérifiez que le module Dispatcher se charge correctement sans erreurs de démarrage.
  8. Effacez le cache de Dispatcher après les mises à niveau pour vous assurer que les nouvelles ressources se chargent correctement et éviter les problèmes de contenu obsolètes.
  9. Validez la résolution en exécutant des contrôles de configuration, en vérifiant les journaux, en envoyant des requêtes de test et en confirmant le comportement réussi d’initialisation et de mise en cache du module.

Quand réaffecter

  • Le démarrage du service Apache échoue même après la résolution des dépendances et des problèmes de configuration.
  • Le module Dispatcher se charge mais présente toujours des erreurs de dépendance ou de compatibilité.
  • Le package Dispatcher requis n’existe pas pour le système d’exploitation ou l’architecture cible.
  • L’environnement nécessite des configurations non prises en charge, telles que des versions Dispatcher plus anciennes pour ARM64.

Lecture connexe

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