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

Résolution des incidents d'installation

Si un incident survenait lors de l'installation de WebSphere ESB, vous disposez de divers outils et procédures pour le résoudre.

Cette rubrique permet de diagnostiquer les incidents pouvant être à l'origine d'un échec de l'installation. Le programme d'installation ajoute les indicateurs de réussite suivants à la fin du fichier journal principal (racine_installation/logs/wbi/log.txt sous Linux et UNIX, ou racine_installation\logs\wbi\log.txt sous Windows) :
  • INSTCONFSUCCESS: Installation réussie
  • INSTCONFPARTIALSUCCESS: Installation partiellement réussie. Certaines actions de l'installation ont échoué mais peuvent être retentées.
  • INSTCONFFAILED: Echec de l'installation. Toute récupération est impossible.
Si le résultat est INSTCONFPARTIALSUCCESS ou INSTCONFFAILED, poursuivez l'analyse de l'incident de la façon suivante :
  1. Si des messages d'erreurs sont apparus pendant l'installation, reportez-vous à la section Messages d'erreur : Installation, création et augmentation de profils pour obtenir une explication les concernant.

    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.

    Pour savoir comment désinstaller des éléments avant une réinstallation, voir Préparation à la réinstallation après une désinstallation incorrecte.

  2. Déterminez si l'installation de WebSphere Application Server Network Deployment a abouti. Si l'installation de WebSphere ESB a échoué, consultez d'abord le fichier racine_installation/logs/log.txt sous Linux et UNIX, ou le fichier racine_installation\logs\log.txt sous Windows, pour savoir quelles erreurs se sont produites et déterminer si l'installation de WebSphere Application Server Network Deployment a abouti.
    • Si l'installation de WebSphere Application Server Network Deployment a échoué, consultez les informations relatives à la résolution des incidents liés à l'installation pour WebSphere Application Server Network Deployment. Suivez les instructions fournies pour corriger les incidents avant de relancer l’installation de WebSphere ESB.
    • Si l'installation de WebSphere Application Server Network Deployment a abouti alors que celle de WebSphere ESB a échoué, suivez les instructions ci-dessous.
  3. Après l'installation, reportez-vous aux fichiers journaux d'installation de WebSphere ESB pour identifier les erreurs qui se sont produites.

    Voir Fichiers journaux pour connaître le nom, l’emplacement et la description des fichiers journaux créés. Vérifiez les fichiers journaux dans l'ordre suivant :

    LINUX platforms UNIX platforms Sous Linux et UNIX :
    1. racine_installation/logs/wbi ;
    2. %tmp%, si aucun fichier ne se trouve dans le répertoire racine_installation/logs/wbi ;
    3. racine_installation/logs/wasprofile/wasprofile_create_ nom_profil.log ou racine_installation/logs/wasprofile/wasprofile_augment_ nom_profil.log. Si vous avez effectué une installation complète (qui crée un serveur autonome nommé default), la valeur de nom_profil est default.
    4. Tout fichier journal ou fichier de trace supplémentaire généré par l'installation. Recherchez dans le répertoire racine_installation/logs/wbi les fichiers de trace générés lors de l'installation (ou de la désinstallation). Recherchez dans racine_profil/logs les fichiers générés lors de la création ou de l'augmentation des profils (racine_profil représente l'emplacement d'installation du profil WebSphere ESB - par défaut, racine_installation/profiles/nom_profil sous Linux et UNIX). Ces fichiers sont principalement prévus pour être utilisés par le support technique IBM.
    For Windows platforms Sous Windows :
    1. racine_installation\logs\wbi ;
    2. %tmp%, si aucun fichier ne se trouve dans le répertoire racine_installation\logs\wbi ;
    3. racine_installation\logs\wasprofile\wasprofile_create_ nom_profil.log ou racine_installation\logs\wasprofile\wasprofile_augment_ nom_profil.log. Si vous avez effectué une installation complète (qui crée un serveur autonome nommé default), la valeur de nom_profil est default.
    4. Tout fichier journal supplémentaire généré par l'installation. Recherchez dans le répertoire racine_installation\logs\wbi les fichiers de trace générés lors de l'installation (ou de la désinstallation). Recherchez dans racine_profil\logs les fichiers générés lors de la création ou de l'augmentation des profils (racine_profil représente l'emplacement d'installation du profil WebSphere ESB - par défaut, racine_installation\profiles\nom_profil sous Windows). Ces fichiers sont principalement prévus pour être utilisés par le support technique IBM.
  4. Si les journaux d'installation ne contiennent pas d'informations, utilisez le paramètre -log avec un fichier de réponses.
    Certains événements peuvent empêcher ISMP (InstallShield for Multiplatforms) de démarrer l'assistant d'installation (espace disque insuffisant, etc.). Si votre installation échoue et s'il n'y a pas d'informations consignées dans les journaux d'installation, utilisez le paramètre -log avec un fichier de réponses pour enregistrer les entrées concernant les événements ayant provoqué l'échec du lancement de l'assistant d'installation par ISMP. Cette opération fonctionne avec les fichiers de réponses suivants :
    • responsefile.esb.txt
    • responsefile.pcaw.esb.standAloneProfile.txt
    • responsefile.pcaw.esb.dmgrProfile.txt
    • responsefile.pcaw.esb.managedProfile.txt

    Pour plus de détails sur les fichiers de réponses, voir Installation de WebSphere ESB en mode silencieux.

    Pour pouvoir utiliser le fichier de réponses, vous devez le copier du WebSphere ESB CD 1 sur votre disque dur. La syntaxe de la commande install permettant de consigner ces événements est illustrée dans les exemples suivants (les chemins d'accès au fichier de réponses et au journal, ainsi que le nom du fichier de réponses peuvent différer) :

    For AIX platforms Sous AIX :
    install -options "/usr/IBM/WebSphere/silentFiles/myresponsefile.txt" 
            -silent -log # !/usr/IBM/WebSphere/myOptionFiles/log.txt  @ALL
    LINUX platforms Solaris platforms Sous HP-UX, Linux et Solaris :
    install -options "/opt/IBM/WebSphere/silentFiles/myresponsefile.txt" 
            -silent -log # !/opt/IBM/WebSphere/myOptionFiles/log.txt  @ALL
    For Windows platforms Sous Windows :
    install.exe -options "C:\IBM\WebSphere\silentFiles\myresponsefile.txt" 
                -silent -log # !C:\IBM\WebSphere\silentFiles\log.txt  @ALL
  5. Déterminez si l'incident d'installation a été provoqué par l'échec d'un script de configuration.

    Le fichier racine_installation/logs/wbi/instconfig.log (Linux et UNIX) ou racine_installation\logs\wbi\instconfig.log (Windows) contient les incidents de configuration pouvant empêcher le produit de fonctionner correctement. Recherchez la chaîne action failed pour trouver le nom du script ayant échoué.

  6. Vérifiez qu'il n'y a pas de fichiers dans le répertoire racine_installation/classes.

    Le support technique IBM met parfois des travaux en file d'attente pour les clients et fournit des correctifs de test et de débogage. En général, ces correctifs se trouvent dans le répertoire racine_installation/classes.

    Par défaut, le répertoire racine_installation/classes est prioritaire par rapport aux autres classes.

    Le fait de placer un correctif dans le répertoire vous permet de vérifier qu'il corrige effectivement l'incident. Après avoir vérifié que tel est bien le cas, vous devez supprimer le correctif du répertoire racine_installation/classes afin de rétablir le fonctionnement correct du système.

    Si vous ne supprimez pas ces correctifs du répertoire racine_installation/classes, des erreurs peuvent survenir.

  7. 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 élément pouvant subsister sur le système. Ensuite, réinstallez le produit une fois la fonction de trace activée.
    • Redirigez les données des journaux stdout et stderr vers la fenêtre de la console en ajoutant le paramètre -is:javaconsole à la commande install :
      • LINUX platforms UNIX platforms Sous Linux et UNIX :
        install -is:javaconsole
        Capturez le flux dans un fichier à l'aide des commandes suivantes :
        install
        -is:javaconsole > nom_fichier_capture.txt 2>&1
      • For Windows platforms Sous Windows :
        install.exe -is:javaconsole
        Capturez le flux dans un fichier à l'aide des commandes suivantes :
        install.exe
        -is:javaconsole > unité:\nom_fichier_capture.txt
    • Vous pouvez capturer des informations supplémentaires dans le journal de votre choix en utilisant l'option -is:log nom_fichier.
    • Activez la consignation d'informations supplémentaires en ajoutant le paramètre -W Setup.product.install.logAllEvents="true" à la commande install :
      • LINUX platforms UNIX platforms Sous Linux et UNIX :
        install -W Setup.product.install.logAllEvents="true"
      • For Windows platforms Sous Windows :
        install.exe -W Setup.product.install.logAllEvents="true"
  8. 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.
    Démarrez la console Premiers pas pour un noeud donné (racine_profil représente l'emplacement d'installation du profil WebSphere ESB - par défaut, racine_installation/profiles/nom_profil sous Linux et UNIX et racine_installation\profiles\nom_profil sous Windows) :
    • LINUX platforms UNIX platforms Sous Linux et UNIX : racine_profil/firststeps/esb/firststeps.sh
    • For Windows platforms Sous Windows : racine_profil\firststeps\esb\firststeps.bat
    Démarrez le serveur à partir de la ligne de commande :
    1. Accédez au répertoire racine_profil/bin du profil.
    2. Démarrez le processus serveur.
      • LINUX platforms UNIX platforms Sous Linux et UNIX : ./startServer.sh nom_serveur
      • For Windows platforms Sous Windows : startServer.bat nom_serveur
  9. 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.

    S'il n'existe pas de processus Java ou si ce message n'apparaît pas, examinez ces mêmes fichiers journaux pour voir si des erreurs se sont produites. Corrigez les erreurs éventuelles et faites une nouvelle tentative.

    Les fichiers SystemOut.log et SystemErr.log se trouvent dans les répertoires suivants :
    • LINUX platforms UNIX platforms Sous Linux et UNIX : racine_profil/logs/nom_serveur
    • For Windows platforms Sous Windows : racine_profil\profiles\logs\nom_serveur
  10. Utilisez la console Premiers pas ou la ligne de commande pour arrêter le serveur nom_serveur s'il est en cours d'exécution et pour démarrer le gestionnaire de déploiement, s'il en existe un.
    Pour arrêter nom_serveur à partir de la ligne de commande :
    • LINUX platforms UNIX platforms Sous Linux et UNIX : racine_profil/bin/stopServer.sh nom_serveur
    • For Windows platforms Sous Windows : racine_profil\bin\stopServer.bat nom_serveur
    Si vous activez la sécurité, spécifiez les paramètres -user et -password dans la commande.
    Pour démarrer le gestionnaire de déploiement à partir de la ligne de commande :
    • LINUX platforms UNIX platforms Sous Linux et UNIX : racine_profil/bin/startManager.sh
    • For Windows platforms Sous Windows : racine_profil\bin\startManager.bat
  11. Vérifiez que le serveur est démarré et chargé correctement en recherchant un processus Java en cours d'exécution et le message Serveur dmgr prêt pour l'e-business dans le fichier racine_profil/logs/nom_serveur/SystemOut.log.
    LINUX platforms UNIX platforms Sous Linux et UNIX : Ouvrez une fenêtre de commande et lancez la commande top pour afficher les processus en cours. Si cette commande n'est pas disponible sur le système, utilisez la commande ps :
    ps -ef | grep java

    For Windows platforms Sous Windows : Appuyez sur Ctrl+Alt+Suppr et tapez T pour ouvrir le gestionnaire de tâches. Cliquez sur l'onglet Processus et sur l'en-tête Nom de l'image pour trier cette colonne dans l'ordre alphabétique. Recherchez des processus java.exe.

    S'il n'existe pas de processus Java ou si ce message n'apparaît pas, examinez ces mêmes fichiers journaux pour voir si des erreurs se sont produites. Corrigez les erreurs éventuelles et essayez de démarrer le gestionnaire de déploiement.

Pour afficher les informations les plus récentes du service de support IBM sur les incidents recensés et leur résolution, reportez-vous à la page du support IBM WebSphere ESB.


Task topic

Conditions d'utilisation | Evaluez cette page

Timestamp iconDernière révision :
../timestamp 4 Mar 2006 http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/index.jsp?topic=/com.ibm.websphere.wesb.doc.nl1_6.0.1\doc\tins_trouble.html

(C) Copyright IBM Corporation 2006. All Rights Reserved. Copyright IBM France, 2006. Tous droits réservés.
Ce centre de documentation a été réalisé grâce à la technologie Eclipse. (http://www.eclipse.org)