Génération d'un cliché de serveur Liberty depuis la ligne de commande

Depuis la ligne de commande, vous pouvez utiliser la commande server dumpou server javadump pour capturer des informations de statut pour un serveur Liberty.

Pourquoi et quand exécuter cette tâche

La commande server dump est utile pour diagnostiquer les éventuels problèmes d'un serveur Liberty car le fichier de résultats contient la configuration de serveur, des informations de journalisation et des détails sur les applications déployées dans le répertoire workarea. Cette commande peut être appliquée aussi bien à un serveur en fonctionnement qu'à un serveur arrêté.

Dans le cas d'un serveur en fonctionnement, les informations suivantes sont également capturées :
  • L'état de chaque bundle OSGi sur le serveur
  • Les informations de connexion pour chaque bundle OSGi sur le serveur
  • La liste des composants gérée par l'environnement SCR (Service Component Runtime)
  • Des informations détaillées sur chaque composant, fournies par le service SCR
  • Les données d'administration de la configuration de chaque bundle OSGi
  • Des informations sur les services OSGi enregistrés
  • Les paramètres de l'environnement d'exécution, tels que la machine virtuelle Java™, la taille de segment de mémoire, le système d'exploitation, des informations sur les unités d'exécution et le statut du réseau
La commande server javadump est utile pour diagnostiquer les éventuels problèmes au niveau de la machine virtuelle Java, tels que les unités d'exécution bloquées, les interblocages, l'utilisation excessive du processeur, la consommation excessive de mémoire, les fuites de mémoire et les incidents sur la machine virtuelle. La commande ne peut être utilisée que sur un serveur en opération. Chaque type de cliché crée un fichier, mais certains types de cliché ne sont pas pris en charge par diverses machines virtuelles. Voir Option de commande serveur. Le répertoire par défaut des fichiers de cliché est ${rép.sortie.serveur}. Pour en définir un autre, vous devez utiliser la machine virtuelle (JVM) IBM® et définir les variables d'environnement suivantes :
  • IBM_HEAPDUMPDIR
  • IBM_COREDIR
  • IBM_JAVACOREDIR

Procédure

  1. Ouvrez une ligne de commande et placez-vous dans le répertoire wlp/bin.
  2. Capturez les informations de statut à l'aide d'un des outils de ligne de commande suivants. Si vous n'indiquez pas de nom de serveur, defaultServer est utilisé.
    • Pour créer un instantané du statut du serveur, utilisez la commande serverdump.
      • For distributed platformsFor IBM i platforms
        server dump server_name --archive=package_file_name.dump.zip --include=heap
        nom_fichier_package.dump.zip est un nom de fichier de votre choix. Ce nom de fichier peut inclure un chemin d'accès complet. Si le chemin d'accès complet est omis, un fichier compressé nommé nom_fichier_package.dump.zip est créé sous le répertoire par défaut ${rép_sortie_serveur}.

      Le paramètre --include est facultatif. Vous pouvez demander des types de cliché de mémoire supplémentaires. Par exemple, l'option --include=heap demande un cliché de tas ; l'option --include=thread,heap,system demande un cliché de l'unité d'exécution, un cliché de tas et un vidage système.

    • Pour créer un instantané du statut de la machine virtuelle Java, utilisez la commande server javadump.
      • For distributed platformsFor IBM i platforms
        server javadump server_name --include=heap

      Le paramètre --include est facultatif. Vous pouvez demander des types de cliché de mémoire supplémentaires. Par exemple, l'option --include=heap demande un cliché de segment de mémoire ; l'option --include=heap,system demande un cliché de segment de mémoire et un vidage système. Les fichiers de sortie sont créés sous le répertoire par défaut ${rép_sortie_serveur}. Pour définir un répertoire par défaut différent, vous devez utiliser une machine virtuelle Java (JVM) IBM et configurer les variables d'environnement IBM_HEAPDUMPDIR, IBM_COREDIR et IBM_JAVACOREDIR.

    Remarque : Le fichier qui en résulte est créé avec le codage UTF-8 pour les noms d'entrée ; par conséquent, l'outil que vous utilisez pour ouvrir le fichier doit être capable d'utiliser le codage UTF-8 pour les noms d'entrée. La commande jar fournie dans les SDK Java utilise ce format.

Résultats

Si le serveur spécifié n'existe pas, la commande échoue. Si le serveur spécifié existe, un fichier de résultats contenant les informations de statut du serveur est créé.

Icône indiquant le type de rubrique Rubrique Tâche

Nom du fichier : twlp_setup_dump_server.html