DocumentationAEM 6.4Guide d’administration

Résolution des incidents liés à AEM troubleshooting-aem

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Admin
CAUTION
AEM 6.4 a atteint la fin de la prise en charge étendue et cette documentation n’est plus mise à jour. Pour plus d’informations, voir notre période de support technique. Rechercher les versions prises en charge here.

La section suivante décrit certains problèmes que vous pouvez rencontrer lors de l’utilisation d’AEM, ainsi que des suggestions pour les résoudre.

NOTE
Si vous résolvez les problèmes liés à la création dans AEM, reportez-vous à la section Résolution des problèmes pour les auteurs.
NOTE
Si vous rencontrez des problèmes, il est également intéressant de consulter la liste des problèmes connus relatifs à votre instance (packs de version et de services).

Scénarios de dépannage pour les administrateurs troubleshooting-scenarios-for-administrators

Le tableau suivant présente un aperçu des problèmes que les administrateurs peuvent avoir à résoudre :

Rôle(s)
Problème
Administrateur système
Lorsque vous double-cliquez sur le fichier Quickstart jar, rien ne se produit ou le fichier s’ouvre dans un autre programme (par exemple, le gestionnaire d’archives).
Administrateur système
Mon application qui s’exécute sur CRX génère des erreurs de mémoire insuffisante.
Administrateur système
Après avoir double-cliqué sur Quickstart CM AEM, l’écran d’accueil d’AEM ne s’affiche pas dans le navigateur

Administrateur système

utilisateur administrateur

Création d’une image mémoire des threads

Administrateur système

utilisateur administrateur

Contrôle des sessions JCR non fermées

Problèmes d’installation installation-issues

Voir Problèmes d’installation courants pour plus d’informations sur les scénarios de dépannage suivants :

  • Double-cliquer sur le fichier Quickstart jar n’a aucun effet sur le fichier JAR avec un autre programme (tel que le gestionnaire d’archives).
  • Les applications s’exécutant sur CRX renvoient des erreurs de mémoire insuffisante.
  • Après avoir double-cliqué sur Quickstart AEM, l’écran d’accueil d’AEM ne s’affiche pas dans le navigateur.

Méthodes d’analyse de dépannage methods-for-troubleshooting-analysis

Créer une image mémoire des threads making-a-thread-dump

L’image mémoire des threads est une liste de toutes les unités d’exécution Java actuellement actives. Si AEM ne répond pas correctement, le thread dump peut vous aider à identifier les blocages ou d’autres problèmes.

Utilisation de Sling Thread Dumper using-sling-thread-dumper

  1. Ouvrez la console web AEM, par exemple, à l’adresse http://localhost:4502/system/console/.

  2. Sélectionnez les threads dans l’onglet Statut.

screen_shot_2012-02-13at43925pm

Utilisation de jstack (ligne de commande) using-jstack-command-line

  1. Recherchez le PID (ID de processus) de l’instance Java AEM.

    Vous pouvez, par exemple, utiliser ps -ef ou jps.

  2. Exécutez :

    jstack <pid>

  3. L’image mémoire des threads s’affiche.

NOTE
Vous pouvez ajouter les images mémoire des threads à un fichier journal en utilisant la redirection de sortie >> :
jstack <pid> >> /path/to/logfile.log

Pour plus d’informations, consultez la section Comment utiliser les images mémoire des threads d’une machine virtuelle Java (JVM).

Contrôle des sessions JCR non fermées checking-for-unclosed-jcr-sessions

Lorsque la fonctionnalité est développée pour AEM WCM, il est possible d’ouvrir des sessions JCR (cela s’apparente à l’ouverture d’une connexion de base de données). Si les sessions ouvertes ne sont jamais fermées, votre système peut présenter les symptômes suivants :

  • Le système devient plus lent.
  • Vous constatez qu’il y a de nombreuses entrées CacheManager: resizeAll dans le fichier journal. Le nombre (size=<x>) ci-dessous affiche le nombre de caches. Chaque session ouvre plusieurs caches.
  • Parfois, la mémoire du système est saturée (après quelques heures, jours ou semaines, selon la gravité).

Pour analyser les sessions non fermées et déterminer le code qui ne ferme pas une session, reportez-vous à l’article de la base de connaissances Analyse des sessions non fermées.

Utilisation de la console web Adobe Experience Manager using-the-adobe-experience-manager-web-console

L’état des lots OSGi peut également donner une indication précoce des problèmes possibles.

  1. Ouvrez la console web AEM, par exemple, à l’adresse http://localhost:4502/system/console/.

  2. Sélectionnez Lots dans l’onglet OSGI.

  3. Vérifier :

    • le statut des lots. Si le statut est Inactif ou Insatisfait, essayez d’arrêter et de redémarrer le lot. Si le problème persiste, vous devrez peut-être approfondir l’enquête en utilisant d’autres méthodes.
    • Si l’un des lots possède des dépendances manquantes. Ces détails sont visibles en cliquant sur le nom du lot individuel, qui est un lien (l’exemple suivant n’a aucun problème) :

screen_shot_2012-02-13at44706pm

recommendation-more-help
5ce3024a-cbea-458b-8b2f-f9b8dda516e8