ブローカー・アーカイブへのファイルの追加

ファイルを実行グループにデプロイするには、それらをブローカー・アーカイブ (BAR) に組み込む必要があります。

始める前に:

デプロイする各構成ごとに、BAR ファイルを作成します。詳細については、ブローカー・アーカイブの作成を参照してください。

任意のデプロイ可能リソースを、ワークスペースから BAR ファイルに追加できます。 変更の始まり「ワークスペース・プロジェクトのソース・ファイルの追加」変更の終わりを選択すると、ブローカー・アーカイブ内のすべてのメッセージ・フロー、メッセージ・モデル・スキーマ・ファイル、メッセージ・セット、または他のデプロイ可能リソースのソース・ファイルが組み込まれます。 ブローカー・アーカイブに組み込み可能なファイルの詳細については、ブローカー・アーカイブを参照してください。

.msgflow ファイルで定義されたサブフローは、BAR ファイル内で個別の項目としては表示されず、自動的に追加されます。これらのサブフローを組み込むには、親フローだけを追加する必要があります。.subflow ファイルで定義されたサブフローは、BAR ファイル内で個別の項目として表示され、個別のリソースとしてデプロイできます。こうしたサブフローが含まれる親フローが追加されると、BAR ファイルのビルド時にサブフローは自動的に BAR ファイルに追加されます。

以下のステップを実行すると、フロー、変更の始まりDLL変更の終わり、ESQL、Java JAR、PHP、MAP、XML、 XSLT ファイル、およびメッセージ・セットを手動で追加できます。しかし、メッセージ・フロー内で JavaCompute ノードまたは .NETCompute ノードによって必要とされる JAR ファイルまたは .NET アセンブリー (DLL ファイル) は、メッセージ・フローを追加するときに Java プロジェクト変更の始まりまたは メッセージ・ブローカー・プロジェクト変更の終わりから自動的に追加されます。また、XML および XSL ファイルも、フローで必要とされる場合に自動的に追加されます。

変更の始まりメッセージ・フロー (.msgflow ファイルで定義) を BAR ファイルに追加すると、そのフローを .msgflow ファイルとして追加したり、コンパイル済みメッセージ・フロー (.cmf ファイルで定義) として追加したりできます。 フローに以下のいずれかのノードが含まれる場合、そのフローを .msgflow ファイルとして追加することはできません。
  • 外部ユーザー定義ノード
  • WTX ノード
  • サブフロー・ユーザー定義ノード
  • v7 マッピング・ノード
  • MQOptimize ノード
変更の終わり

JAR ファイルは、更新していなければ再デプロイの必要はありません。ブローカーが稼働するコンピューターに、BAR ファイル内の 1 つ以上の JAR ファイルがある場合、再デプロイする前に BAR ファイルからそれらの JAR ファイルを除去しても差し支えありません。ブローカーが使用可能な JAR ファイルには、デプロイした JAR ファイル、および共用クラス・ディレクトリー、またはインストール・ディレクトリーの classes サブディレクトリーに存在する JAR ファイルが含まれます。例えば、com.ibm.mq.jar、ConfigManagerProxy.jar、jplugin2.jar、および javacompute.jar の各ファイルは常にブローカーから可視であり、別個にデプロイする必要がありません。

デプロイされたファイルをブローカー実行グループから読み取ることはできません。 したがって、デプロイされた BAR ファイルかその中にある個々のファイルのコピーを保持してください。

WebSphere® Message Broker Toolkit を使用して BAR ファイルを追加するには、以下のステップを実行します。

  1. BAR ファイルをダブルクリックして開きます。 BAR ファイルの内容が、ブローカー・アーカイブ・エディターに表示されます。(BAR ファイルが新規の場合、このビューは空です。)
  2. ブローカー・アーカイブ・エディターの「準備」ページで、BAR ファイルに追加するデプロイ可能ワークスペース・リソースを選択します。

    「アプリケーション」を選択すると、デプロイ可能なアプリケーションのリストが表示されます。 アプリケーションを 1 つ選択すると、それに含まれるすべてのリソースがそのアプリケーションと共にデプロイされます。 1 つのアプリケーション内のデプロイされるリソースは、他のアプリケーションのリソースから分離されます。 リソースを実行グループに直接デプロイするには、「メッセージ・フロー、ライブラリー、および他のメッセージ・フロー依存関係」をクリックしてください。 デプロイされた後のこれらのリソースは、同じ実行グループ内の他のすべてのデプロイ済みリソースから可視になります。

    BAR ファイルに追加する個別リソース (アプリケーション、ライブラリー、.NET アプリケーション・ドメイン、またはプロジェクトのリソース) を選択できます。 あるいは、適切なルート・エレメントを選択することで、ワークスペース内のアプリケーション、ライブラリー、.NET アプリケーション・ドメイン、またはプロジェクトのリソースをすべて追加することもできます。 選択したアプリケーションが 1 つ以上のライブラリーを参照する場合、それらのライブラリーがアプリケーションの .appzip ファイルに、ネストされた .libzip ファイルとして追加されます。 これらの参照されているライブラリーはプライベートなため、そのアプリケーションの外部のリソースからはアクセスできません。したがって、それらのライブラリーは「準備」ページではデフォルトで選択されていません。あるライブラリーを、他のリソースからアクセス可能な実行グループ・レベルのライブラリーとしてデプロイするには、そのライブラリーを選択して個別にデプロイしてください。 そのライブラリー用の .libzip ファイルが作成され、BAR ファイルにルート・レベルで追加されます。

    他のライブラリーを参照するライブラリーを選択すると、参照されているライブラリーも、.libzip ファイルとして BAR ファイルに追加されます。

    変更の始まり選択したアプリケーションが 1 つ以上の .NET アプリケーション・ドメインを参照する場合、それらのアプリケーション・ドメインが、ルート・レベルの BAR ファイルに .appdomainzip ファイルとして追加されます。変更の終わり

  3. オプション: ソース・ファイルを組み込むには、変更の始まり「ワークスペース・プロジェクトのソース・ファイルの追加」変更の終わりを選択します。

    変更の始まり「ワークスペース・プロジェクトのソース・ファイルの追加」変更の終わりを選択すると、すべてのアプリケーション、ライブラリー、およびその他のコンパイル済みリソースのソース・プロジェクトが BAR ファイルの src フォルダーに追加されます。

  4. オプション: 新規 BAR ファイルをビルドする前に、BAR ファイルから既存の内容を削除するには、「ビルド前にブローカー・アーカイブの内容を削除」を選択します。
  5. オプション: メッセージ・フローをブローカー・アーカイブに 2 度目に追加しようとしており、「管理」ページを使用してフロー・パラメーターを変更した場合は、「構成可能プロパティーの値の指定変更」を選択して構成設定をリセットします。 このコントロールがクリアされていれば、既存の設定はフローの置換時にも変更されないままになります。
  6. 変更の始まりオプション: ESQL ファイルを参照する各メッセージ・フローのコンパイル済みメッセージ・フロー .cmf ファイルに ESQL コードを直接組み込んで、メッセージ・フローを .cmf ファイルとして組み込むには、オプション「リソースのコンパイルおよびインライン化」を選択します。 デフォルトでは、1 つ以上のメッセージ・フローによって参照されるそれぞれの ESQL ファイルは個別のリソースとしてデプロイされ、複数の .cmf ファイルからアクセスが可能です。デフォルトでは、メッセージ・フローを BAR ファイルに追加すると、.msgflow ファイルとして追加されます。 .subflow ファイルで定義されたサブフローが BAR ファイルに含まれる場合、コンパイル済みのメッセージ・フロー・ファイルに ESQL コードを直接組み込むことはできません。変更の終わり
  7. 「ビルドと保存」をクリックします。

BAR ファイルに現在含まれているファイルが「管理」ページにリストされます。 当該アプリケーションおよびライブラリーを展開して、内容を表示します。BAR ファイル内のコンパイル済みリソースが、ツリー内にアルファベット順で表示されます。ルート・エレメントのみ編集することができます。例えば、あるアプリケーションを BAR ファイルに追加すると、.appzip ファイルを名前変更したり、コメントを追加したりできます。.appzip ファイル内のリソースは編集できませんが、それらのリソースの構成可能プロパティーを編集できます。

.appzip、.appdomainzip、または .libzip ファイルから個別リソースを削除することはできません。それらのリソースを削除するには、アプリケーション、.NET アプリケーション・ドメイン、またはライブラリーを削除する必要があります。

ソース・ファイルの非表示を選択するには、「フィルター基準」メニューのリストから、「ビルド済みリソース」または「構成可能プロパティー」を選択できます。

次に行う事柄:

構成可能プロパティーを使用する場合は、構成可能プロパティーの編集を参照してください。

構成可能プロパティーの異なる値を持つフローの複数インスタンスを持つ場合には、ブローカー・アーカイブへのメッセージ・フローの複数インスタンスの追加を参照してください。

BAR ファイルにさらに変更を加えるには、ブローカー・アーカイブ・ファイルの手動での編集を参照してください。

BAR ファイルが完成したら、ブローカー・アーカイブ・ファイルのデプロイの指示に従ってデプロイします。

特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
最終更新

        最終更新 : 2012-07-13 15:42:39


タスク・トピックタスク・トピック | バージョン 8.0.0.1 | af03880_