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

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

Pourquoi et quand exécuter cette tâche

La commande server dump est utile pour diagnostiquer les éventuels problèmes d'un serveur de profil 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
[Mise à jour - Septembre 2013]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 Options de la commande server. 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
[Mise à jour - Septembre 2013]

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.
      • Pour plateformes répartiesPour plateformes IBM i
        server dump nom_serveur --archive=nom_fichier_package.dump.zip --include=segment de mémoire
        [Mise à jour - Septembre 2013]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}.[Mise à jour - Septembre 2013]

      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.
      • Pour plateformes répartiesPour plateformes IBM i
        server javadump nom_serveur --include=segment de mémoire

      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

Dispositions pour les centres de documentation | Commentaires


Icône d'horodatage Dernière mise à jour: Wednesday, 2 September 2015
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-libcore-mp&topic=twlp_setup_dump_server
Nom du fichier : twlp_setup_dump_server.html