Vous pouvez diagnostiquer les incidents en cas d'échec de l'installation et de la configuration
de WebSphere ESB.
Pourquoi et quand exécuter cette tâche
Le programme d'installation enregistre les indicateurs de réussite et d'échec suivants à la fin du fichier journal principal :
- INSTCONFSUCCESS: Installation réussie
- INSTCONFPARTIALSUCCESS:
Installation partiellement réussie. Certaines actions d'installation ont échoué mais peuvent être retentées.
- INSTCONFFAILED: Echec de l'installation.
Toute récupération est impossible.
Le fichier journal principal,
log.txt, se trouve sous
racine_install/logs/wbi/install/log.txt sur les plateformes i5/OS, Linux® et UNIX® ou sur les plateformes
racine_install\logs\wbi\install\log.txt sur les plateformesWindows®, où
racine_install représente le répertoire d'installation du produit.
Si le
résultat est INSTCONFPARTIALSUCCESS
ou INSTCONFFAILED, poursuivez
l'analyse de l'incident de la façon suivante. (Pour
savoir comment désinstaller des éléments avant une réinstallation, voir Préparation
de la réinstallation après un échec de désinstallation.)
- Consultez les messages d'erreur éventuels du processus d'installation.
Pour
plus d'explications, voir la rubrique suivante : Messages d'erreur :
Installation, création et augmentation de profils. Si vous trouvez le message qui s'est affiché
dans la liste, corrigez l'incident, nettoyez le
système en supprimant tous les éléments installés
et relancez l'installation.
- Déterminez le produit ayant provoqué l'échec ou le succès partiel. Consultez le fichier install_error.log situé sous le répertoire racine_install/logs/wbi/install sur les plateformes Linux, UNIX et i5/OS ou dans le répertoire install_root\logs\wbi\install\ sur les plateformes Windows. Ce fichier consigne les erreurs, les avertissements et résultats d'installation issus des fichiers journaux concernant l'installation de WebSphere Application
Server Network Deployment, WebSphere Feature
Pack for Web Services et WebSphere ESB. Si la création de profil échoue ou ne réussit que partiellement au cours d'une installation, les résultats sont extraits de fichiers journaux de profil et figurent également dans ce fichier.
Conseil : S'il n'existe aucun fichier dans le répertoire racine_install/logs/wbi/install, l'installation a échoué plus tôt au cours du processus. Reportez-vous fichiers journaux dans rép_principal_utilisateur/wbilogs à la place.
Exécutez l'une des tâches suivantes en fonction du produit ayant été installé de façon non correcte :
- Si WebSphere Application
Server Network Deployment ne s'installe pas correctement, passez à l'étape3.
- Si WebSphere Feature
Pack for Web Services n'a pas été installé correctement (tandis que WebSphere Application Server Network Deployment
a été installé correctement), passez à l'étape 4.
- Si WebSphere ESB n'a pas été installé correctement (tandis que WebSphere Application
Server Network Deployment et WebSphere Feature
Pack for Web Services l'ont été), passez à l'étape 5.
- Si l'installation de WebSphere Application Server Network Deployment a échoué, recherchez des erreurs dans le fichier install_error.log. Si ce fichier ne vous donne pas suffisamment d'informations pour résoudre l'incident, consultez la section consacrée à l'identification des incidents liés à l'installation dans le centre de documentation d'WebSphere Application Server
Network Deployment et utilisez les informations contenues pour corriger l'incident avant d'essayer de réinstaller WebSphere ESB.
Conseil : En cas d'incident au cours de l'installation de WebSphere Application
Server Network Deployment dans le cadre de l'installation de WebSphere ESB, le processus d'installation s'arrête et un message d'erreur s'affiche.
- Si l'installation de WebSphere Feature Pack for Web Services
échoue (et si l'installation de WebSphere Application Server Network Deployment
réussit), recherchez des erreurs dans le fichier install_error.log.
Si ce fichier ne vous donne pas suffisamment d'informations pour résoudre l'incident, consultez la section consacrée à l'identification des incidents liés à l'installation et à la suppression de modules d'extension de serveur Web dans le centre de documentation d'WebSphere Application Server
Network Deployment et utilisez les informations contenues pour corriger l'incident avant d'essayer de réinstaller WebSphere ESB.
Conseil : En cas d'incident au cours d'une installation de WebSphere Feature Pack
for Web Services dans le cadre d'une installation d'un WebSphere ESB, le processus d'installation s'arrête et un message d'erreur s'affiche.
- Si l'installation de WebSphere ESB a échoué (et que l'installation de WebSphere Application Server Network Deployment
et WebSphere Feature
Pack pour Web Services a réussi), recherchez des erreurs dans le fichier install_error.log. Si ce fichier ne vous donne pas suffisamment d'informations pour résoudre l'incident, vérifiez les autres fichiers d'installation de WebSphere ESB. Pour plus d'informations concernant les noms, les emplacements et les descriptions de ces fichiers journaux, voir les Fichiers journaux d'installation et de création de profils. Vérifiez les fichiers journaux dans l'ordre suivant :
Sur les plateformes i5/OS :- fichiers journaux présents dans le répertoire racine_installation/logs/wbi/install
- fichiers journaux présents dans le répertoire répertoire_principal_utilisateur/wbilogs si aucun fichier ne se trouve dans le répertoire racine_installation/logs/wbi/install
- racine_données_utilisateur/profileRegistry/logs/manageprofiles/nom_profil_create_error.log
- racine_données_utilisateur/profileRegistry/logs/manageprofiles/nom_profil_create.log et racine_données_utilisateur/profileRegistry/logs/manageprofiles/pmt.log
- racine_install/logs/wbi/installconfig.log (indique les incidents de configuration qui risquent d'empêcher le produit de fonctionner correctement).
Pour plus d'informations sur le diagnostic des échecs de scripts de configuration,
voir Diagnostic de l'échec d'exécution d'un script de configuration Ant.
- Tout fichier journal ou fichier de trace
supplémentaire généré par l'installation.
Recherchez dans le répertoire racine_installation/logs/wbi/install les fichiers de trace générés pendant le processus d'installation. Recherchez dans racine_données_utilisateur/profileRegistry/logs/manageprofiles/nom_profil ceux ayant été générés par la création ou l'augmentation de profil. (pour plus d'informations
sur les emplacements de racine_installation et racine_données_utilisateur,
voir Répertoires d'installation par défaut du produit, des profils et des outils). Ces fichiers servent en premier lieu à au service d'assistance IBM®.

Sur les plateformes Linux et UNIX : - fichiers journaux présents dans le répertoire racine_installation/logs/wbi/install
- fichiers journaux présents dans le répertoire répertoire_principal_utilisateur/wbilogs si aucun fichier ne se trouve dans le répertoire racine_installation/logs/wbi/install
- racine_install/logs/manageprofiles/nom_profil_create_error.log
- racine_install/logs/manageprofiles/nom_profil_create.log et racine_install/logs/manageprofiles/pmt.log
- racine_install/logs/wbi/installconfig.log (indique les incidents de configuration qui risquent d'empêcher le produit de fonctionner correctement).
Pour plus d'informations sur le diagnostic des échecs de scripts de configuration,
voir Diagnostic de l'échec d'exécution d'un script de configuration Ant.
- Tout fichier journal ou fichier de trace
supplémentaire généré par l'installation.
Recherchez dans le répertoire racine_installation/logs/wbi/install les fichiers de trace générés pendant le processus d'installation. Recherchez dans racine_installation
/logs/manageprofiles/nom_profil les fichiers générés lors
de la création ou l'augmentation de profil. (pour plus d'informations
sur les emplacements de racine_installation et racine_profil,
voir Répertoires d'installation par défaut du produit, des profils et des outils). Ces fichiers servent en premier lieu à au service d'assistance IBM.
Sur les plateformes Windows :- fichiers journaux présents dans le répertoire racine_installation\logs\wbi\install
- fichiers journaux présents dans le répertoire répertoire_installation_utilisateur\wbilogs si aucun fichier ne figure dans install_root\logs\wbi\install
- racine_install\logs\manageprofiles\nom_profil_create_error.log
- racine_install\logs\manageprofiles\nom_profil_create.log et racine_install\logs\manageprofiles\pmt.log
- racine_install\logs\wbi\installconfig.log (indique des incidents de configuration risquant d'empêcher le produit de fonctionner correctement).
Pour plus d'informations sur le diagnostic des échecs de scripts de configuration,
voir Diagnostic de l'échec d'exécution d'un script de configuration Ant.
- Tout fichier journal ou fichier de trace
supplémentaire généré par l'installation.
Recherchez dans le répertoire racine_installation\logs\wbi\install les fichiers de trace générés pendant le processus d'installation. Recherchez dans
racine_installation\logs\manageprofiles\nom_profil
les fichiers générés lors de la création ou l'augmentation de profil. (pour plus d'informations
sur les emplacements de racine_installation et racine_profil,
voir Répertoires d'installation par défaut du produit, des profils et des outils). Ces fichiers servent en premier lieu à au service d'assistance IBM.
- Si les journaux d'erreurs ne contiennent pas les informations nécessaires pour déterminer
l'origine de l'incident, désinstallez le produit et supprimez les fichiers journaux ou tout autre artefact pouvant subsister sur le système, puis activez la fonction de trace et réinstallez le produit.
- Redirigez les données des journaux stdout et stderr vers le panneau de
la console en ajoutant le paramètre -is:javaconsole à la commande install :
- Vous pouvez capturer des informations supplémentaires dans le journal de votre choix en utilisant
l'option -is:log nom_fichier.
- Si la création du profil du serveur
a abouti, utilisez la console Premiers pas
ou la ligne de commande pour démarrer ce serveur.
- Vérifiez que le serveur est démarré et
chargé correctement en recherchant un processus Java™
en cours d'exécution et le message prêt pour l'e-business dans les fichiers
SystemOut.log et SystemErr.log.
Si aucun processus Java n'existe ou si le message n'apparaît pas, recherchez les erreurs diverses dans les mêmes journaux. Corrigez les éventuelles erreurs et réessayez.
Les fichiers
SystemOut.log et
SystemErr.log se
trouvent dans les répertoires suivants :
Sur les plateformes i5/OS : racine_profil/logs/nom_serveur

Sur les plateformes Linux et UNIX : racine_profil/logs/nom_serveur
Sur les plateformes Windows : racine_profil\logs\nom_serveur
- Utilisez la console Premiers pas ou la
ligne de commande pour arrêter le serveur si celui-ci est en cours d'exécution.
- Si vous souhaitez utiliser un Servlet Snoop pour vérifier la capacité du serveur Web
à extraire une application de
WebSphere ESB, voir l'étape "Start the Snoop servlet to verify the ability of the Web
server to retrieve an application from the Application Server (Démarrer le servlet de surveillance pour vérifier la capacité du serveur Web à récupérer une application à partir de Application Server)" de la rubrique
Résolution
des incidents d'installation dans la documentation de
WebSphere
Application Server Network Deployment.
- Démarrez la console d'administration. Pour plus d'informations, reportez-vous à la rubrique Démarrage et arrêt de la console d'administration.
- Pour résoudre les incidents affectant la mise en cache des adresses IP, reportez-vous à l'étape "Resolve any IP address caching problems (résolution des incidents concernant la mise en cache des adresse IP)" de la rubrique Identification des incidents liés à l'installation disponibles dans la documentation de WebSphere Application
Server Network Deployment.
Que faire ensuite
Sur le site Web du support du produit, vous trouverez des informations actualisées sur les incidents recensés et leur résolution, ainsi que des documents peuvent vous aider à trouver plus rapidement les
informations dont vous avez besoin pour résoudre un
incident. Avant d'ouvrir un PMR, consultez la page Web IBM WebSphere ESB Support.