L'outil de collecte regroupe des informations sur votre installation WebSphere
Application Server et les place dans un fichier archive Java™ (JAR) que vous pouvez envoyer au support IBM® pour vous aider à identifier et résoudre un problème.
Les informations du fichier JAR regroupent les journaux, les fichiers de propriétés, les fichiers de configuration, les données de système d'exploitation et les données Java, et les logiciels prérequis ainsi que leurs niveaux.
Avant de commencer
Le tri des informations que vous regroupez n'est pas couramment utilisé. En fait, l'outil de collecte fait un package de ses sorties et les place dans un fichier JAR.
IBM inclut l'outil de collecte dans le code du produit, avec les autres outils qui permettent de capturer les informations à fournir lorsque vous signalez un incident. L'outil de collecte fait partie d'une stratégie visant à rendre le processus de signalement des incidents le plus simple et le exhaustif possible.
L'outil de collecte s'utilise en deux phases.
La première phase consiste à exécuter l'outil de collecte sur votre produit WebSphere
Application Server afin de générer un fichier JAR (Java archive). Le support IBM procède à la seconde étape,
qui consiste à analyser le fichier JAR (Java archive) généré par l'outil de collecte. Le programme de collecte prend fin lors de la création du fichier JAR, en dépit des erreurs éventuellement détectées, relatives par exemple à des fichiers manquants ou à des commandes non valides. L'outil collecte autant de données que possible dans le fichier JAR.
L'outil de collecte est une application Java qui nécessite Java SE Runtime Environment 6 (JRE6)
pour fonctionner.
Pourquoi et quand exécuter cette tâche
Il se trouve dans le répertoire racine d'installation de WebSphere
Application Server, Network Deployment. En revanche, vous l'exécutez à partir d'un répertoire de travail que vous créez en dehors du répertoire racine d'installation.
La procédure ci-après décrit ces deux étapes, ainsi que toutes les autres étapes relatives à l'utilisation de l'outil et à la génération des rapports contenant les résultats obtenus à l'issue de son exécution.
Il existe deux moyens d'exécuter l'outil de collecte.
Exécutez l'outil de collecte pour collecter des données récapitulatives ou pour parcourir le système afin de collecter les fichiers et les résultats de commande pertinents. Cet outil génère un fichier d'archive Java (JAR) contenant les informations requises pour déterminer et résoudre un incident. L'option de résumé permet de collecter
des informations de version ainsi que d'autres données utiles sur lesquelles vous pouvez vous appuyer
pour décrire l'incident au support IBM. Exécutez l'outil de collecte en tant qu'utilisateur root ou administrateur pour accéder aux fichiers système contenant des informations sur les paramètres de noyau, les packages installés et d'autres données vitales.
L'outil collecte des informations sur le profil par défaut si vous n'utilisez pas le paramètre facultatif pour identifier un autre profil.
Procédure
Exécutez l'outil de collecte. - Connectez-vous au système en tant qu'utilisateur root ou administrateur sur une plate-forme Windows.
- Vérifiez que Java 1.2.2 ou une version supérieure est disponible dans le chemin d'accès.
Le programme de collecte requiert l'exécution du code Java. Il collecte également des données sur le programme IBM Developer
Kit, Java Technology
Edition dans lequel il est exécuté.
S'il existe plusieurs kits de développement sur le système, assurez-vous que celui qui est utilisé par le produit WebSphere
Application Server correspond bien à celui qui se trouve dans le chemin du programme de collecte.
Si le kit de développement utilisé par WebSphere
Application Server n'est pas disponible, placez-en un autre dans le chemin du programme de collecte, de manière à pouvoir collecter toutes les données, sauf celles concernant le kit de développement utilisé par WebSphere
Application Server, Network Deployment.
- Assurez-vous que toutes les informations nécessaires figurent dans le chemin utilisé par le programme de collecte et que vous n'exécutez pas le programme à partir du répertoire racine d'installation de WebSphere
Application Server.
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
Vérifiez que le chemin contient les répertoires système suivants :
- /bin
- /sbin
- /usr/bin
- /usr/sbin
Ajoutez regedit dans le chemin.
- Créez un répertoire de travail à partir duquel démarrer le programme de collecte.
- Faites du répertoire de travail votre répertoire de travail en cours.
- Exécutez le programme de collecte en entrant la commande qualifiée complète sur la ligne de commande à partir du répertoire de travail.
- Exécutez la commande suivante à partir de Qshell :
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
app_server_root/bin/collector.sh
![[Windows]](../images/windows.gif)
app_server_root\bin\collector.bat
Utilisez la commande sans aucun paramètre supplémentaire pour regrouper une copie des données de profil et des données de chaque serveur sur le noeud et pour stocker les données dans un seul et même fichier de sortie JAR.
- Utilisez la commande suivante pour regrouper des données à partir d'un profil spécifique qui peut ne pas être le profil par défaut :
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
app_server_root/bin/collector.sh -profileName profile_name
![[Windows]](../images/windows.gif)
app_server_root\bin\collector.bat -profileName profile_name
- Facultatif : Vous pouvez exécuter l'outil de collecte à partir du répertoire bin d'un profil au lieu du répertoire app_server_root/bin/.
Vous devez obtenir la même sortie si vous exécutez l'outil de collecte à partir du répertoire bin de profile_root que celle que vous obtiendriez si vous l'exécutiez à partir du répertoire app_server_root.
L'exécution de la commande à partir du profil déclenche également l'exécution du fichier setupCmdLine.bat/sh dans le répertoire bin du profil. Ce fichier définit un paramètre d'environnement que l'outil de collecte utilise pour déterminer les données du profil à collecter.
Exécutez l'outil de collecte. - Connectez-vous au système avec un profil utilisateur doté du droit spécial *ALLOBJ.
- Créez un répertoire de travail à partir duquel démarrer le programme de collecte.
- Exécutez la commande STRQSH à partir de la ligne de commande CL pour préparer l'exécution du programme de collecte.
- Faites du répertoire de travail votre répertoire de travail en cours.
- Exécutez la commande suivante à partir de Qshell :
cd workingDirectory
Le programme de collecte écrit son fichier JAR de sortie dans le répertoire de travail en cours.
Il crée et supprime également un certain nombre de fichiers temporaires dans le répertoire de travail en cours. La création d'un répertoire de travail pour exécuter le programme de collecte évite les conflits de désignation et facilite le nettoyage. Vous ne pouvez pas exécuter l'outil de collecte dans un répertoire sous le répertoire racine d'installation de WebSphere
Application Server, Network Deployment.
- Exécutez le programme de collecte en entrant la commande qualifiée complète sur la ligne de commande à partir du répertoire de travail.
- Exécutez la commande suivante à partir de Qshell :
app_server_root/bin/collector
- Utilisez la commande suivante pour regrouper des données à partir d'un profil spécifique qui peut ne pas être le profil par défaut :
- Exécutez la commande suivante à partir de Qshell :
app_server_root/bin/collector -profileName profile_name
- Facultatif : Vous pouvez également exécuter l'outil de collecte à partir du répertoire racine du profil au lieu du répertoire app_server_root/bin/.
Exécutez la commande suivante à partir de Qshell :
profile_root/bin/collector
Vous devez obtenir la même sortie si vous exécutez l'outil de collecte à partir du répertoire bin de profile_root que celle que vous obtiendriez si vous l'exécutiez à partir du répertoire app_server_root.
L'exécution de la commande à partir du profil déclenche également l'exécution du fichier setupCmdLine dans le répertoire bin du profil. Ce fichier définit un paramètre d'environnement que l'outil de collecte utilise pour déterminer les données du profil à collecter.
Pour exécuter cette commande pour le gestionnaire de déploiement, par exemple, exécutez ce qui suit à une invite de commande :
app_server_root/profiles/dmgr/bin/collector
où
dmgr est le nom de profil pour le gestionnaire de déploiement.
Résultats
Le programme de collecte crée le fichier journal Collector.log et un fichier JAR de sortie dans le répertoire de travail.
Le nom du fichier JAR se compose du nom d'hôte, du nom de cellule, du nom de noeud et du nom de profil :
host_name-cell_name-node_name-profile_name.JAR
Le fichier journal Collector.log est l'un des fichiers collectés dans le fichier nom_hôte-nom_cellule-nom_noeud-nom_profil.JAR.
Que faire ensuite
Envoyez le fichier
nom_hôte-nom_cellule-nom_noeud-nom_profil.JAR au support IBM pour analyse.