FTPS Connector のバージョン 2.0 へのアップグレードおよび移行 - Mule 4

FTPS 用 Anypoint Connector (FTPS Connector) をバージョン 2.x.x にアップグレードします。

サポートされているアップグレードパス

開始バージョン 終了バージョン

1.8.x

2.0.x

このリリースでの変更

このリリースには、次の変更が含まれています。

  • このコネクタは、Java 17 との互換性を持つようになりました。

  • このコネクタは、FIPS 140-2 準拠になりました。

  • このコネクタは、コマンドチャネルからデータチャネルへの SSL セッションを再利用するためにリフレクションに依存しなくなりました。代わりに、外部から提供された Bouncy Castle ライブラリを使用したクライアントとホスト間の SSL セッション再開がサポートされるようになりました。これは、接続種別の新しい ​[Required Libraries (必須のライブラリ)]​ 項目で追加できます。詳細は、​「セッション再利用のための Java JDK の設定」​および​「Bouncy Castle ライブラリとセキュリティプロバイダーの設定」​を参照してください。

  • mule-file-commons​ モジュール連動関係が削除されました。

  • List​ 操作は、ファイルコンテンツではなくファイルパスを返すようになりました。

要件

アップグレードを実行する前に、次の要件を満たしていることを確認します。

アプリケーション/サービス バージョン

Mule

4.3.0 以降

制限事項

移行を実行する前に、次の既知の制限に注意してください。

  • セッションの再利用は、CloudHub の TLS 1.3 では適切に機能しません (以前のバージョンの FTPS Connector と同様)。

  • セキュリティプロバイダーはハードコードされており、同じ Java 仮想マシン (JVM) で実行されているすべての Mule アプリケーションがこれらのセキュリティ設定を共有します。

アップグレード前提条件

アップグレードを実行する前に、復元する必要がある場合に備えて、ファイル、データ、および設定のバックアップを作成します。

アップグレード手順

以下の手順でアップグレードを実行します。

  1. Anypoint Studio で、Mule プロジェクトを作成します。

  2. [Mule Palette (Mule パレット)]​ で、​[Search in Exchange (Exchange 内を検索)]​ をクリックします。

  3. [Add Dependencies to Project (連動関係をプロジェクトに追加)]​ で、検索項目に​「FTPS」​と入力します。

  4. [Available modules (使用可能なモジュール)]​ で、​[FTPS Connector]​ を選択して ​[Add (追加)]​ をクリックします。

  5. [Finish (完了)]​ をクリックします。

  6. Mule プロジェクトの ​pom.xml​ ファイルで FTPS Connector の ​mule-ftps-connector​ 連動関係バージョンがアップグレードしたバージョンであることを確認します。

Studio はコネクタを自動的にアップグレードします。

アップグレードを確認する

コネクタの最新バージョンをインストールしたら、次の手順に従ってアップグレードを確認します。

  1. Studio の ​[Problems (問題)]​ または ​[Console (コンソール)]​ ビューでエラーがないことを確認します。

  2. プロジェクトの ​pom.xml​ ファイルに問題がないことを確認します。

  3. 接続をテストして、操作が機能することを確認します。

アップグレードの取り消し

以前のバージョンの FTPS Connector に戻す必要がある場合、プロジェクトの ​pom.xml​ ファイルの ​mule-ftps-connector​ 連動関係バージョンを前のバージョンに変更します。 Anypoint Studio でプロジェクトの ​pom.xml​ ファイルを更新する必要があります。