WebSphere Enterprise Service Bus, Version 6.2.0 Systèmes d'exploitation: AIX, HP-UX, i5/OS, Linux, Solaris, Windows


Identification des incidents d'installation et de configuration

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 plateformesracine_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.)

Procédure
  1. 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.

  2. 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.
  3. 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.
  4. 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.
  5. 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 :
    For i5/OS operating system Sur les plateformes i5/OS :
    1. fichiers journaux présents dans le répertoire racine_installation/logs/wbi/install
    2. 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
    3. racine_données_utilisateur/profileRegistry/logs/manageprofiles/nom_profil_create_error.log
    4. racine_données_utilisateur/profileRegistry/logs/manageprofiles/nom_profil_create.log et racine_données_utilisateur/profileRegistry/logs/manageprofiles/pmt.log
    5. 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.
    6. 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®.
    For Linux operating systemFor UNIX operating system Sur les plateformes Linux et UNIX :
    1. fichiers journaux présents dans le répertoire racine_installation/logs/wbi/install
    2. 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
    3. racine_install/logs/manageprofiles/nom_profil_create_error.log
    4. racine_install/logs/manageprofiles/nom_profil_create.log et racine_install/logs/manageprofiles/pmt.log
    5. 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.
    6. 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.
    For Windows operating system Sur les plateformes Windows :
    1. fichiers journaux présents dans le répertoire racine_installation\logs\wbi\install
    2. fichiers journaux présents dans le répertoire répertoire_installation_utilisateur\wbilogs si aucun fichier ne figure dans install_root\logs\wbi\install
    3. racine_install\logs\manageprofiles\nom_profil_create_error.log
    4. racine_install\logs\manageprofiles\nom_profil_create.log et racine_install\logs\manageprofiles\pmt.log
    5. 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.
    6. 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.
  6. 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 :
      • For i5/OS operating system Sur les plateformes i5/OS :
        install -is:javaconsole
        Capturez le flux dans un fichier à l'aide des commandes suivantes :
        install -is:javaconsole >
        NomFichierCapture.txt 2>&1
      • For Linux operating systemFor UNIX operating system Sur les plateformes Linux et UNIX :
        install -is:javaconsole
        Capturez le flux dans un fichier à l'aide des commandes suivantes :
        install -is:javaconsole >
        NomFichierCapture.txt 2>&1
      • For Windows operating system Sur les plateformes Windows :
        install.exe -is:javaconsole
        Capturez le flux dans un fichier à l'aide des commandes suivantes :
        install.exe -is:javaconsole > drive:\captureFileName.txt
    • Vous pouvez capturer des informations supplémentaires dans le journal de votre choix en utilisant l'option -is:log nom_fichier.
  7. 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.
  8. 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 :
    • For i5/OS operating system Sur les plateformes i5/OS : racine_profil/logs/nom_serveur
    • For Linux operating systemFor UNIX operating system Sur les plateformes Linux et UNIX : racine_profil/logs/nom_serveur
    • For Windows operating system Sur les plateformes Windows : racine_profil\logs\nom_serveur
  9. Utilisez la console Premiers pas ou la ligne de commande pour arrêter le serveur si celui-ci est en cours d'exécution.
  10. 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.
  11. Démarrez la console d'administration. Pour plus d'informations, reportez-vous à la rubrique Démarrage et arrêt de la console d'administration.
  12. 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.


task Rubrique relative à une tâche

Conditions d'utilisation | Commentaires en retour


Icône d'horodatage Dernière mise à jour: 07 juillet 2010


http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r2mx/topic//com.ibm.websphere.wesb620.doc/doc/tins_trouble.html
Copyright IBM Corporation 2005, 2010. All Rights Reserved.
Ce centre d'information est mis en service par la technologie Eclipse (http://www.eclipse.org).