ブローカー・アーカイブ・ファイルのデプロイ

始める前に:

この作業は、ブローカー・アーカイブ (bar) をデプロイする方法を説明します。 まだ bar ファイルを作成していない場合は、作業を続ける前に、今ブローカー・アーカイブ・ファイルを作成してください。

ブローカー・アーカイブ (bar) ファイルをデプロイするには、以下の 3 つの方法があります。

デプロイする実行グループが ACL によって制限されている場合には、アクセス権限を持っている必要があります。

Message Brokers Toolkit の使用

以下のステップに従って、ワークベンチを使用して、bar ファイルをデプロイします。

  1. 「ブローカー管理」パースペクティブに切り替えます。
  2. オプション。 通常、増分 bar ファイル・デプロイメントが実行されます。 完全 bar ファイル・デプロイメントを実行する場合、「ドメイン」ビューでターゲットの実行グループを右クリックし、「デプロイ済みの子を除去」を選択します。 継続する前に、操作が完了するのを待ってください。

    1 つ以上のデプロイ済みの子を bar ファイルの内容でリフレッシュするだけの場合には、デプロイ済みの子を除去する必要はありません。 完全 bar ファイル・デプロイメントと増分 bar ファイル・デプロイメントの違いは、メッセージ・フロー・アプリケーションのデプロイメントのトピックで説明されています。

  3. 「ナビゲーター」ビューに表示される bar ファイルをクリックして、強調表示します。
  4. 「ドメイン」ビューに表示されるターゲット実行グループまで、ファイルをドラッグします。

    代替として、bar ファイルを右クリックして「ファイルのデプロイ」をクリックします。ダイアログ・ボックスに、すべてのドメインと、ワークベンチが接続されているドメイン内の実行グループも表示されます。ダイアログ・ボックスには、bar ファイルをデプロイ可能な (ドメイン内の) 実行グループが表示されます。実行グループを選択して「OK」をクリックし、bar ファイルをデプロイします。(注: ドメインに接続されていないブローカー・トポロジーを選択した場合、接続が試行されます。「キャンセル」をクリックした場合、ブローカー・トポロジーはドメインと接続されないままになります。)

    どちらの方法を使用する場合でも、一度に複数の実行グループを選択 (およびデプロイ) することはできません。

  5. bar ファイルが最後に編集されてから保管されていない場合、デプロイする前にそれを保管するかどうか尋ねられます。「キャンセル」をクリックすると、bar ファイルは保管されず、デプロイメントも実行されません。
bar ファイルは構成マネージャーに転送され、その内容 (例えば、メッセージ・フローおよびメッセージ・セット) が実行グループにデプロイされます。 「ドメイン」ビューでは、割り当てられたメッセージ・フローとメッセージ・セットが適切な実行グループに追加されます。

次に行う事柄:

デプロイメントの結果の検査を続けます。

mqsideploy コマンドの使用

以下のステップに従って、mqsideploy コマンドを使用して bar ファイルをデプロイします。

  1. ご使用の環境に合わせて構成したコマンド・ウィンドウを開きます。
  2. 以下のコマンドを例として使用し、適切なものを 1 行で入力します。
    z/OS の場合:
    /f MQ01CMGR,dp b=broker e=exngp a=barfile

    これで、増分デプロイメントが実行されます。 m=yes パラメーターを追加して、完全 bar ファイル・デプロイメントを実行します。

    その他のプラットフォームの場合:
    mqsideploy -i ipAddress -p port -q qmgr -b broker -e exngp -a barfile

    これで、増分デプロイメントが実行されます。 –m パラメーターを追加して、完全 bar ファイル・デプロイメントを実行します。

    -i (IP アドレス)、-p (ポート)、および -q (キュー・マネージャー) パラメーターは、キュー・マネージャー・ワークステーションの接続の詳細を表します。また、z/OS コンソールでは、MQ01CMGR構成マネージャー・コンポーネントの名前です。

    -b (ブローカー名)、-e (実行グループ名)、および -a (bar ファイル名) パラメーター (または z/OS の対応するもの) も指定する必要があります。

次に行う事柄:

デプロイメントの結果の検査を続けます。

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

ExecutionGroupProxy クラスのデプロイ・メソッドを使用します。 デフォルトで、デプロイ・メソッドは増分デプロイメントを実行します。 完全デプロイメントを実行するには、ブール isIncremental パラメーターを含むメソッドの変形を使用し、これを完全デプロイメントを示す false に設定します。 (true に設定すると、増分デプロイメントを示します。)

以下に例を示します。
import com.ibm.broker.config.proxy.*;
import java.io.IOException;

public class DeployTopology {
  public static void main(String[] args) {
    ConfigManagerConnectionParameters cmcp = new MQConfigManagerConnectionParameters("localhost", 1414, "QM1");
    try {
      ConfigManagerProxy cmp = ConfigManagerProxy.getInstance(cmcp);
      TopologyProxy t = cmp.getTopology();
      BrokerProxy b = t.getBrokerByName("BROKER1");
      ExecutionGroupProxy e = b.getExecutionGroupByName("default");
      e.deploy("deploy.bar");
    }
    catch (ConfigManagerProxyException cmpe) {
      cmpe.printStackTrace();
    }
    catch (IOException ioe) {
      ioe.printStackTrace();
    }
  }
} 

次に行う事柄:

デプロイメントの結果の検査を続けます。

特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック
Copyright IBM Corporation 1999, 2006 最終更新: 08/21/2006
af03890_