インストール済みのファイルについて検査合計を計算し、その検査合計と提供されている製品の部品表とを比較する場合に、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.sh
部品表を自動的にインストール済みのファイル・システムと照合する場合は、以下のコマンド構文を使用します。
インストール済みファイルを製品の部品表ファイルと比較する場合のコマンドの使用例については、部品表との照合を参照してください。
指定したファイルまたはコンポーネントのみを比較する場合のコマンドの使用例については、『特定のファイルおよびコンポーネントの検査合計の比較』を参照してください。
比較からファイルを除外する場合のコマンドの使用例については、検査合計の比較からのファイルの除外を参照してください。
製品ファイルの検査合計を部品表ファイルの正しい検査合計と比較する際に、コマンドに関連付けられるパラメーターを以下に示します。
デフォルト値は install_root/properties/version/nif/backup ディレクトリーです。
ファイル指定引数がない場合、installver_wbi ツールは、install_root/properties/ivu_user.template ファイルを作成します。
ファイル名を指定した場合、installver_wbi ツールは、作業ディレクトリー (デフォルトでは install_root/profiles/profile_name/bin ディレクトリー) 内にそのファイルを作成します。
installver_wbi ツールは、デフォルト・プロファイルの properties ディレクトリー内に、テンプレート・プロパティー・ファイルを作成します。
セミコロン (;) またはコロン (:) を使用して、ファイル名を区切ります。
セミコロン (;) またはコロン (:) を使用して、コンポーネント名を区切ります。
デフォルト値は files.list です。
使用法の情報を表示します。
デフォルトの install_root/properties/ivu_user.template ファイルが存在しているときに、このデフォルトのファイルを無視し、テンプレートにリストされているファイルを比較します。
ファイル指定で -createtemplate パラメーターを使用して、別のロケーションにテンプレート・ファイルを作成する場合は、-ignoreusertemplate パラメーターを指定しても効果はありません。
インストール・ルート・ディレクトリー内にあるすべてのファイルの検査合計を比較します。 IBM は、デフォルトで検査から特定のファイルを除外するように指定しています。-ignoreibmexclude パラメーターを使用すると、installver_wbi ツールで、これらのファイルも含めて検査を行うことができます。
セミコロン (;) またはコロン (:) を使用して、ファイル名を区切ります。
セミコロン (;) またはコロン (:) を使用して、コンポーネント名を区切ります。
製品のコンポーネントのリストを表示します。コンポーネントごとに 1 つずつ files.list ファイルがあります。
デフォルトのログ・ファイルは、install_root/logs/installver.log ファイルです。 -log パラメーターと引数を使用して、出力をリダイレクトすることができます。
ツールの検査対象とツールが発見した内容のトレース出力を提供します。
構成済みファイルの品目を作成し、これを現在インストールされているファイルと比較するには、以下の構文を使用します。
このコマンドに関連付けられるパラメーターを以下に示します。
最初に -createinventory パラメーターを使用して、品目リストを作成します。次に、-compare パラメーターを使用して、この品目リストを、比較時にシステム内に存在する実際のファイルと比較します。
比較の結果として、変更されたクラス、変更されたファイル、欠落ファイル、追加されたファイルが示されます。このような比較は、ウィルス・ファイルがないかどうかの検査などに非常に役に立ちます。
installver_wbi ツールは、どのディレクトリーでも指すことができます。デフォルト・ディレクトリーは、インストール・ルート・ディレクトリーです。
品目からファイルまたはコンポーネントを除外することができます。
installver_wbi ツールは、ファイルごとに検査合計を計算します。品目内の各ファイルのエントリーには、以下の一般的なパターンがあります。
checksum|relativepath/file_name|file_size|last_modified_time
品目リストを作成したら、-compare パラメーターを使用して、このリストを比較時にシステム内に存在する実際のファイルと比較します。
セミコロン (;) またはコロン (:) を使用して、ファイル名を区切ります。
セミコロン (;) またはコロン (:) を使用して、ファイル名を区切ります。
デフォルトのログ・ファイルは、install_root/logs/installver.log ファイルです。 -log パラメーターと引数を使用して、出力をリダイレクトすることができます。
以下の例は、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 サポートにお問い合わせください
W CWNVU0280W: [ivu] Component mismatch: expected ... but found ...
既知の問題とその解決策についての IBM サポートの有効な現行情報については、この IBM サポート・ページを参照してください。
IBM サポートが提供する資料を参照すれば、この問題を解決するために必要な情報を集めるための時間を節減することができます。PMR を開く前に、この IBM サポート・ページを参照してください。
類似したインストールの既知の問題が見つからない場合、または提供されている情報では問題が解決しない場合は、IBM サポートに連絡してください。
インストールの検査が終了したら、プロファイルを作成するか、または既存プロファイルでアプリケーションをデプロイすることができます。