Identification et résolution des incidents

Les procédures suivantes décrivent comment résoudre les incidents d'installation de WebSphere Partner Gateway.

Ce chapitre comprend les sections suivantes :

Localisation des erreurs de Database Loader

Si vous rencontrez des difficultés lors de l'installation de Database Loader, consultez les journaux de Database Loader dans le répertoire temp/bcgdbloader/logs pour plus d'informations. Une fois le problème résolu, supprimez la base de données créée en procédant comme suit :

  1. Lancez le programme de désinstallation de Database Loader et supprimez la base de données.
  2. Une fois la base de données supprimée, relancez l'assistant de Database Loader.

Si vous rencontrez des difficultés lors de l'installation des composants de WebSphere Partner Gateway, examinez les journaux d'installation de composants suivants :

{INSTALL DIR}/logs/bcgconsole

{INSTALL DIR}/logs/bcgreceiver

{INSTALL DIR}/logs/bcgdocmgr

Consultez également les journaux d'exécution suivants :

Embedded WebSphere Application Server

{INSTALL DIR}was/profiles/bcgconsole/logs

{INSTALL DIR}was/profiles/bcgreceiver/logs

{INSTALL DIR}was/profiles/bcgdocmgr/logs

WebSphere Application Server v6.0

{INSTALL DIR}profiles/bcgconsole/logs

{INSTALL DIR}profiles/bcgreceiver/logs

{INSTALL DIR}profiles/bcgdocmgr/logs

Reprise après un problème de détection de version

L'assistant InstallShield conserve les données sur le produit dans un fichier nommé vpd.properties. Des informations équivalentes sont également conservées dans le registre du système d'exploitation, le cas échéant. Par exemple, RPM sous Linux, lslpp sous AIX et pkginfo sous Solaris.

Ces informations comprennent une clé d'ID unique (UID), les informations version.release et le répertoire installé pour chacun des produits et composants. Ces trois informations constituent une clé logique unique pour chaque entrée.

Les informations sont conservées dans le fichier vpd.properties, le registre du système d'exploitation, ou les deux sont utilisées pour résoudre les erreurs déjà installées. Parfois, les informations du fichier vpd.properties, le registre du système d'exploitation natif ou les deux se désynchronisent et ne représentent plus l'état du système. Ce peut être le cas lorsque un ou plusieurs assistants d'installation ou de désinstallation fonctionnent simultanément. D'autres scénarios peuvent également altérer ces informations.

L'emplacement du fichier vpd.properties varie selon la plateforme d'exploitation :

Les informations ci-dessous vous guideront dans le processus de suppression manuelle des données concernant des produits ou composants qui ne sont plus installés. Le processus est le même pour tous les systèmes d'exploitation :

  1. Avant de continuer, faite une copie de sauvegarde de vpd.properties. Tous les produits qui utilisent les assistants InstallShield MultiPlatform ou InstallShield Universal mettent à jour vpd.properties. L'altération du contenu de vpd.properties peut entraîner l'échec des futures mises à niveau, installations de maintenance et désinstallation.
  2. Ouvrez vpd.properties à l'aide de l'éditeur de votre choix. Si possible, désactivez le line wrap ou utilisez un éditeur qui ne renvoie pas à la ligne.
  3. Chaque ligne de vpd.properties représente un produit ou un composant de produit. La première entrée de la ligne est l'ID unique (UID). Chaque zone de la ligne ("record") est séparée par une barre verticale (|). Les quatre zones suivantes indiquent la version, l'édition, la modification et la mise à jour. Parcourez la ligne pour localiser le chemin d'installation.
  4. A l'aide des informations indiquées à l'étape 3, identifiez manuellement toutes les entrées qui pointent vers les produits/composants qui ne sont plus installés.
  5. Enregistrez et fermez le fichier vpd.properties.

AIX

  1. Nettoyez vpd.properties de la façon indiquée ci-dessus.
  2. Recherchez les entrées qui ne sont plus installées à l'aide de smit ou lslpp. Par exemple, à partir de la ligne de commande, utilisez la commande suivante pour trouver toutes les entrées correspondant à WebSphere Business Integration Connect v4.2.2 et supérieur. Notez les noms qui sont retournés :
    lslpp -l | grep -i wbic
  3. Supprimez chaque nom de module retourné par l'étape 2 en exécutant la commande geninstall -u.
  4. Si la commande geninstall -u ne fonctionne pas, consultez l'assistance AIX pour obtenir des instructions sur le nettoyage manuel du gestionnaire de données d'objet (odm).

Linux

  1. Nettoyez vpd.properties de la façon indiquée ci-dessus.
  2. Dans rpm, recherchez les entrées qui ne sont plus installées à l'aide de l'outil de votre choix. Par exemple, à partir de la ligne de commande, utilisez la commande suivante pour trouver toutes les entrées correspondant à WebSphere Business Integration Connect v4.2.2 et supérieur. Notez les noms de modules retournés :
    rpm -qa |grep -i wbic
  3. Supprimez de rpm chaque nom de module retourné par l'étape 2 en utilisant l'outil de votre choix. Par exemple, à partir de la ligne de commande, utilisez rpm -e
  4. Si la liste ne contient que des modules à supprimer, effacez-les à l'aide de la commande suivante :
    rpm -qa | grep -i wbic | xargs rpm -e

Solaris

  1. Nettoyez vpd.properties de la façon indiquée ci-dessus.
  2. Recherchez les entrées qui ne sont plus installées à l'aide de pkginfo. Par exemple, à partir de la ligne de commande, utilisez la commande suivante pour trouver toutes les entrées correspondant à WebSphere Business Integration Connect v4.2.2 et supérieur. Notez les noms qui sont retournés :
    pkginfo | grep -i wbic
  3. Supprimez chaque nom de module retourné par l'étape 2 en exécutant la commande geninstall -u.
    1. Accédez au répertoire dans lequel sont enregistrées les informations sur le module.
      cd /var/sadm/pkg
    2. Exécutez la commande pkgrm -n sur chaque nom de module à supprimer. Par exemple :
      ls |grep -i wbic | xargs -i pkgrm -n {}
    3. En cas de problème d'exécution de la commande pkgrm -n, essayez de supprimer les répertoires de modules associés et exécutez de nouveau la commande pkgrm -n. Par exemple :
      - rm -rf /var/sadm/pkg/WBICpackageName1/

Windows

  1. Nettoyez vpd.properties de la façon indiquée ci-dessus.
  2. Par précaution, faites une sauvegarde du registre Windows à l'aide du programme regback.exe à partir du Windows Resource Kit.
  3. Utilisez regedit.exe pour rechercher et supprimer les clés des versions qui ne sont plus installées sous les clés suivantes :
    1. HKEY_LOCAL_MACHINE\Software\IBM
    2. HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\
      CurrentVersion\Uninstall\

Copyright IBM Corp. 2003, 2005