fteMigrateAgent ( エージェントを以降に移行）のみ WMQFTE 7.0 IBM WebSphere MQ 7.5 LTS

既存のエージェントとそれに関連する構成を IBM® WebSphere® MQ File Transfer Edition 7.0 から IBM WebSphere MQ 7.5 以降にマイグレーションする場合は、 fteMigrateAgent コマンドを使用してマイグレーションします。このコマンドは、標準エージェント、 Connect:Direct® エージェント、またはプロトコル・ブリッジ・エージェントをマイグレーションするために使用できます。また、このコマンドでは、複数のエージェントを単一の要求でマイグレーションすることも可能です。

注： Continuous Delivery の場合、 fteMigrateAgent コマンドは IBM MQ 9.2.1 で削除される。

[Long Term Support] このコマンドはまだ IBM MQ 9.2 Long Term Support で使用できる。

IBM MQ 9.0 より、 Managed File Transfer はウェブエージェントをサポートしていません。 fteMigrateAgent コマンドを使用してウェブエージェントを以前のリリースから IBM MQ 9.0 以降に移行しようとすると、ウェブエージェントの移行がサポートされていないことを説明するエラーメッセージが表示されます。

重要:

AIX®, Linux®, and Windows システム上で、サーバー・インストール・イメージを使用している場合、コマンドを実行するには、これらの条件を両方とも満たす必要があります： IBM MQ

IBM MQ の管理者になる。
mqm グループのメンバーである (システムに mqm グループが定義されている場合)。

そうでない場合は、エラーメッセージが表示されます。BFGCL0502E: You are not authorized to perform the requested operationこの制限は、 Redistributable Managed File Transfer Agent アーカイブを使用している場合は適用されません。

z/OS® システムの場合、コマンドを実行するためには、これらの条件の少なくとも1つを満たす必要がある：

mqm グループのメンバーである (システムに mqm グループが定義されている場合)。
BFG_GROUP_NAME環境変数で指定されたグループのメンバーになる（グループが指定されている場合）。
コマンドを実行する際に、BFG_GROUP_NAME環境変数に値が設定されていない。

注: IBM WebSphere MQ File Transfer Edition 7.0 以降からマイグレーションしていて、FTE_CONFIG 環境変数を引き続き使用したい場合は、FTE_CONFIG 値を変更せずにマイグレーションすることができます。標準マイグレーションを実行できますが、BFG_DATA を設定してはならず、FTE_CONFIG を IBM WebSphere MQ 7.0で使用されているように設定する必要があります。

[Windows] エージェントが Windows サービスとして実行するように構成されている場合、 fteModifyAgent コマンドを使用して、 Windows サービスでなくなるようにエージェントを再設定します。マイグレーションが完了した後、再度 fteModifyAgent コマンドを使用して、新しいエージェントが Windows サービスになるように構成します。あるいは、 -fパラメータを指定すると、コマンドは完了するが警告が表示される。

fteMigrateAgent コマンドを実行する前に、移行したいエージェントを fteStopAgent コマンドを使って停止する必要があります。

-f パラメーターを指定してコマンドを実行すると、エージェントに関する情報のみがリフレッシュされます。必要なファイルが見つからない場合、コマンドは失敗します。

具体的には、以下のプロパティー・ファイル、XML ファイル、およびそのエージェントに関連付けられているディレクトリーがマイグレーションされます。

表 1. fteMigrateAgent コマンドによってマイグレーションされるエージェント・ファイル
fteMigrateAgent コマンドによってマイグレーションされる各エージェントのファイル名	情報
wmqfte.properties	wmqfte.properties ファイルの名前が、IBM WebSphere MQ 7.5 以降で installation.properties に変更されました。
command.properties
coordination.properties
`coordination_queue_manager`.mqsc
`agent_name`_create.mqsc
`agent_name`_delete.mqsc
exits ディレクトリー	このコマンドは exits ディレクトリー内のすべてのファイルをコピーします。
標準エージェントにのみ適用:
UserSandboxes.xml
Connect:Direct ブリッジ・エージェントにのみ適用:
ConnectDirectCredentials.xml
ConnectDirectNodeProperties.xml
ConnectDirectProcessDefinitions.xml
プロトコル・ブリッジ・エージェントにのみ適用:
ProtocolBridgeCredentials.xml
ProtocolBridgeProperties.xml	このファイルは、 IBM WebSphere MQ File Transfer Edition 7.0.4 以降にのみ存在します。

fteMigrateAgent コマンドは、インストール・キュー・マネージャー、調整キュー・マネージャー、およびコマンド・キュー・マネージャーのファイルをマイグレーションし、それらのファイルが IBM WebSphere MQ 7.5 以降にまだ存在しない場合は IBM WebSphere MQ 7.5 以降にコピーします。それらのファイルが既に存在している場合、それらはこのコマンドでコピーされません。

Syntax

fteMigrateAgent

パラメーター

- agentName agent_name: 必須。 IBM WebSphere MQ 7.5 またはそれ以降にマイグレーションするエージェントの名前。
-config configuration_directory: 必須。エージェントのマイグレーション元となるインストール済み環境の構成ディレクトリーのパス。例えば、C:\Documents and Settings\All Users\Application Data\IBM\WMQFTE\config
- credentialPath credentials_path: 必須。資格情報のマイグレーション先の場所を定義します。このパラメーターは、既存の資格情報ファイルがあるディレクトリー・パスとするか、または新しい資格情報ファイルを受け取る新しい場所とすることができます。 z/OS プラットフォームでは、これは前もって存在する区分データ・セット拡張 (PDSE) とすることができます。そこでは、既存のメンバーを更新することになるか、または既存のメンバーはなく、資格情報のための新規メンバーを組み込むことになります。
注: PDSE を使用する場合は、可変ブロック化でなければなりません。
-f: オプション。通常マイグレーションされる構成ファイルの一部が既存の構成と競合する場合でも、エージェントを強制的にマイグレーションします。例えば、Managed File Transfer上のプロパティー・ファイルとIBM WebSphere MQ 7.5以降のプロパティー・ファイルの間に不一致がある場合、-f パラメーターを指定すると、この不一致は無視されます。
-p configuration_options: オプション。このパラメーターは、マイグレーション対象となる構成の位置指定に使用される構成オプションのセットを決定します。 -pパラメーターの値として、一連の構成オプションの名前を使用します。慣例により、これは調整キュー・マネージャーの名前です。このパラメーターを指定しない場合、デフォルトの構成オプションのセットが使用されます。詳細については、設定オプションを参照してください。
- ? または -h: オプション。コマンド構文を表示します。

例

次の例では、AGENT3 と /var/ibm/WMQFTE/config にあるその構成が、IBM WebSphere MQ 7.5 またはそれ以降にマイグレーションされます。

fteMigrateAgent -agentName AGENT3 -config /var/ibm/WMQFTE/config -credentialPath /home/user1/AGENT3

この例では、C:\Documents and Settings\All Users\Application Data\IBM\WMQFTE\config 内のすべてのエージェントとその構成が IBM WebSphere MQ 7.5 またはそれ以降にマイグレーションされます。 Windowsファイル・パスは、二重引用符 ("") で囲まれます。-f パラメーターは、マイグレーションを強制し、プロパティー・ファイルの不一致を無視するために指定されます。

fteMigrateAgent -agentName "*" -config "C:\Documents and Settings\All Users\Application Data\IBM\WMQFTE\config" 
-credentialPath "C:\Documents and Settings\user1\AGENT3" -p "configurationOption" -f

戻りコード

0: コマンドは正常に完了しました。
1: コマンドは失敗しました。

リターンコードの詳細については、 MFT のリターンコードを参照してください。