Redistributable Managed File Transfer Agent の初期構成の作成

既存の IBM® MQ 構成に接続するように Managed File Transfer Agent を構成できます。

始める前に

必ず、 Redistributable Managed File Transfer Agent パッケージの内容をダウンロードして解凍してください。詳しくは、再配布可能ファイル転送管理エージェントの構成を参照してください。

本タスクについて

最初に、 Redistributable Managed File Transfer Agent が必要とする環境を作成します。その後、 IBM MQ サーバー上で実行されているキュー・マネージャーとの接続をセットアップし、エージェントとエージェント・キュー・マネージャーを構成してから、エージェントを開始して検証することができます。

手順

Redistributable Managed File Transfer Agentの環境を作成します。
fteCreateEnvironment コマンドを実行すると、 MFT エージェントの構成情報を含む MFT データ・ディレクトリーが作成されます。ダウンロードした MFT Agent 再配布可能コンポーネントを解凍したときに作成された bin ディレクトリーにいることを確認します。以下のコマンドを実行します。
- ```
fteCreateEnvironment.cmd -d datapath location
```
- ```
. ./fteCreateEnvironment -d datapath location
```
  このコマンドには以下のオプション・パラメーターがあります。
  -d
  
  このパラメーターは、 MFT 構成が作成、保管、および保守されるデータ・パスの場所を指定します。データの場所を指定せずに fteCreateEnvironment を実行すると、 Redistributable Managed File Transfer Agent が解凍された場所にディレクトリー mftdata が作成されます。
  注: 再配布可能エージェントを Windows サービスとして実行する場合、サービスを機能させるには、システム環境で BFG_DATA 環境変数を設定する必要があります。
  
  -n インストール名
  
  このパラメーターは、 IBM MQ インストール済み環境の名前、または固有の名前を指定するために使用されます。
  
  このパラメーターを使用すると良い状況としては、例えば次のような状況があります。
  
  エージェントがクライアント・モードだけでキュー・マネージャーに接続するという既存の構成で、再配布可能パッケージを使用して新機能または新フィーチャーを素早くテストしたい場合 (このパラメーターは、バインディング・モードでキュー・マネージャーに接続するように構成したエージェントには適用されません)。
  
  標準 Managed File Transfer インストール済み環境から Redistributable Managed File Transfer Agent パッケージにマイグレーションする場合、標準インストール済み環境で作成された構成と同じ構成を使用する必要があります。これは、標準 Managed File Transfer がインストールされているが、別のマシンで実行されているエージェント・キュー・マネージャーに接続している場合です。
  
  デフォルトのインストール名変数は BFG_INSTALLATION_NAME です。
  fteCreateEnvironment コマンドの詳細については、 fteCreateEnvironment （ Redistributable Managed File Transfer Agent 用の環境設定）を参照してください。
次のようにデータ・パスの場所を指定して環境変数 BFG_DATA を設定することもできます。
```
BFG_DATA=Datapath location
```
エージェントの作成、開始、停止、およびそのほかのコマンドを実行する前に、BFG_DATA 変数に正しいデータ・パスの場所が設定されていることを確認してください。
IBM MQ 接続をセットアップします。
1. fteSetupCoordination コマンドを使用して、調整キュー・マネージャーをセットアップします。
  fteSetupCoordination コマンドは、調整キュー・マネージャーに必要なセットアップ、および詳細な構成に必要なディレクトリーを作成します。 Redistributable Managed File Transfer Agent はクライアント・モードで動作するため、バインディング・モードはサポートされていないため、エラーを回避するためにこのコマンドに追加のパラメーターを指定する必要があります。
```
fteSetupCoordination -coordinationQMgr PRMFTDEMO2 
              -coordinationQMgrHost 9.121.59.233 -coordinationQMgrPort 3002 
              -coordinationQMgrChannel SYSTEM.DEF.SVRCONN
```
  fteSetupCoordination コマンドの詳細と使用方法については fteSetupCoordination を参照してください。調整キュー・マネージャーの構成方法については、 MFT 用の調整キュー・マネージャーの構成を参照してください。
2. コマンド・キュー・マネージャーを作成し、セットアップします。
```
fteSetupCommands -p PRMFTDEMO2 -connectionQMgrHost 9.121.59.233 
              -connectionQMgrPort 3002 -connectionQMgrChannel SYSTEM.DEF.SVRCONN 
              -connectionQMgr PRMFTDEMO2 -f
```
  fteSetupCommands コマンドの詳細と使用方法については fteSetupCommands: : MFT command.propertiesを作成するを参照してください。
エンドポイントの MFT エージェント定義を作成します。
```
fteCreateAgent -p PRMFTDEMO2 -agentQMgrHost 9.121.59.233  
            -agentQMgrPort 3002 -agentQMgrChannel SYSTEM.DEF.SVRCONN 
            -agentName AGENT.TRI.BANK -agentQMgr PRMFTDEMO2 -f
```
fteCreateAgent コマンドを使用してエージェントとエージェントキューマネージャを設定する方法の詳細については、 fteCreateAgent を参照してください。
エージェントごとに、ステップ 2 および 3 で、エージェント・キュー・マネージャー上にキュー定義とトピック定義を作成します。
エージェントを開始すれば、ファイルを転送するための準備は完了です。
```
fteStartAgent -p PRMFTDEMO2 AGENT.TRI.BANK
```
以下のコマンドを実行して、エージェントの状況を確認できます。
```
fteListAgents
```
fteListAgents コマンドの使用方法の詳細については fteListAgents を参照してください。