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 :
- Lancez le programme de désinstallation de Database Loader et supprimez la base de données.
- 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 :
- AIX : Le répertoire root ou le répertoire usr/lib/objrepos
- Linux : Le répertoire /root
- Windows : Le répertoire d'installation du système d'exploitation, tel que C:\WINNT ou C:\windows.
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 :
- 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.
- 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.
- 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.
- 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.
- Pour WBI Connect v4.2.2 et ultérieur, recherchez "wbic" dans le fichier
(non sensible à la casse). "wbic" est l'abréviation commune de ces versions et
une partie du nom du répertoire d'installation par défaut.
- Pour WebSphere Partner Gateway V6.0 et supérieur, recherchez "bcg" dans le fichier (non sensible à la casse).
- Supprimez chaque ligne complète représentant un produit ou un composant qui n'est plus installé.
- Enregistrez et fermez le fichier vpd.properties.
AIX
- Nettoyez vpd.properties de la façon indiquée ci-dessus.
- 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
- Supprimez chaque nom de module retourné par l'étape 2 en exécutant la commande geninstall -u.
- 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
- Nettoyez vpd.properties de la façon indiquée ci-dessus.
- 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
- 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
- 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
- Nettoyez vpd.properties de la façon indiquée ci-dessus.
- 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
- Supprimez chaque nom de module retourné par l'étape 2 en exécutant la commande geninstall -u.
- Accédez au répertoire dans lequel sont enregistrées les informations sur le module.
cd /var/sadm/pkg
- Exécutez la commande pkgrm -n sur chaque nom de module à supprimer. Par exemple :
ls |grep -i wbic | xargs -i pkgrm -n {}
- 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
- Nettoyez vpd.properties de la façon indiquée ci-dessus.
- Par précaution, faites une sauvegarde du registre Windows à l'aide du programme
regback.exe à partir du Windows Resource Kit.
- Utilisez regedit.exe pour rechercher et supprimer les clés des versions qui ne sont
plus installées sous les clés suivantes :
- HKEY_LOCAL_MACHINE\Software\IBM
- HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\
CurrentVersion\Uninstall\
