デプロイメントの結果の検査

デプロイメントの実行後に、操作が正常に完了したことを検査します。

デプロイメントの結果は、以下の 3 つの方法で確認できます。 また、ブローカーがデプロイされたターゲット・システムのシステム・ログも確認して、ブローカーがエラーを報告していないことを確かめてください。

Message Brokers Toolkit の使用

以下のステップに従って、ワークベンチ を使用してデプロイメントを検査します。

  1. 「ブローカー管理」パースペクティブに切り替えます。
  2. 「ドメイン」ビューを展開します。
  3. 「イベント・ログ」をダブルクリックします。
デプロイメントが開始されると、次の情報メッセージが表示され、構成マネージャーが要求を受け取ったことを確認します。
  • BIP0892I
デプロイメントが正常に完了した場合は、以下の 1 つ以上の追加メッセージも表示されます。
  • BIP4040I
  • BIP4045I
  • BIP2056I

mqsideploy コマンドの使用

mqsideploy コマンドを使用してデプロイする場合、そのコマンドは構成マネージャーおよびデプロイメントの影響を受けたすべてのブローカーから、結果を示す数値を戻します。 デプロイメントが正常に完了すると、コマンドは 0 を戻します。表示されるその他の値の詳細については、mqsideploy コマンドを参照してください。

構成マネージャー・プロキシー API の使用

構成マネージャー・プロキシー・アプリケーションを使用している場合は、以下のようなコードを使用して、パブリッシュ/サブスクライブ・トポロジー・デプロイメント操作の結果を調べることができます。
TopologyProxy t = cmp.getTopology();

boolean isDelta = true;
long timeToWaitMs = 10000;
DeployResult dr = topology.deploy(isDelta, timeToWaitMs);

System.out.println("Overall result = "+dr.getCompletionCode());

// Display overall log messages
Enumeration logEntries = dr.getLogEntries();
while (logEntries.hasMoreElements()) {
  LogEntry le = (LogEntry)logEntries.nextElement();
  System.out.println("General message: " + le.getDetail());
}

// Display broker specific information
Enumeration e = dr.getDeployedBrokers();
while (e.hasMoreElements()) {

  // Discover the broker
  BrokerProxy b = (BrokerProxy)e.nextElement();

  // Completion code for broker
  System.out.println("Result for broker "+b+" = " +
    dr.getCompletionCodeForBroker(b));

  // Log entries for broker
  Enumeration e2 = dr.getLotEntriesForBroker(b);
  while (e2.hasMoreElements()) {
    LogEntry le = (LogEntry)e2.nextElement();
    System.out.println("Log message for broker " + b +
      le.getDetail()));
  }
}
deploy メソッドは、影響のあるすべてのブローカーがデプロイメント要求に対して応答するまで、他のプロセスをブロックします。

このメソッドが戻される場合、その時点で DeployResult はデプロイメントの結果を表します。構成マネージャー・プロキシーによってオブジェクトは更新されません。

デプロイメント・メッセージを構成マネージャーに送信できない場合、デプロイメント時に ConfigManagerProxyLoggedException 例外がスローされます。構成マネージャーがデプロイメント・メッセージを受け取る場合、デプロイメント全体のログ・メッセージが表示され、デプロイメントの影響を受けた各ブローカーに固有の完了コードが示されます。 完了コードは、CompletionCodeType クラスからの以下のいずれかの静的インスタンスとなります。

完了コード 説明
pending デプロイメントはバッチ内で保留され、ConfigManagerProxy.sendUpdates() を発行するまで送信されません。
submitted デプロイ・メッセージは構成マネージャーに送信されましたが、タイムアウト期間が満了する前に応答が受信されませんでした。
initiated 構成マネージャーによりデプロイメントが開始されたことが示されましたが、タイムアウト期間が満了する前にブローカー応答が受信されませんでした。
successSoFar 構成マネージャーによりデプロイメントが開始されたことが示され、一部のブローカー (すべてではない) が、タイムアウト期間が満了する前に正常に応答しました。 否定応答したブローカーはありません。
success 構成マネージャーによりデプロイメントが開始されたことが示され、すべてのブローカーが、タイムアウト期間が満了する前に正常に応答しました。
failure 構成マネージャーによりデプロイメントが開始されたことが示され、少なくとも 1 つのブローカーが否定応答しました。 DeployResult クラスの getLogEntriesForBroker メソッドを使用して、デプロイメントの失敗に関するさらに詳細な情報を入手できます。 このメソッドは、使用可能な LogEntry オブジェクトの列挙を戻します。
notRequired 構成マネージャーに実行依頼されたデプロイメント要求は、ブローカーの構成が既に最新になっているため、送信されませんでした。
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009. All Rights Reserved.
最終更新 : 2009-02-13 10:23:17

af03970_