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


Commande installver_wbi

Utilisez la commande installver_wbi pour calculer la somme de contrôle des fichiers installés et la comparer à la nomenclature fournie avec le produit.

Fonction

La commande installver_wbi effectue deux fonctions principales. Elle calcule une somme de contrôle des fichiers installés et la compare à la nomenclature du produit. La commande installver_wbi permet également de calculer une somme de contrôle de référence pour chaque fichier de l'inventaire d'un système configuré afin d'identifier les changements de fichiers lors de comparaisons ultérieures.

Le fichier journal par défaut est le fichier racine_installation/logs/installver.log. Vous pouvez rediriger la sortie à l'aide du paramètre -log et d'un argument. Utilisez le paramètre -log sans l'argument de fichier afin de générer le fichier journal par défaut.

Calcul de la somme de contrôle : La commande installver_wbi calcule la somme de contrôle pour chaque fichier installé. Elle compare chaque total de contrôle calculé à la somme de contrôle appropriée pour le fichier. Les sommes de contrôle adéquates figurent dans les fichiers de nomenclature. Un fichier de nomenclature est associé à chaque composant.

L'outil analyse le fichier de nomenclature de chaque composant à la recherche de la somme de contrôle adéquate. Chaque fichier produit est répertorié dans un fichier de nomenclature. L'entrée d'un fichier produit indique le chemin d'accès de celui-ci et la valeur de somme de contrôle appropriée.

Fichiers de nomenclature fournis : Chaque fichier de nomenclature s'appelle files.list. Chaque composant possède un seul fichier files.list. Chaque fichier files.list est enregistré dans l'un des répertoires racine_installation/properties/version/nif/backup/nom_composant. Un répertoire nom_composant existe pour chaque composant.

Par exemple, le fichier files.list du composant activity se trouve dans le répertoire racine_installation/properties/version/nif/backup/nom_composant. Ce fichier est similaire à l'exemple suivant :

<?xml version="1.0" encoding="UTF-8"?>

<componentfiles componentname="activity">
       <file>
              <relativepath>properties/version/activity.component</relativepath>
              <checksum>1a20dc54694e81fccd16c80f7c1bb6b46bba8768</checksum>
              <permissions>644</permissions>
              <installoperation>remove</installoperation>
       </file>
       <file>
              <relativepath>lib/activity.jar</relativepath>
              <checksum>2f056cc01be7ff42bb343e962d26328d5332c88c</checksum>
              <permissions>644</permissions>
              <installoperation>remove</installoperation>
       </file>
</componentfiles>

Comparaison de la somme de contrôle calculée avec la somme de contrôle correcte : Alors qu'il traite chaque fichier produit dans chaque fichier de nomenclature, l'outil calcule également la valeur de somme de contrôle réelle du fichier produit installé. Il compare ensuite la somme de contrôle du fichier produit avec la valeur de somme de contrôle correcte du fichier de nomenclature. L'outil signale ensuite les différences éventuelles.

Emplacement du fichier de commandes :

Le fichier de commandes installver_wbi se trouve dans le sous-répertoire bin du répertoire principal d'installation :
  • For i5/OS operating system Sur les plateformes i5/OS : racine_installation/bin/installver_wbi
  • For Linux operating systemFor UNIX operating system Sous Linux® et UNIX® : racine_installation/bin/installver_wbi.sh
  • For Windows operating system Sous Windows® : racine_installation\bin\installver_wbi.bat
Accédez au sous-répertoire bin pour lancer l'outil installver_wbi à partir de la ligne de commande. L'outil s'exécute sur n'importe quel système d'exploitation à l'exception de z/OS. Pour démarrer l'outil sous Linux ou UNIX, par exemple, utilisez la commande suivante :
./installver_wbi.sh
For i5/OS operating system Remarque : Sous i5/OS vous devez appeler QShell à l'aide de la commande QSH ou STRQSH sur la fenêtre de commande i5/OS native pour pouvoir exécute ces scripts.

Syntaxe d'affichage d'informations sur l'utilisation de la commande

  • For i5/OS operating system Sur les plateformes i5/OS : ./installver_wbi -help
  • For Linux operating systemFor UNIX operating system Sous Linux et UNIX : ./installver_wbi.sh -help
  • For Windows operating system Sous Windows : installver_wbi.bat -help

Syntaxe d'affichage de tous les composants

  • For i5/OS operating system Sur les plateformes i5/OS : ./installver_wbi -listcomponents
  • For Linux operating systemFor UNIX operating system Sur les plateformes Linux et UNIX : ./installver_wbi.sh -listcomponents
  • For Windows operating system Sur les plateformes Windows : installver_wbi.bat -listcomponents

Syntaxe de comparaison des fichiers produit avec les fichiers de nomenclature

A l'aide de la syntaxe de commande suivante, comparez automatiquement la nomenclature et le système de fichiers installés.

  • For i5/OS operating system Sur les plateformes i5/OS : racine_installation/bin/installver_wbi
  • For Linux operating systemFor UNIX operating system Sous Linux et UNIX : racine_installation/bin/installver_wbi.sh
  • For Windows operating system Sous Windows : racine_installation\bin\installver_wbi.bat

Pour consulter des exemples montrant comment comparer les fichiers installés aux fichiers de nomenclature du produit au moyen de la commande, voir Vérification par rapport à la nomenclature.

Exemples de comparaisons et d'utilisation de commandez

Comparez des sommes de contrôle et incluez uniquement les fichiers spécifiés dans la comparaison d'inventaire :
  • For i5/OS operating system Sur les plateformes i5/OS : ./installver_wbi -include fn1;fn2;fn3
  • For Linux operating systemFor UNIX operating system Sur les plateformes Linux et UNIX : ./installver_wbi.sh -include fn1;fn2;fn3
  • For Windows operating system Sur les plateformes Windows : installver_wbi.bat -include fn1;fn2;fn3

Pour consulter des exemples montrant comment comparer au moyen de la commande uniquement des fichiers ou des composants que vous spécifiez, voir Comparaison des sommes de contrôle des fichiers et composants spécifiques.

Comparez des sommes de contrôle et incluez uniquement les composants spécifiés dans la comparaison d'inventaire :
  • For i5/OS operating system Sur les plateformes i5/OS : ./installver_wbi -includecomponent comp1;comp2;comp3;...
  • For Linux operating systemFor UNIX operating system Sur les plateformes Linux et UNIX : ./installver_wbi.sh -includecomponent comp1;comp2;comp3;...
  • For Windows operating system Sur les plateformes Windows : installver_wbi.bat -includecomponent comp1;comp2;comp3;...
Comparez des sommes de contrôle et excluez certains composants de la comparaison :
  • For i5/OS operating system Sur les plateformes i5/OS : ./installver_wbi -excludecomponent comp1;comp2;comp3;...
  • For Linux operating systemFor UNIX operating system Sur les plateformes Linux et UNIX : ./installver_wbi.sh -excludecomponent comp1;comp2;comp3;...
  • For Windows operating system Sur les plateformes Windows : installver_wbi.bat -excludecomponent comp1;comp2;comp3;...

Pour consulter des exemples montrant comment exclure des fichiers de la comparaison au moyen de la commande, voir Exclusion de fichiers d'une comparaison de sommes de contrôle.

Comparez des sommes de contrôle et ignorez les fichiers exclus par l'utilisateur :
  • For i5/OS operating system Sur les plateformes i5/OS : ./installver_wbi -ignoreuserexclude
  • For Linux operating systemFor UNIX operating system Sur les plateformes Linux et UNIX : ./installver_wbi.sh -ignoreuserexclude
  • For Windows operating system Sous Windows : installver_wbi.bat -ignoreuserexclude
Comparez des sommes de contrôle et ignorez les fichiers exclus par IBM :
  • For i5/OS operating system Sur les plateformes i5/OS : ./installver_wbi -ignoreibmexclude
  • For Linux operating systemFor UNIX operating system Sous Linux et UNIX : ./installver_wbi.sh -ignoreibmexclude
  • For Windows operating system Sous Windows : installver_wbi.bat -ignoreibmexclude
Dressez la liste de tous les composants uniquement :
  • For i5/OS operating system Sur les plateformes i5/OS : ./installver_wbi -listcomponents
  • For Linux operating systemFor UNIX operating system Sur les plateformes Linux et UNIX : ./installver_wbi.sh -listcomponents
  • For Windows operating system Sur les plateformes Windows : installver_wbi.bat -listcomponents
Créez un modèle (pour afficher la liste des fichiers exclus) :
  • For i5/OS operating system Sur les plateformes i5/OS : ./installver_wbi -createtemplate
  • For Linux operating systemFor UNIX operating system Sous Linux et UNIX : ./installver_wbi.sh -createtemplate
  • For Windows operating system Sur les plateformes Windows : installver_wbi.bat -createtemplate

Paramètres de comparaison des sommes de contrôle avec la nomenclature

Les paramètres suivants sont associés à la commande lors de la comparaison de sommes de contrôle de fichier produit avec les sommes de contrôle appropriées des fichiers de nomenclature.

-componentdir répertoire_1;répertoire_2;répertoire_n
Paramètre facultatif identifiant le nom du répertoire dans lequel les produits WebSphere Application Server stockent les listes de nomenclature individuelles de chaque composant.

La valeur par défaut est le répertoire racine_installation/properties/version/nif/backup.

-createtemplate [nom_fichier ]
Crée un fichier modèle de propriétés pour l'exclusion de fichiers d'une comparaison de sommes de contrôle. Editez ce fichier pour ajouter une ligne correspondant à chaque fichier à exclure de la vérification.

Sans argument de spécification de fichier, l'outil 'installver_wbi' crée le fichier racine_installation/properties/ivu_user.template.

Si vous indiquez un nom de fichier, l'outil installver_wbi crée le fichier dans le répertoire de travail, qui correspond au répertoire racine_installation/profiles/nom_profil/bin par défaut.

  • For i5/OS operating system Sur les plateformes i5/OS : entrez la commande suivante :
    1. cdracine_installation/bin
    2. ./installver_wbi -createtemplate
  • For Linux operating systemFor UNIX operating system Sur les plateformes Linux et UNIX : entrez la syntaxe suivante sur une ligne de commande :
    1. cdracine_installation/bin
    2. ./installver_wbi.sh -createtemplate
  • For Windows operating system Sur les plateformes Windows : entrez la commande suivante :
    1. cdracine_installation\bin
    2. installver_wbi.bat -createtemplate

L'outil installver_wbi crée le fichier modèle de propriétés dans le répertoire properties du profil par défaut :

  • For i5/OS operating system Sur les plateformes i5/OS : racine_profil_par_défaut/properties/ivu.user.template
  • For Linux operating systemFor UNIX operating system Sur les plateformes Linux et UNIX : racine_profil_par_défaut/properties/ivu.user.template
  • For Windows operating system racine_profil_par_défautWindows : racine_profil_par_défaut\properties\ivu.user.template
-exclude fichier1;fichier2;fichier3; ...
Exclut des fichiers de la vérification.

Utilisez le point-virgule (;) ou le signe deux-points (:) comme délimiteur des noms de fichier.

-excludecomponent composant1;composant2;composant3; ...
Exclut des composants de la vérification.

Utilisez le point-virgule (;) ou le signe deux-points (:) comme délimiteur des noms de composant.

-filelist nom_fichier
Paramètre facultatif identifiant le nom du fichier utilisé par IBM® pour identifier les sommes de contrôle adéquates de fichiers produit d'un composant particulier.

La valeur par défaut est files.list.

-help

Affiche des informations sur la syntaxe.

-ignoreuserexclude

Ignore le fichier par défaut racine_installation/properties/ivu_user.template, s'il existe, puis compare les fichiers répertoriés dans le modèle.

Si vous utilisez le paramètre -createtemplate en spécifiant un fichier afin de créer le modèle dans un autre emplacement, le paramètre -ignoreusertemplate n'a pas d'effet.

-ignoreibmexclude

Compare les sommes de contrôle pour tous les fichiers du répertoire principal d'installation. Par défaut, IBM indique certains fichiers à exclure de la vérification. Vous pouvez associer le paramètre -ignoreibmexclude à l'outil installver_wbi pour que ces fichiers soient vérifiés.

-include fichier1;fichier2;fichier3; ...
Inclut des fichiers dans la vérification et exclut tous les autres.

Utilisez le point-virgule (;) ou le signe deux-points (:) comme délimiteur des noms de fichier.

-includecomponent composant1;composant2;composant3; ...
Inclut des composants dans la vérification et exclut tous les autres.

Utilisez le point-virgule (;) ou le signe deux-points (:) comme délimiteur des noms de composant.

-installroot nom_répertoire
Remplace le répertoire principal d'installation par défaut.
-listcomponents

Affiche la liste de composants du produit. Chaque composant doit posséder un fichier files.list.

-log [chemin_et_nom_fichier_journal]

Le fichier journal par défaut est le fichier racine_installation/logs/installver.log. Vous pouvez rediriger la sortie à l'aide du paramètre -log et d'un argument.

-profilehome nom_répertoire
Remplace le répertoire des profils par défaut dans le répertoire principal d'installation.
-trace

Fournit une sortie de trace des éléments vérifiés et détectés par l'outil.

Syntaxe de création et d'utilisation d'une nouvelle somme de contrôle pour un inventaire de fichiers configurés

A l'aide de la syntaxe suivante, créez et comparez un inventaire de fichiers configurés avec des fichiers installés.

Créez la liste d'inventaire des fichiers actuellement installés dans le répertoire principal d'installation :
  • For i5/OS operating system Sur les plateformes i5/OS : ./installver_wbi -createinventory [chemin_accès/nom_fichier], tel que ./installver_wbi -createinventory /tmp/system.inv
  • For Linux operating systemFor UNIX operating system Sur les plateformes Linux et UNIX : ./installver_wbi.sh -createinventory [chemin d'accès/nom de fichier], tel que ./installver_wbi.sh -createinventory /tmp/system.inv
  • For Windows operating system Sur les plateformes Windows : installver_wbi.bat -createinventory [chemin d'accès/nom de fichier], tel que installver_wbi.bat -createinventory C:\temp\system.inv
Comparez la liste d'inventaire avec les fichiers actuellement installés dans le répertoire principal d'installation :
  • For i5/OS operating system Sur les plateformes i5/OS : ./installver_wbi.sh -compare /chemin d'accès/nom de fichier
  • For Linux operating systemFor UNIX operating system Sur les plateformes Linux et UNIX : ./installver_wbi.sh -compare /chemin d'accès/nom de fichier
  • For Windows operating system Sur les plateformes Windows : installver_wbi.bat -compare chemin d'accès\nom de fichier
Comparez et affichez les résultats de trace :
  • For i5/OS operating system Sur les plateformes i5/OS : ./installver_wbi -compare /chemin d'accès/nom de fichier -trace
  • For Linux operating systemFor UNIX operating system Sur les plateformes Linux et UNIX : ./installver_wbi.sh -compare /chemin d'accès/nom de fichier -trace
  • For Windows operating system Sur les plateformes Windows : installver_wbi.bat -compare /chemin d'accès/nom de fichier -trace
Affichez les informations relatives à la syntaxe :
  • For i5/OS operating system Sur les plateformes i5/OS : ./installver_wbi -help
  • For Linux operating systemFor UNIX operating system Sous Linux et UNIX : ./installver_wbi.sh -help
  • For Windows operating system Sous Windows : installver_wbi.bat -help
Comparez et excluez les fichiers spécifiés de la comparaison d'inventaire :
  • For i5/OS operating system Sur les plateformes i5/OS : ./installver_wbi.sh -compare /chemin d'accès/nom de fichier -exclude fn1;fn2;fn3;...
  • For Linux operating systemFor UNIX operating system Sur les plateformes Linux et UNIX : ./installver_wbi.sh -compare /chemin d'accès/nom de fichier -exclude fn1;fn2;fn3;...
  • For Windows operating system Sur les plateformes Windows : installver_wbi.bat -compare \chemin d'accès\nom de fichier -exclude fn1;fn2;fn3;...
Comparez et incluez uniquement les fichiers spécifiés dans la comparaison d'inventaire :
  • For i5/OS operating system Sur les plateformes i5/OS : ./installver_wbi -compare /chemin d'accès/nom de fichier -include fn1;fn2;fn3;...
  • For Linux operating systemFor UNIX operating system Sur les plateformes Linux et UNIX : ./installver_wbi.sh -compare /chemin d'accès/nom de fichier -include fn1;fn2;fn3;...
  • For Windows operating system Sur les plateformes Windows : installver_wbi.bat -compare /chemin d'accès/nom de fichier -include fn1;fn2;fn3;...

Paramètres de création et d'utilisation de sommes de contrôle pour un inventaire de fichiers

Les paramètres ci-dessous sont associés à cette commande.

-compare nom_chemin_d'accès_et_fichier_inventaire_existant
Compare la liste d'inventaire existant avec les fichiers existants pour identifier les modifications.

Utilisez tout d'abord le paramètre -createinventory pour créer une liste d'inventaire. Utilisez ensuite le paramètre -compare pour comparer la liste d'inventaire avec les fichiers existant dans le système au moment de la comparaison.

Le résultat de la comparaison signale les classes modifiées, les fichiers modifiés, les fichiers modifiés et les fichiers ajoutés. Une telle comparaison est très utile pour la vérification de l'absences de fichiers de virus, par exemple.

-createinventory nom_répertoire
Crée la nouvelle somme de contrôle par défaut dans le fichier sys.inv du répertoire de travail en cours, tel que le répertoire racine_profil/bin. Vous pouvez indiquer un chemin d'accès et un nom de fichier. Créez le fichier en dehors du répertoire principal d'installation ou excluez le fichier des comparaisons.

Vous pouvez faire pointer l'outil installver_wbi sur n'importe quel répertoire. Le répertoire par défaut est le répertoire principal d'installation.

Vous pouvez exclure des fichiers ou des composants de l'inventaire.

L'outil installver_wbi calcule une somme de contrôle pour chaque fichier. Chaque entrée de fichier de l'inventaire est semblable au modèle suivant :

somme
de contrôle|chemin
relatif/nom_fichier|taille_fichier|date_dernière_modification

Après avoir créé une liste d'inventaire, utilisez le paramètre -compare pour comparer la liste d'inventaire avec les fichiers existant dans le système au moment de la comparaison.

-exclude fichier1;fichier2;fichier3;...
Exclut des fichiers de la comparaison.

Utilisez le point-virgule (;) ou le signe deux-points (:) comme délimiteur des noms de fichier.

-help
Affiche des informations sur la syntaxe.
-include fichier1;fichier2;fichier3; ...
Inclut des fichiers dans la comparaison et exclut tous les autres.

Utilisez le point-virgule (;) ou le signe deux-points (:) comme délimiteur des noms de fichier.

-installroot nom_répertoire
Remplace le répertoire principal d'installation par défaut.
-log [chemin_et_nom_fichier_journal]

Le fichier journal par défaut est le fichier racine_installation/logs/installver.log. Vous pouvez rediriger la sortie à l'aide du paramètre -log et d'un argument.

-trace
Fournit une sortie de trace des éléments vérifiés et détectés par l'outil.

Exemple

Les exemples ci-dessous illustrent des problèmes pouvant survenir lorsque vous exécutez la commande installver_wbi pour comparer des sommes de contrôle.

Ignorez les entrées correspondant à des sommes de contrôle non concordantes qui ont été introduites délibérément, telles que celle pouvant se produire lors de l'extension d'un composant.

Les sommes de contrôle diffèrent pour chaque fichier que vous modifiez :
I CWNVU0470I: [ivu] Starting to analyze: regularcomponentsample
I CWNVU0440I: [ivu] The following file is different: lib/different.jar
I CWNVU0410I: [ivu] fc19318dd13128ce14344d066510a982269c241b is the checksum in 
  the bill of materials.
I CWNVU0420I: [ivu] 517d5a7240861ec297fa07542a7bf7470bb604fe is the checksum on 
  the file system.
I CWNVU0390I: [ivu] Component issues found : 1
I CWNVU0480I: [ivu] Done analyzing: regularcomponentsample

Ignorer les problèmes signalés par des messages d'informations (I) évidents

Certains messages indiquent des écarts par rapport au résultat normalement attendu, mais ne signalent pas un problème grave :
I CWNVU0360I: [ivu] The following bill of materials issue is found for component
  nullvaluesample: 
  Hash must not be null or an empty string.

Les fichiers qui se chevauchent indiquent un problème potentiel lié au produit ou une contrefaçon éventuelle des nomenclatures fournies par IBM.

I CWNVU0470I: [ivu] Starting to analyze: overlapbinarycomponentsample
W CWNVU0422W: [ivu] The following file is overlapped: lib/binaryTest.jar
W CWNVU0425W: [ivu] The overlap is caused by: _binarycomponentsample
I CWNVU0390I: [ivu] Component issues found : 1
I CWNVU0480I: [ivu] Done analyzing: overlapbinarycomponentsample

Contactez le service de support IBM si vous rencontrez le problème suivant :

Si un message au format suivant s'affiche, contactez le service de support IBM :
W CWNVU0280W: [ivu] Component mismatch: expected ... but found ...

Pour afficher les informations les plus récentes du support technique IBM sur les incidents recensés et leur résolution, consultez la page du support technique IBM.

Le support technique IBM possède des documents permettant de gagner du temps lors de la collecte des informations requises pour résoudre cet incident. Avant d'ouvrir un PMR, reportez-vous à cette page du support technique IBM.

Si votre incident n'est pas recensé ou si les informations fournies ne permettent pas de résoudre l'incident, prenez contact avec le service de support IBM.

Tâche suivante

Une fois votre installation vérifiée, vous pouvez créer des profils ou déployer une application sur un profil existant.


reference Rubrique de référence

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/rins_installver.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).