バージョン 5.0 または バージョン 5.1 からのユーザー定義ノードのマイグレーション

ユーザー定義ノードを バージョン 6.0 にマイグレーションします。

バージョン 5.0 からバージョン 6.0にユーザー定義ノードをマイグレーションするには、ツールキットとランタイム・コンポーネントの両方をマイグレーションする必要があります。

ユーザー定義ノードの Message Brokers Toolkit 表現の マイグレーション

バージョン 5.1 Message Brokers Toolkit から バージョン 6.0 Message Brokers Toolkit にマイグレーションするには、以下のようにします。
  1. ユーザー定義ノード・プロジェクトをバージョン 6.0 Message Brokers Toolkit にインポートします。
  2. Package Explorer で、使用しているユーザー定義ノード・プロジェクトを選択し、「プロジェクト」 > 「プロジェクトの消去」をクリックします

バージョン 5.0 Message Brokers Toolkit から バージョン 6.0 Message Brokers Toolkit にマイグレーションするには、以下のようにします。

  1. ユーザー定義ノード・プロジェクトをバージョン 6.0 Message Brokers Toolkit にインポートします。
  2. Package Explorer で、使用しているユーザー定義ノード・プロジェクトを選択し、「プロジェクト」 > 「プロジェクトの消去」をクリックします
  3. ユーザー定義ノード・プロジェクトのルートにある plugin.xml ファイルで、<requires> エレメントを以下の内容と一致するように変更してください。
    <requires>
            <import match="greaterOrEqual" plugin="com.ibm.etools.mft.api" version="6.0.0"/>
    </requires>
  4. 同じ plugin.xml ファイルの "org.eclipse.help.contexts" 拡張ポイントを、以下の内容と一致するように変更してください。
    <extension point="org.eclipse.help.contexts">
    	<contexts file="HelpContexts.xml"/>
    </extension>

ユーザー定義ノードをマイグレーションしたなら、そのユーザー定義ノードが含まれているメッセージ・フローはいっさいマイグレーションする必要がありません。

ユーザー定義ノード・ランタイム・コードのマイグレーション

この手順を開始する前に、ユーザー定義ノードの Message Brokers Toolkit 表現をマイグレーションしておく必要があります。

ユーザー定義ノード・ランタイム・コードをマイグレーションするには、以下のようにします。

  1. コンパイル済みまたはパッケージされたユーザー定義拡張機能ファイルのコピーを、拡張機能ファイルを使用することにしている各ブローカー・システムに保管します。バージョン 6.0ブローカーに対して、mqsicreatebroker または mqsichangebroker コマンドで指定したディレクトリーに LIL または JAR ファイルを保存してください。 (バージョン 5.0 ブローカー・システムの場合、LIL または JAR ファイルはインストール・ディレクトリーに保存されました。)
    • Java™ ユーザー定義ノードをマイグレーションする場合は、ユーザー定義拡張機能ファイルを一度だけビルドして、それを各システムに配布することができます。
    • C ユーザー定義ノードをマイグレーションし、すべてのブローカーのマシン・タイプが同じである場合は、 ユーザー定義拡張機能ファイルを一度だけビルドして、それを各システムに配布することが できます。
    • C ユーザー定義ノードをマイグレーションし、そのクラスターが、例えば AIX®Solaris、および Windows® ブローカーをそれぞれ 1 台というように、さまざまなタイプのマシンで構成されている場合は、拡張機能ファイルを各マシン・タイプごとに別個にビルドする必要があります。
  2. C ユーザー定義拡張機能の場合、LIL ファイルに対応する PDB ファイルも、指定したディレクトリーに保管します。PDB ファイルは、アクセス違反や他のソフトウェア誤動作が起きた場合にスタック診断情報で使用するシンボル情報を提供します。
  3. 新しいファイルが存在することを間違いなく検出するために、各ブローカーを停止して開始します。
    次の 2 つのシナリオでは、ブローカーの再始動は必要ありません。
    • Message Brokers Toolkit に実行グループが作成済みで、その実行グループにまだ何もデプロイしていない場合、選択したディレクトリーに LIL、PDB、および JAR ファイルを追加できます。
    • 使用する実行グループに既にデプロイを行った場合は、選択したディレクトリーに LIL、PDB、および JAR ファイルを追加した後、mqsireload コマンドを使用してグループを再始動してください。 Windows オペレーティング・システムでは、オペレーティング・システムによるファイル・ロックのため、ブローカーの稼働中に既存ファイルを上書きすることは不可能です。
    実行グループを再始動したり、実行グループに初めて何かをデプロイしたりすると、同じブローカーに接続しているあらゆる実行グループが新しい LIL、PDB、および JAR ファイルを検出することにもなるため、これらの 2 つの方法を使用する際には注意してください。 より標準的なブローカーの再始動方法を使用することにより、特定の実行グループに興味のあるユーザーが、ブローカーに最近変更があったことを確実に認識できるようになります。

    上記の 2 種類の状態では、その前のステップがすでに完了していること、およびそれに伴ってユーザー定義拡張機能ファイルが置かれているディレクトリーを、mqsichangebroker コマンドまたは mqsicreatebroker コマンドのいずれかを使用してブローカーに通知済みであるということを前提としています。

    ユーザー定義ノードをインストールすると、メッセージ・フローと同じように、ノードはスキーマと名前で参照されます。

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

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

as10009_