デプロイ可能リソースのマイグレーション

IBM® App Connect Enterprise では、既存のリソースを引き続きご利用いただけます。 ただし、旧バージョンで作成されたリソースを引き続き開発する場合は、それらをマイグレーションする必要があります。

このタスクの概要

以下の表は、開発を継続するために IBM App Connect Enterprise 13.0 へ移行する必要があるリソースの種類をまとめたものです。
表 1. 追加のマイグレーション・タスクを必要とする既存のリソース
バージョン 13.0で開発を続けるためのリソース バージョン 10.0 で作成されたリソース
メッセージ・セット メッセージ・セット開発用のメニューを使用可能にする必要があります ( メッセージ・セットのマイグレーションを参照)。
メッセージ・マップ バージョン 10.0にマイグレーションしたときに変換しなかった既存のメッセージ・マップについて、グラフィカル・データ・マップへのメッセージ・マップのマイグレーションを完了する必要があります。 バージョン 10.0 で作成される新規マップは、グラフィカル・データ・マップです。 メッセージ・マップのマイグレーションを参照してください。
メッセージ・フロー ご使用のメッセージ・フローに使用不能になったメッセージ・フロー・ノードが含まれている場合、使用可能なメッセージ・フロー・ノードを使用するように、そのメッセージ・フローを修正してください。 メッセージ・フローのマイグレーションを参照してください。
サブフロー バージョン 10.0にマイグレーションしたときに変換しなかった既存のサブフローのマイグレーションを完了する必要があります。 バージョン 10.0 で作成された新しいサブフローは、 .subflow ファイルとして作成されます。 サブフローのマイグレーションを参照してください。
カスタム統合アプリケーション IBM Integration APIを使用するアプリケーションがある場合は、それらのアプリケーションが正しいリソースにアクセスできることを確認してください。 カスタム統合アプリケーションのマイグレーションを参照してください。

メッセージ・セットのマイグレーション

このタスクの概要

プラットフォームに依存しないメッセージ・セットは、 WebSphere® Message Broker バージョン 6.0で導入されました。 統合ノード・バックアップ・ファイルに バージョン 6.0より前のリリースのメッセージ・セットが含まれている場合、そのメッセージ・セットは抽出されません。そのようなメッセージ・セットはプラットフォーム固有です。 このようなメッセージ・セットを含む BAR ファイルを再デプロイするか、メッセージ・セットまたは BAR ファイルを再ビルドして、プラットフォームに依存しないようにします。

IBM App Connect Enterprise では、アプリケーション、統合サービス、 およびライブラリに含まれるメッセージ・モデル・スキーマ・ファイルが、ほとんどのデータ形式においてメッセージをモデル化する推奨される方法です。 メッセージ・セットは MRM ドメインまたは IDOC ドメインを使用する場合に必要です。 メッセージのモデル化について詳しくは、 メッセージのモデル化の概念を参照してください。

以前のバージョンのメッセージセットを含むメッセージフローを、 IBM App Connect Enterprise ( 13.0 )にインポートすることができます。 既存のメッセージ・セットを通常の方法で表示、変更、およびデプロイすることができます。 ただし、デフォルトでは、新しいメッセージ・セットまたはメッセージ定義ファイルの作成に関するメニュー・オプションが非表示になっています。 これらのタスクを実行するには、まず「 IBM App Connect Enterprise Toolkit 」の環境設定でメッセージセットの開発機能を有効にする必要があります。 詳しくは、 メッセージ・セット開発の使用可能化を参照してください。

メッセージ・マップのマイグレーション

このタスクの概要

IBM App Connect Enterprise 13.0 メッセージフローに 「マッピング 」ノードを追加する際に使用される、グラフィカルなデータマッピング機能が含まれています。

メッセージマッピングを使用する以下のノードを含むメッセージフローを、 IBM App Connect Enterprise 13.0 にインポートできます:
  • DataDelete
  • DataInsert
  • DataUpdate
  • Extract
  • マッピング
  • Warehouse

これらのノード上のメッセージマップ (.msgmap) は表示できますが、 IBM App Connect Enterprise 13.0 では利用できないため、ランタイム環境にデプロイすることはできません。 メッセージ・マッピング操作は読み取り専用モードでのみアクセスでき、変更できず、デプロイもできません。

既存のメッセージ・マップ (.msgmap ファイル) を使用するメッセージ・フローをデプロイするには、まず既存のノードを新しい Mapping ノードに置き換える必要があります。 また、既存のメッセージ・マップを、新しい Mapping ノード (.map ファイル) で使用できるグラフィカル・データ・マップに変換する必要があります。 詳しくは、 .msgmap ファイルから .map ファイルへのメッセージ・マップの変換を参照してください。

メッセージ・フローのマイグレーション

このタスクの概要

で利用可能なメッセージフローノードは、移行元の IBM App Connect Enterprise 13.0 バージョンで利用可能なノードとは異なる場合があります。 メッセージフローに、利用できなくなったメッセージフローノードが含まれている場合は、 IBM App Connect Enterprise 13.0 で利用可能なメッセージフローノードのみを使用するように、それらを再構成する必要があります。

サブフローのマイグレーション

このタスクの概要

WebSphere Message Broker バージョン 8 以降、サブフローは .subflow ファイルとして作成します。

製品の以前のバージョンのサブフローは、.msgflow ファイルとして作成されています。 IBM App Connect Enterprise 13.0 で開発を続ける場合は、それらをファイル .subflow に変換する必要があります。 このサブフローは関数 「Convert to subflow」を使用して変換します。 詳しくは、 メッセージ・フローとサブフロー間の変換を参照してください。

カスタム統合アプリケーションのマイグレーション

このタスクの概要

既存の バージョン 10.0 カスタム統合アプリケーションは、バージョン 13.0 統合ノードで動作するように移行できます。 ただし、新規アプリケーションを作成する場合は、推奨されない com.ibm.broker.proxy.* ではなく com.ibm.integration.admin.proxy.* のクラスを使用してください。

IBM Integration API は、同期 REST 呼び出しによってサポートされるため、非同期ではなくなりました。 その結果、AdministeredObjectListener フレームワークは使用できなくなり、processModify()processDelete() コールバックも存在しません。 非推奨の実行グループ・プロキシー myExecutionGroupProxy.refresh() など、最新のプロパティー値を取得するには、プロキシー・オブジェクトのリフレッシュを呼び出す必要があります。

手順

  1. 統合ノードに接続するカスタム統合アプリケーションの場合、カスタム統合アプリケーションが使用する接続の詳細を、適切な統合ノードに接続するように更新します。

    では IBM App Connect Enterprise 13.0、接続 IBM 統合API はもはやに依存しなくなったため IBM MQ、接続はキュー IBM MQ を使用して確立されなくなりました。

  2. リモート統合ノードに接続する場合は、Web 管理ポートを使用するように接続詳細を更新します。 詳細については、 「 IBM App Connect Enterprise Webユーザーインターフェースの設定」 を参照してください。
    これらの接続で SSL を使用する方法については、 「Toolkitを使用した統合ノードへの接続」 を参照してください。 ローカル統合ノードに接続する場合は、直接ローカル接続を使用できます。
  3. 管理セキュリティが有効になっている場合、リモート接続を使用する統合アプリケーションでは IBM App Connect Enterprise 13.0、ユーザーの認証情報が必要となります。 接続がローカルの場合は、mqbkrs グループに含まれるユーザー ID でアプリケーションを実行する必要があります。 新しい統合アプリケーションの場合、アプリケーション開発時にユーザー詳細を指定できます。 既存のコンパイル済みアプリケーションの場合は、 カスタム統合アプリケーションからの統合ノードへの接続で説明されているいずれかの方法を使用して、セキュリティー資格情報を指定する必要があります。