IBM i でのディスカバリーのトラブルシューティング

9.2.5 から利用可能。このトラブルシューティング・セクションでは、接続切断スキャナーを使用してソフトウェア・インベントリーおよびハードウェア・インベントリーをディスカバーしているときに発生することがある、最も一般的な問題をリストします。トラブルシューティングの主要な目標は、予期した動作が行われない理由を特定し、問題の解決方法を明確にすることです。

ログ・ファイル

スキャナーのログ・ファイルは、以下のディレクトリーにあります。
  • /Installation directory/logs/*.
  • /etc/cit/logs/*
デフォルトのインストール・ディレクトリーは /cit です。

IBM i システムからのファイルの転送

FTP を介して接続した場合に表示される IBM i システムの内部ファイル構造は、非常に複雑です。ただし、以下のいずれかのコマンドを使用することで、もっと UNIX のようにすることができます。FTP を介して接続した後に、以下のコマンドのいずれかを発行します。 
cd /
site NAMEFMT 1
ヒント: 詳しくは、「FTP サブコマンド: NAMEFMTの使用」を参照してください。
次に、ファイルを転送するために適切なモード (バイナリーまたはテキスト) を設定します。スキャン結果を転送する場合はバイナリー・モード、スキャナーのログ・ファイルを取得する場合はテキスト・モードを使用します。

プロセッサー使用率の最適化

デフォルトでは、プロセッサー使用率はスキャン中に制限されません。使用率は、CPU しきい値をセットアップすることで最適化できます。
注: しきい値を設定しても、CPU 使用量が常に指定値を下回っていることは保証されません。その値前後で変動し、その値を超過することも、下回ることもあります。一時的なピークも予期されます。しきい値を設定すると、スキャンの時間が長くなる場合があります。
  1. スキャナーとともにダウンロードした sw_config.xml ファイルを編集します。
  2. 2 つの新しい cpuThreshold 属性を追加します (1 つは FSScanner 用、もう 1 つは Signatures 用)。例:
    <BigFix>
<CIT>
<XSE version="1.0">
<Plugins>
<Plugin name="FSScanner">
<Attribute name="cpuThreshold" value="20:2:150:850"/>
(...)
<Attribute name="interruptOnTimeout" value="true"/>
</Plugin>
</Plugins>
<Signatures>
<Attribute name="cpuThreshold" value="20:2:150:850"/>
</Signatures>
</XSE>
</CIT>
</IBM>
  3. 次のいずれかの値を指定します。
    目的の使用率 値
    5% 10:2:50:950
    10% 20:2:100:900
    15% 20:2:150:850
    20% 30:2:200:800
    25% 30:2:250:750
    50% 50:2:300:500
  4. ファイルを保存します。

スキャン対象からのディレクトリーの除外

カタログ・ベースのスキャンおよび ISO タグ・スキャン時のスキャン対象からディレクトリーを除外できます。これを行うには、 sw_config.xml ファイルを編集します。excludeDirectory 属性の値としてディレクトリーを指定します。
  • /tmp ディレクトリを除外するには、以下のようにします。
    <Attribute name="excludeDirectory" value="/tmp/"/>
  • tmp という名前のすべてのディレクトリー (例えば、/tmp や /dir/tmp) を除外するには、以下のようにします。
    <Attribute name="excludeDirectory" value="*/tmp/"/>

BigFix サポートへの失敗パッケージの提供

パッケージのインポートの失敗
インポート・ログに以下のエラーが表示されている場合、スキャン・パッケージ全体を提供します。 
2015-11-06 08:31:07 INFO: Processing scan package: 201511041200-9.128.0.223.zip from: /disconnected/.
2015-11-06 08:31:08 INFO: ETL from FileSystem - SAM::DisconnectedScan 
(0x00000000563C63FF - 0x00000000563C6514): Failed
2015-11-06 08:31:08 ERROR: Sequel::UniqueConstraintViolation: 
Java::ComIbmDb2JccAm::SqlIntegrityConstraintViolationException: One or more values in the INSERT statement, 
UPDATE statement, or foreign key update caused by a DELETE statement are not valid because the primary key, 
unique constraint or unique index identified by "1" constrains table "DBO.RAW_DATASOURCE_FILES" from having 
duplicate values for the index key.. SQLCODE=-803, SQLSTATE=23505, DRIVER=3.64.104
単一ファイルのインポートの失敗
インポート・ログに以下のメッセージが含まれている場合は、スキャン・パッケージに含まれている単一のファイルのインポートが失敗しています。
2015-11-06 10:48:07 WARN: An error occurred parsing XML file 2 in file isotagsearch_0_375.zip. 
Install path value was not found.
このようなファイルは、長いパスとともに提供する必要があります。このパスを判別するには、以下のステップを実行します。
  1. BigFix Inventory インストール・ディレクトリーに移動します。
  2. 以下のようにして、失敗しているファイルを検索します。 
    find -name "isotagsearch_0_375.zip"

    サポートに提供する必要があるコマンド出力:

    ./wlp/usr/servers/server1/tmp/datasources/2/UploadManager/sha1/75/375/isotagsearch_0_375.zip

一般的な問題

要件が満たされているのにもかかわらず、パッケージがインポート時にスキップされる
エンドポイントから複数のパッケージをインポートしている場合に、このような問題が発生することがあります。BigFix Inventory は常に、最新のパッケージをインポートし、以前のすべてのパッケージを省きます。パッケージのスキップに関する以下のメッセージは、関係のないパッケージに関するものであり、無視できます。 
2015-11-05 09:35:22 WARN: Skipping file: package_scan.xml from: 201510101200-2inarow.zip. 
The data was already processed.
2015-11-05 09:35:22 INFO: Skipping file: package_scan.xml. 
Unsupported file in: 201510101200-2inarow.zip.
キャパシティー・スキャンの同じ結果を異なるパッケージで使用した場合、インポートが失敗することがある
テスト目的のためにキャパシティー・スキャン結果を再使用した場合、この問題が発生することがあります。複数のエンドポイントに同じスキャン結果が含まれている場合、インポートが失敗し、以下のメッセージが表示されます。
ERROR:  (ImportCapacity-Thread:3) doInsert com.ibm.db2.jcc.am.SqlIntegrityConstraintViolationException:
One or more values in the INSERT statement, UPDATE statement, or foreign key update caused 
by a DELETE statement are not valid because the primary key, unique constraint or unique 
index identified by "1" constrains table "ADM.LAST_IMPORTED_SCAN" from having duplicate values 
for the index key.. SQLCODE=-803, SQLSTATE=23505, DRIVER=3.64.104

エンドポイントごとにキャパシティー・スキャンを実行し、適切な結果を使用するようにしてください。

ソフトウェア・スキャンまたは ISO タグ・スキャンが失敗し、結果が作成されない
QSH で以下のコマンドを実行してから、スキャンを繰り返します。
export QIBM_MULTI_THREADED=Y
ソフトウェアがディスカバーされてバンドルされるが、PVU の計算が行われない
問題は、エポックが正しくなく、将来の日付を指していることが原因の可能性があります。エポックは、キャパシティー・スキャン結果のファイル名に含まれています (例えば、tlm_hw_201603021330_1456969683.xml)。capacity.zip アーカイブを開き、エポックが正しいかどうかを確認します。エポックを正常な日付に変換する必要があります。Linux では、これを行うには、date -d @epoch コマンドを実行します。
接続切断スキャナーによって提供されるエンドポイントのホスト名が、期待されるものと異なる
接続切断スキャナーと通常のスキャナーによって提供されるホスト名が異なることがあります。通常のスキャナーは、BigFix で提供されるホスト名を使用しますが、接続切断スキャナーは、hostname コマンドを実行して (使用可能でない場合は、スキャナーを介して)、ホスト名を検査します。
サポート・ケースのオープン
上記解決策のいずれも機能しない場合、サポート・ケースをオープンし、BigFix サポートに以下のファイルを提供します。
  • スキャン結果が含まれたパッケージ
    • /Installation directory/run_hw_std.log
    • /Installation directory/run_sw_and_pack_std.log
  • /Installation directory/warning*.xml file
  • スキャナー・ログ /etc/cit/logs
  • 可能であれば、デバッグ・モードでの失敗したステップのコンソール出力。以下の例では、出力を使用して /cit/failure.log ファイルが生成されます。
    export QIBM_MULTI_THREADED=Y
/qsys.lib/qtivcit.lib/wscansw.pgm -s -c /cit/sw_config.xml -i /cit/CIT_catalog_I5OS.xml
-o /cit/catalog_scan_man.xml -e /cit/warning_man.xml -debug
>/cit/failure.log 2>&1

インポート・ログのモニター

スキャン結果が含まれたパッケージを にインポートした場合、BigFix Inventory、インポート・ログ (「管理」 > 「データのインポート」) に、パッケージに関連した情報および警告メッセージが表示されます。パッケージまたはその内容が要件を満たしていない場合、インポート時にスキップされることがあります。その場合、スキャン結果は BigFix Inventoryで表示されません。インポート・ログのモニター時に、以下のメッセージを予期できます。
info: Processing scan package:package from:directory. info: Invalid file name. The scan package must match the pattern YYYYMMDDHHMM-*.zip. Skipping package:package. info: Invalid Catalog Version property in the computer.yml file:version. The property must match the pattern <Number>.<Number>. The catalog might be reported as outdated. warn: The disconnected scans location does not exist:directory. warn: Invalid file name. The scan date must be later than year 2000. Skipping package:package. warn: Skipping corrupted scan package:package. The following error occurred:error. warn: Missing computer.yml file. Skipping package:package. warn: Missing property:property in the computer.yml file. Skipping package:package. warn: Invalid computer.yml file. Skipping package:package. The following error occurred:error. warn: The value of the endpointID property in the computer.yml file is longer than 512 characters. Skipping package:package. warn: The value of the endpointID property in the computer.yml file is empty. Skipping package:package. warn: Missing property: endpointID in the computer.yml file. Skipping package:package. warn: Importing older scan package from:date for computer:computer_id. This computer already has data from:date. warn: The file is larger than 2097150 bytes. Skipping file:scan_file from:package for computer:computer_id. warn: The following error occurred when processing the package_scan.xml file:error. warn: The insertion of the operating_system package data into the database failed on record content. The following error occurred:error。