WebSphere Enterprise Service Bus バージョン 6.2.0 オペレーティング・システム: AIX、HP-UX、i5/OS、Linux、Solaris、Windows


installver_wbi コマンド

インストール済みのファイルについて検査合計を計算し、その検査合計と提供されている製品の部品表とを比較する場合に、installver_wbi コマンドを使用します。

目的

installver_wbi コマンドは、2 つの主要な機能を実行します。このコマンドは、インストール済みのファイルの検査合計を計算して、その検査合計を提供されている製品の部品表と比較します。 また、installver_wbi コマンドを使用して構成済みのシステムの品目内にある各ファイルごとに新しいベースライン検査合計を計算し、その後の比較処理でファイルの変更点を示すために使用することができます。

デフォルトのログ・ファイルは、install_root/logs/installver.log ファイルです。 -log パラメーターと引数を使用して、出力をリダイレクトすることができます。デフォルトのログ・ファイルを生成する場合は、-log パラメーターをファイル引数なしで使用してください。

検査合計の 計算: installver_wbi コマンドは、製品のインストール済みのファイルごとに検査合計を計算します。このコマンドは、計算した各検査合計をファイルの正しい検査合計と比較します。正しい検査合計は、部品表ファイルとして提供されています。各コンポーネントに、部品表ファイルが 1 つずつ存在します。

このツールは、各コンポーネントの部品表ファイルを解析して、コンポーネントのファイルごとの正しい検査合計値を求めます。どの製品ファイルも、いずれかの部品表ファイルにエントリーがあります。製品ファイルのエントリーには、その製品のファイル・パスと正しい検査合計値がリストされています。

提供されている部品表ファイル: 各部品表ファイルには、files.list という名前が付いています。 各コンポーネントに、files.list ファイルが 1 つずつ存在します。それぞれの files.list ファイルは、いずれかの install_root/properties/version/nif/backup/component_name ディレクトリーの中にあります。コンポーネントごとに component_name ディレクトリーが存在します。

例えば、activity コンポーネント用の files.list ファイルは install_root/properties/version/nif/backup/component_name ディレクトリー内にあります。このファイルの例を以下に示します。

<?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>

計算した検査合計を正しい検査合計と比較: ツールは、各部品表ファイル内の各製品ファイルの処理中に、それに対応するインストール済みの製品ファイルの実際の検査合計値も計算します。この後ツールは、製品ファイルの検査合計を、部品表ファイル内の正しい検査合計値と比較します。ツールは、これに相違点があれば、その相違点を報告します。

コマンド・ファイルのロケーション:

installver_wbi コマンド・ファイルは、インストール・ルート・ディレクトリーの次の bin ディレクトリー内にあります。
  • For i5/OS operating system i5/OS® プラットフォームの場合: install_root/bin/installver_wbi
  • For Linux operating systemFor UNIX operating system Linux® および UNIX® プラットフォームの場合: install_root/bin/installver_wbi.sh
  • For Windows operating system Windows® プラットフォームの場合: install_root¥bin¥installver_wbi.bat
コマンド行から installver_wbi ツールを開始するには、ディレクトリーを bin ディレクトリーに移動します。このツールは、z/OS® を除く、サポートされるすべてのオペレーティング・システム上で稼働します。 例えば、Linux システムまたは UNIX システム上でツールを開始する場合は、以下のコマンドを使用します。
./installver_wbi.sh
For i5/OS operating system 注: i5/OS では、これらのスクリプトを実行できるようにするために、ネイティブの i5/OS コマンド・ウィンドウから QSH または STRQSH コマンドを使用して、QShell を呼び出す必要があります。

コマンドの使用方法についての情報を表示するための構文

  • For i5/OS operating system i5/OS プラットフォームの場合: ./installver_wbi -help
  • For Linux operating systemFor UNIX operating system Linux および UNIX プラットフォームの場合: ./installver_wbi.sh -help
  • For Windows operating system Windows プラットフォームの場合: installver_wbi.bat -help

全コンポーネントをリストするための構文

  • For i5/OS operating system i5/OS プラットフォーム: ./installver_wbi -listcomponents
  • For Linux operating systemFor UNIX operating system Linux および UNIX プラットフォームの場合: ./installver_wbi.sh -listcomponents
  • For Windows operating system Windows プラットフォームの場合: installver_wbi.bat -listcomponents

製品ファイルを部品表ファイルと比較するための構文

部品表を自動的にインストール済みのファイル・システムと照合する場合は、以下のコマンド構文を使用します。

  • For i5/OS operating system i5/OS プラットフォームの場合: install_root/bin/installver_wbi
  • For Linux operating systemFor UNIX operating system Linux および UNIX プラットフォームの場合: install_root/bin/installver_wbi.sh
  • For Windows operating system Windows プラットフォームの場合: install_root¥bin¥installver_wbi.bat

インストール済みファイルを製品の部品表ファイルと比較する場合のコマンドの使用例については、部品表との照合を参照してください。

比較およびコマンド使用法の例

検査合計を比較するときに、比較の対象に指定のファイルのみを含める場合:
  • For i5/OS operating system i5/OS プラットフォームの場合: ./installver_wbi -include fn1;fn2;fn3
  • For Linux operating systemFor UNIX operating system Linux および UNIX プラットフォームの場合: ./installver_wbi.sh -include fn1;fn2;fn3
  • For Windows operating system Windows プラットフォームの場合: installver_wbi.bat -include fn1;fn2;fn3

指定したファイルまたはコンポーネントのみを比較する場合のコマンドの使用例については、『特定のファイルおよびコンポーネントの検査合計の比較』を参照してください。

検査合計を比較するときに、比較の対象に指定のコンポーネントのみを含める場合:
  • For i5/OS operating system i5/OS プラットフォームの場合: ./installver_wbi -includecomponent comp1;comp2;comp3;...
  • For Linux operating systemFor UNIX operating system Linux および UNIX プラットフォームの場合: ./installver_wbi.sh -includecomponent comp1;comp2;comp3;...
  • For Windows operating system Windows プラットフォームの場合: installver_wbi.bat -includecomponent comp1;comp2;comp3;...
検査合計を比較するときに、比較から特定のコンポーネントを除外する場合:
  • For i5/OS operating system i5/OS プラットフォームの場合: ./installver_wbi -excludecomponent comp1;comp2;comp3;...
  • For Linux operating systemFor UNIX operating system Linux および UNIX プラットフォームの場合: ./installver_wbi.sh -excludecomponent comp1;comp2;comp3;...
  • For Windows operating system Windows プラットフォームの場合: installver_wbi.bat -excludecomponent comp1;comp2;comp3;...

比較からファイルを除外する場合のコマンドの使用例については、検査合計の比較からのファイルの除外を参照してください。

検査合計を比較するときに、ユーザーが除外したファイルを無視する場合:
  • For i5/OS operating system i5/OS プラットフォームの場合: ./installver_wbi -ignoreuserexclude
  • For Linux operating systemFor UNIX operating system Linux および UNIX プラットフォームの場合: ./installver_wbi.sh -ignoreuserexclude
  • For Windows operating system Windows プラットフォームの場合: installver_wbi.bat -ignoreuserexclude
検査合計を比較するときに、IBM が除外したファイルを無視する場合:
  • For i5/OS operating system i5/OS プラットフォームの場合: ./installver_wbi -ignoreibmexclude
  • For Linux operating systemFor UNIX operating system Linux および UNIX プラットフォームの場合: ./installver_wbi.sh -ignoreibmexclude
  • For Windows operating system Windows プラットフォームの場合: installver_wbi.bat -ignoreibmexclude
全コンポーネントのリストのみをする場合:
  • For i5/OS operating system i5/OS プラットフォーム: ./installver_wbi -listcomponents
  • For Linux operating systemFor UNIX operating system Linux および UNIX プラットフォームの場合: ./installver_wbi.sh -listcomponents
  • For Windows operating system Windows プラットフォームの場合: installver_wbi.bat -listcomponents
テンプレート (除外されたファイルのリスト用) のみを作成する場合:
  • For i5/OS operating system i5/OS プラットフォームの場合: ./installver_wbi -createtemplate
  • For Linux operating systemFor UNIX operating system Linux および UNIX プラットフォームの場合: ./installver_wbi.sh -createtemplate
  • For Windows operating system Windows プラットフォームの場合: installver_wbi.bat -createtemplate

検査合計を部品表と照合するためのパラメーター

製品ファイルの検査合計を部品表ファイルの正しい検査合計と比較する際に、コマンドに関連付けられるパラメーターを以下に示します。

-componentdir directory_1;directory_2;directory_n
WebSphere® Application Server 製品がコンポーネントごとの個々の部品表リストを格納するディレクトリーの名前を示すオプション・パラメーター。

デフォルト値は install_root/properties/version/nif/backup ディレクトリーです。

-createtemplate [file_name ]
検査合計の比較からファイルを除外するためのテンプレート・プロパティー・ファイルを作成します。テンプレート・プロパティー・ファイルを編集して、検査から除外したい各ファイルごとに 1 行ずつ追加します。

ファイル指定引数がない場合、installver_wbi ツールは、install_root/properties/ivu_user.template ファイルを作成します。

ファイル名を指定した場合、installver_wbi ツールは、作業ディレクトリー (デフォルトでは install_root/profiles/profile_name/bin ディレクトリー) 内にそのファイルを作成します。

  • For i5/OS operating system i5/OS プラットフォームの場合: コマンド行で以下を入力します。
    1. cdinstall_root/bin
    2. ./installver_wbi -createtemplate
  • For Linux operating systemFor UNIX operating system Linux および UNIX プラットフォームの場合: コマンド行で以下を入力します。
    1. cdinstall_root/bin
    2. ./installver_wbi.sh -createtemplate
  • For Windows operating system Windows プラットフォームの場合: コマンド行で以下を入力します。
    1. cd install_root¥bin
    2. installver_wbi.bat -createtemplate

installver_wbi ツールは、デフォルト・プロファイルの properties ディレクトリー内に、テンプレート・プロパティー・ファイルを作成します。

  • For i5/OS operating system i5/OS プラットフォームの場合: default_profile_root/properties/ivu.user.template
  • For Linux operating systemFor UNIX operating system Linux および UNIX プラットフォームの場合: default_profile_root/properties/ivu.user.template
  • For Windows operating system Windows プラットフォームの場合: default_profile_root¥properties¥ivu.user.template
-exclude file1;file2;file3; ...
複数のファイルを検査から除外します。

セミコロン (;) またはコロン (:) を使用して、ファイル名を区切ります。

-excludecomponent component1;component2;component3; ...
複数のコンポーネントを検査から除外します。

セミコロン (;) またはコロン (:) を使用して、コンポーネント名を区切ります。

-filelist file_name
IBM® が特定の製品コンポーネント内の製品ファイルの正しい検査合計を識別するために使用するファイルの名前を示すオプション・パラメーター。

デフォルト値は files.list です。

-help

使用法の情報を表示します。

-ignoreuserexclude

デフォルトの install_root/properties/ivu_user.template ファイルが存在しているときに、このデフォルトのファイルを無視し、テンプレートにリストされているファイルを比較します。

ファイル指定で -createtemplate パラメーターを使用して、別のロケーションにテンプレート・ファイルを作成する場合は、-ignoreusertemplate パラメーターを指定しても効果はありません。

-ignoreibmexclude

インストール・ルート・ディレクトリー内にあるすべてのファイルの検査合計を比較します。 IBM は、デフォルトで検査から特定のファイルを除外するように指定しています。-ignoreibmexclude パラメーターを使用すると、installver_wbi ツールで、これらのファイルも含めて検査を行うことができます。

-include file1;file2;file3; ...
指定するファイルを検査の対象に含めて、その他のファイルすべてを除外します。

セミコロン (;) またはコロン (:) を使用して、ファイル名を区切ります。

-includecomponent component1;component2;component3; ...
指定するコンポーネントを検査の対象に含めて、その他のコンポーネントすべてを除外します。

セミコロン (;) またはコロン (:) を使用して、コンポーネント名を区切ります。

-installroot directory_name
デフォルトのインストール・ルート・ディレクトリーを指定変更します。
-listcomponents

製品のコンポーネントのリストを表示します。コンポーネントごとに 1 つずつ files.list ファイルがあります。

-log [file_path_and_file_name_of_log_file]

デフォルトのログ・ファイルは、install_root/logs/installver.log ファイルです。 -log パラメーターと引数を使用して、出力をリダイレクトすることができます。

-profilehome directory_name
インストール・ルート・ディレクトリー内のデフォルト・プロファイル・ディレクトリーを指定変更します。
-trace

ツールの検査対象とツールが発見した内容のトレース出力を提供します。

構成済みファイルの品目に対する新しいベースライン検査合計を作成および使用するための構文

構成済みファイルの品目を作成し、これを現在インストールされているファイルと比較するには、以下の構文を使用します。

インストール・ルート・ディレクトリーに現在インストールされているファイルの品目リストを作成する場合:
  • For i5/OS operating system i5/OS プラットフォームの場合: ./installver_wbi -createinventory [path/file_name] (例えば ./installver_wbi -createinventory /tmp/system.inv)
  • For Linux operating systemFor UNIX operating system Linux および UNIX プラットフォームの場合: ./installver_wbi.sh -createinventory [path/file_name] (例えば ./installver_wbi.sh -createinventory /tmp/system.inv)
  • For Windows operating system Windows プラットフォームの場合: installver_wbi.bat -createinventory [path¥file_name] (例えば installver_wbi.bat -createinventory C:¥temp¥system.inv)
品目リストを、インストール・ルート・ディレクトリーに現在インストールされているファイルと比較する場合:
  • For i5/OS operating system i5/OS プラットフォームの場合: ./installver_wbi -compare /path/file_name
  • For Linux operating systemFor UNIX operating system Linux および UNIX プラットフォームの場合: ./installver_wbi.sh -compare /path/file_name
  • For Windows operating system Windows プラットフォームの場合: installver_wbi.bat -compare path¥file_name
比較してトレースの結果を表示する場合:
  • For i5/OS operating system i5/OS プラットフォームの場合: ./installver_wbi -compare /path/file_name -trace
  • For Linux operating systemFor UNIX operating system Linux および UNIX プラットフォームの場合: ./installver_wbi.sh -compare /path/file_name -trace
  • For Windows operating system Windows プラットフォームの場合: installver_wbi.bat -compare /path/file_name -trace
使用法の情報を表示する場合:
  • For i5/OS operating system i5/OS プラットフォームの場合: ./installver_wbi -help
  • For Linux operating systemFor UNIX operating system Linux および UNIX プラットフォームの場合: ./installver_wbi.sh -help
  • For Windows operating system Windows プラットフォームの場合: installver_wbi.bat -help
比較するときに、品目の比較から指定したファイルを除外する場合:
  • For i5/OS operating system i5/OS プラットフォームの場合: ./installver_wbi -compare /path/file_name -exclude fn1;fn2;fn3;...
  • For Linux operating systemFor UNIX operating system Linux および UNIX プラットフォームの場合: ./installver_wbi.sh -compare /path/file_name -exclude fn1;fn2;fn3;...
  • For Windows operating system Windows プラットフォームの場合: installver_wbi.bat -compare ¥path¥file_name -exclude fn1;fn2;fn3;...
比較するときに、品目の比較に指定したファイルのみを対象として含める場合:
  • For i5/OS operating system i5/OS プラットフォームの場合: ./installver_wbi -compare /path/file_name -include fn1;fn2;fn3;...
  • For Linux operating systemFor UNIX operating system Linux および UNIX プラットフォームの場合: ./installver_wbi.sh -compare /path/file_name -include fn1;fn2;fn3;...
  • For Windows operating system Windows プラットフォームの場合: installver_wbi.bat -compare /path/file_name -include fn1;fn2;fn3;...

ファイル品目の検査合計を作成および使用するためのパラメーター

このコマンドに関連付けられるパラメーターを以下に示します。

-compare file_path_and_file_name_of_existing_inventory_file
既存の品目リストを既存ファイルと比較して、相違点を調べます。

最初に -createinventory パラメーターを使用して、品目リストを作成します。次に、-compare パラメーターを使用して、この品目リストを、比較時にシステム内に存在する実際のファイルと比較します。

比較の結果として、変更されたクラス、変更されたファイル、欠落ファイル、追加されたファイルが示されます。このような比較は、ウィルス・ファイルがないかどうかの検査などに非常に役に立ちます。

-createinventory directory_name
profile_root/bin ディレクトリーなどの現行作業ディレクトリー内の sys.inv ファイルに、デフォルトで新しい検査合計を作成します。 ファイル・パスとファイル名を指定することができます。インストール・ルート・ディレクトリーの外部にファイルを作成したり、比較からファイルを除外したりします。

installver_wbi ツールは、どのディレクトリーでも指すことができます。デフォルト・ディレクトリーは、インストール・ルート・ディレクトリーです。

品目からファイルまたはコンポーネントを除外することができます。

installver_wbi ツールは、ファイルごとに検査合計を計算します。品目内の各ファイルのエントリーには、以下の一般的なパターンがあります。

checksum|relativepath/file_name|file_size|last_modified_time

品目リストを作成したら、-compare パラメーターを使用して、このリストを比較時にシステム内に存在する実際のファイルと比較します。

-exclude file1;file2;file3;...
複数のファイルを比較から除外します。

セミコロン (;) またはコロン (:) を使用して、ファイル名を区切ります。

-help
使用法の情報を表示します。
-include file1;file2;file3; ...
指定するファイルを比較の対象に含めて、その他のファイルすべてを除外します。

セミコロン (;) またはコロン (:) を使用して、ファイル名を区切ります。

-installroot directory_name
デフォルトのインストール・ルート・ディレクトリーを指定変更します。
-log [file_path_and_file_name_of_log_file]

デフォルトのログ・ファイルは、install_root/logs/installver.log ファイルです。 -log パラメーターと引数を使用して、出力をリダイレクトすることができます。

-trace
ツールの検査対象とツールが発見した内容のトレース出力を提供します。

以下の例は、installver_wbi コマンドを実行して検査合計を比較したときに発生する可能性のある問題を示しています。

コンポーネントの拡張時に発生するような、意図的に生じた検査合計の不一致のエントリーは無視してください

変更した各ファイルごとに検査合計は異なります。
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

明らかな通知 (I) メッセージは無視してください

いくつかのメッセージは、通常期待される結果からの逸脱を示しますが、重大な問題を示してはいません。
I CWNVU0360I: [ivu] The following bill of materials issue is found for component
  nullvaluesample: 
  Hash must not be null or an empty string.

ファイルが重複している場合は、潜在的な製品の問題または 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

以下の問題については、IBM サポートにお問い合わせください

次の形式のメッセージが表示された場合は、IBM サポートに連絡してください。
W CWNVU0280W: [ivu] Component mismatch: expected ... but found ...

既知の問題とその解決策についての IBM サポートの有効な現行情報については、この IBM サポート・ページを参照してください。

IBM サポートが提供する資料を参照すれば、この問題を解決するために必要な情報を集めるための時間を節減することができます。PMR を開く前に、この IBM サポート・ページを参照してください。

類似したインストールの既知の問題が見つからない場合、または提供されている情報では問題が解決しない場合は、IBM サポートに連絡してください。

次の手順

インストールの検査が終了したら、プロファイルを作成するか、または既存プロファイルでアプリケーションをデプロイすることができます。


reference 参照トピック

ご利用条件 | フィードバック


タイム・スタンプ・アイコン 最終更新: 2010/07/05


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.
このインフォメーション・センターでは Eclipse テクノロジーが採用されています (http://www.eclipse.org)。