IBM MQ Managed File Transfer (MFT) とは

IBM® MQ Managed File Transfer (MFT) は、信頼性の高い管理されたセキュアな方法で、システム間でファイルを転送します。 ファイル転送アクティビティーはログに記録され、アクティビティー・ロギングに使用できます。 Managed File Transfer エージェントを構成し、キュー・マネージャーが転送を実行できるようにすることができます。 Managed File Transfer (MFT) は、以下の 2 つのトポロジーを提供します。

1. 単一キュー・マネージャー・トポロジー: 単一のキュー・マネージャーをエージェント・キュー・マネージャー、コマンド・キュー・マネージャー、および調整キュー・マネージャーとして使用します。 これらの用語は、次のセクションで説明されています。

2. 複数キュー・マネージャー・トポロジー: エージェント・キュー・マネージャー、コマンド・キュー・マネージャー、および調整キュー・マネージャーとして機能する複数のキュー・マネージャーを使用します。 具体的には、このトポロジーには少なくとも 3 つのキュー・マネージャーが必要です。1 つは調整キュー・マネージャーの役割を果たすもの、1 つはソース・エージェント・キュー・マネージャー (Managed File Transfer エージェントを作成するため) とコマンド・キュー・マネージャーの役割を果たすもの、および宛先エージェント・キュー・マネージャー (別のファイル転送エージェントを作成するため) とコマンド・キュー・マネージャーとしての役割を果たすものです。

   注: 複数キュー・マネージャー・トポロジーでは、必要なキュー・マネージャーをすべてクラウド上で作成したり、すべてオンプレミスで作成したり、あるいは両方で作成したりできます。

MFT は、IBM MQ Advanced の統合コンポーネントです。 本製品の最新の完全な詳細については、IBM Knowledge Center の Managed File Transfer を参照してください。

IBM MFT のコンポーネント

IBM MQ Managed File Transfer には、3 つの主要コンポーネントがあります。 これらの 3 つのコンポーネントについて、以下で説明します。

1. 調整キュー・マネージャー: エージェント状況、転送状況、および転送アクティビティー情報の収集を担当します。
2. コマンド・キュー・マネージャー: MFT コマンドと MQ インフラストラクチャーをブリッジするインターフェース・キュー・マネージャー。 例えば、MFT ファイル転送コマンドを、転送の開始や取り消しをエージェントに指示するコマンド・キュー・マネージャーに送信します。
3. エージェント: 各エージェントには、キュー・マネージャー (エージェント・キュー・マネージャー) に関連付けられた独自のキューのセットがあり、転送されるファイルを送受信するためのキーとなります。 したがって、エージェントはファイルの転送元または転送先のシステムで作成されます。

このチュートリアルでは、以下について説明します。

1. MQ on Cloud キュー・マネージャーを MFT 調整キュー・マネージャー、コマンド・キュー・マネージャー、およびエージェント・キュー・マネージャーになるように構成してから、MFT エージェントを (ソース・エージェントまたは宛先エージェントとして) 作成します。 このチュートリアルでは、サポートされる両方のトポロジーのステップを示します。

   • 1.1: 単一キュー・マネージャー・トポロジー: 単一のキュー・マネージャーが、エージェント・キュー・マネージャー、コマンド・キュー・マネージャー、および調整キュー・マネージャーとして構成されます。
   • 1.2: 複数キュー・マネージャー・トポロジー: このトポロジーでは、複数のキュー・マネージャーが使用されます。

2. ファイル転送の実行

前提条件

このチュートリアルを進めるには、以下の前提条件を満たしていることが重要です。

1. MFT の基本的な知識: MFT と IBM MQ の連動の基本的な知識については、IBM Knowledge Center の MFT と IBM MQ の連動についてを参照してください。

   MFT について詳しくは、IBM Knowledge Center の Managed File Transfer を参照してください。

2. IBM MQ on Cloud キュー・マネージャーの作成

   IBM MQ on Cloud キュー・マネージャーがまだない場合は、以下のガイド付きツアーに従って作成できます。 IBM MQ on Cloud の概説 このガイド付きツアーに従うか、同じページに記載されている手動の手順を実行するか、既存の MQ on Cloud キュー・マネージャーを使用すれば、以下を用意できるはずです。

   • MQ on Cloud キュー・マネージャー
   • connection_info.txt ファイルとしてダウンロードされた接続の詳細
     • このファイルがない場合は、このチュートリアルの最後にある付録 1 を参照してください。
   • platformApiKey.json ファイルとしてダウンロードされた管理ユーザー名と API キー
     • このファイルがない場合は、このチュートリアルの最後にある付録 2 を参照してください。

3. IBM MQ Client: このチュートリアルを完了するには、IBM MQ コマンド・ライン・ツール「runmqsc」がインストールされ、PATH にある必要があります。 これらのコマンドがない場合は、IBM MQ Client をインストールすることによって入手できます。 この方法については、このチュートリアルの最後にある付録 3 で詳しく説明しています。

4. IBM MQ MFT コンポーネント: IBM MQ MFT コンポーネントをインストールするには、IBM Knowledge Center の Managed File Transfer のインストールを参照してください。

端末環境のセットアップ

1. 端末ウィンドウを開く

   • この端末は、調整キュー・マネージャーの構成に使用される管理端末になります。

2. 以下のステップを実行して、キュー・マネージャーの詳細を管理端末の MQSERVER 環境変数に指定します。

   • runmqsc CLI では、接続先のリモート・キュー・マネージャーを識別する環境変数を設定する必要があります。 管理端末で、次のコマンドを使用して、MQSERVER 変数をエクスポートします。

   • Windows の場合: SET MQSERVER=CLOUD.ADMIN.SVRCONN/TCP/<HOSTNAME>(<PORT>)

   • Linux の場合: export MQSERVER="CLOUD.ADMIN.SVRCONN/TCP/<HOSTNAME>(<PORT>)"

     • <HOSTNAME> - これは connection_info.txt ファイル内の「hostname」です。
     • <PORT> - これは connection_info.txt ファイル内の「listenerPort」です。

このステップは、runmqsc cli を使用する場合など、キュー・マネージャーのリモート管理に使用されるすべての新しい端末で必要です。

ステップ 1: MQ on Cloud キュー・マネージャーを Managed File Transfer (MFT) 用に構成する

このセクションでは、MQ on Cloud キュー・マネージャーをエージェント・キュー・マネージャーとして構成する方法について説明します。 この構成には、広く使用されているトポロジーが 2 つあります。 いずれかの構成を選択してから、該当するセクションに従ってください。

• 1.1. 単一キュー・マネージャー・トポロジー: このトポロジーでは、同じキュー・マネージャーがすべての MFT 操作を実行するように構成されます。 このようにするために、このキュー・マネージャーを調整キュー・マネージャー、コマンド・キュー・マネージャー、およびエージェント・キュー・マネージャーとして構成します。 ここをクリックして、ステップに従います。

• 1.2. 複数キュー・マネージャー・トポロジー: このトポロジーでは、MFT 操作を実行するキュー・マネージャーを 3 つ作成します。 これらの名前は QMCOORD、QMSRC、および QMDEST とします。 ここをクリックして、ステップに従います。

ステップ 2: ファイル転送を開始する

このセクションでは、ファイル転送を実行して MFT セットアップを検証します。 現時点では、MFT コマンド・ライン・インターフェース (CLI) を使用するか、MQ エクスプローラー・ツールの「MFT」タブを使用して、MFT ファイル転送を作成できます。 このチュートリアルでは、MFT CLI を使用したファイル転送について説明します。 fteCreateTransfer コマンドは、コマンド・ラインから新規のファイル転送を作成して開始します。 このコマンドは、ファイル転送の即時開始、将来の日時におけるファイル転送のスケジュール、ファイル転送の 1 回以上の繰り返し、および特定の条件に基づくファイル転送の起動を実行できます。

このチュートリアルでは、簡略化するために、即時転送のみを作成します。 こちらの指示に従って、転送を開始します。

転送について詳しくは、この MFT Knowledge Center のリンクを参照してください。

付録

<?xml version="1.0" encoding="UTF-8"?>

<?xml version="1.0" encoding="UTF-8"?>
<tns:mqmftCredentials xmlns:tns="http://wmqfte.ibm.com/MQMFTCredentials" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://wmqfte.ibm.com/MQMFTCredentials MQMFTCredentials.xsd">
<tns:qmgr name="<QUEUE_MANAGER_NAME>" mqUserId="<ADMIN_MQ_USER>" mqPassword="<ADMIN_API_KEY>" useMQCSPAuthentication="true" />
</tns:mqmftCredentials>

- `<ADMIN_MQ_USER>` - this is 'mqUsername' in the file platformApiKey.json of your queue manager.
- `<QUEUE_MANAGER_NAME>` - this is 'queueManagerName' in the file connection_info.json of your queue manager.