IBM Cloud Docs
用于 Managed File Transfer 的多队列管理器拓扑

用于 Managed File Transfer 的多队列管理器拓扑

步骤 1.2 多队列管理器拓扑

您应该已阅读过此链接中提供的信息。 接下来我们将使用多个队列管理器，分别充当代理队列管理器、命令队列管理器和协调队列管理器。

假设有三个不同的 MQ on Cloud 队列管理器。

配置详细信息：

我们将使用三个 MQ on Cloud 队列管理器，并将其命名为 QMCOORD、QMSRC 和 QMDEST；它们分别用作协调队列管理器、源代理队列管理器和目标代理队列管理器。 此外，还将创建两个 Managed File Transfer 代理，并将其命名为 SRC_AGENT 和 DEST_AGENT。

  • QMCOORD 队列管理器充当协调队列管理器。
  • MQ on Cloud 上的 QMSRC 队列管理器充当源代理队列管理器和命令队列管理器。
  • MQ on Cloud 上的 QMDEST 队列管理器充当目标代理队列管理器和命令队列管理器。
  • SRC_AGENT 源代理与 QMSRC 代理队列管理器相连接。
  • DEST_AGENT 目标代理与 QMDEST 代理队列管理器相连接。

在以上配置中，假设已满足以下条件：

  1. 将代理队列管理器配置为源代理和目标代理的命令队列管理器。 这是 MFT 中的一般建议，因为这样做可使特定代理的 MFT 命令转至其自己的队列管理器。 MFT 命令可以针对代理的队列管理器运行。
  2. 在本教程中，我们将使用 3 个不同的系统。 System 1 用于配置协调队列管理器，System 2 用于配置源代理队列管理器，System 3 用于配置目标代理队列管理器。
  3. 必须连接协调队列管理器和代理队列管理器，才能进行各种通信。 所有三个队列管理器都可以使用 MQ 集群或发送方/接收方通道进行连接。 在此演示中，我们考虑使用发送方/接收方通道配置。
  4. 在所有系统上，使用的都是具有管理特权的概要文件。

**注：**在下面记录的步骤中，将创建 MQ 通道和 MQ 队列，以供队列管理器用于相互通信。 创建这些 MQ 资源时，将提供对这些对象的相应访问权和许可权。请参阅 MQ 安全性机制。

先决条件：

现在，将创建三个 MQ on Cloud 队列管理器：

  1. 创建新的 MQ on Cloud 队列管理器，将其命名为 QMCOORD，然后下载连接详细信息（将此文件另存为 coordinationQMgrConnectionDetails.json）。 执行相同的步骤（如“先决条件”的步骤 2 中所建议）。
  2. 创建新的 MQ on Cloud 队列管理器，将其命名为 QMSRC，然后下载其连接详细信息（将此文件另存为 sourceAgentQMgrConnectionDetails.json）。 执行相同的步骤（如“先决条件”的步骤 2 中所建议）。
  3. 创建新的 MQ on Cloud 队列管理器，将其命名为 QMDEST，然后下载其连接详细信息（将此文件另存为 destinationAgentQMgrConnectionDetails.json）。 执行相同的步骤（如“先决条件”的步骤 2 中所建议）。
  4. 我们正在使用三种不同的计算机，然后将命名为 SYSTEM 1，SYSTEM 2 和 SYSTEM 3。 这些系统将用于设置受管文件传输队列管理器。

**注：**下载并存储私钥 API 密钥。 使用云队列管理器进行认证时，可以使用相同的 API 密钥。

此图显示在 IBM Cloud中创建的 "多个队列管理器"。

  1. 转至 SYSTEM 1 终端并打开管理终端，将此终端命名为 Terminal 1。 通过执行以下命令将 QMCOORD 配置为协调队列管理器:

    • 4.1 在管理终端中将协调队列管理器详细信息指定为 MQSERVER 环境变量

      • runmqsc CLI 需要设置环境变量，以标识它应该连接到的远程队列管理器。 在管理终端中，使用以下命令导出 MQSERVER 变量：

        • 对于 Windows: SET MQSERVER=CLOUD.ADMIN.SVRCONN/TCP/<HOSTNAME>(<PORT>)
        • 对于 Linux: export MQSERVER="CLOUD.ADMIN.SVRCONN/TCP/<HOSTNAME>(<PORT>)"
          • <HOSTNAME>-这是文件 coordinationQMgrConnectionDetails.json 中的 "hostname"
          • <PORT>-这是 coordinationQMgrConnectionDetails.json 文件中的 "listenerPort"

    • 4.2 fteSetupCoordination -coordinationQMgr <queueManagerName> -coordinationQMgrHost <queueManagerHostname> -coordinationQMgrPort <queueManagerPort> -coordinationQMgrChannel <queueManagerChannel> -credentialsFile <filePath> -default

      • <queueManagerName>-这是文件 connection_info.txt 中的 "queueManagerName"

      • <queueManagerHostname>-这是 connection_info.txt 文件中的 "hostname"

      • <queueManagerPort>-这是文件 connection_info.txt 中的 "listenerPort"

      • <queueManagerChannel>-这是文件 connection_info.txt 中的 "adminChannelName"

      • <filePath>-这是凭证文件所在的 "filePath"

        例如 -

        • Windows：C:\Users\Administrator\MQMFTCredentials.xml
        • Linux: /home/usr/MQMFTCredentials.xml
        • 有关更多详细信息，请参阅附录 4

      • -default - 可选。 将缺省配置选项更新为与此命令中指定的协调队列管理器相关联的选项

      • 例如 -

        • (对于 Windows): fteSetupCoordination -coordinationQMgr QMCOORD -coordinationQMgrHost qmcoord-749b.qm2.us-preprod.appdomain.cloud -coordinationQMgrPort 31211 -coordinationQMgrChannel CLOUD.ADMIN.SVRCONN -credentialsFile "C:\Users\Administrator\MQMFTCredentials.xml" -default -f
        • for linux: fteSetupCoordination -coordinationQMgr QMCOORD -coordinationQMgrHost qmcoord-749b.qm2.us-preprod.appdomain.cloud -coordinationQMgrPort 31211 -coordinationQMgrChannel CLOUD.ADMIN.SVRCONN -credentialsFile "/home/document/MQMFTCredentials.xml" -default -f

        此图显示将队列管理器配置为协调队列管理器的 "fteSetup协调" 命令

    • 4.3 运行 runmqsc 以连接到远程队列管理器

      • <ADMIN_MQ_USER>-这是 platformApiKey.json 文件中的 "mqUsername"

      • <QUEUE_MANAGER_NAME>-这是文件 coordinationQMgrConnectionDetails.json 中的 "queueManagerName"

      • -c 使用 MQSERVER 变量通知 runmqsc 应该连接到远程队列管理器

      • 例如 runmqsc -c -u mamgainp -w60 QMCOORD

    • 4.4 创建要用作协调队列管理器的队列管理器所需的 MQ 对象，此管理器将 MQ on Cloud 队列管理器设定为目标

      • 将在位置 MQ_DATA_PATH\mqft\config\coordination_qmgr_name\<coordination_qmgr_name>.mqsc 创建 mqsc 文件。 您应该将此文件的内容复制并粘贴到终端中。

    此图显示用于创建协调队列管理器所需的 MQ 对象的 "runmqsc" 命令

  2. 在协调队列管理器（即 QMCOORD）上创建通道和必需的对象，以用于 QMSRC 与 QMDEST 之间的通信。 使用 Terminal 1 执行所有这些步骤。

    • 5.1 在管理终端中将协调队列管理器详细信息指定为 MQSERVER 环境变量

      • runmqsc CLI 需要设置环境变量，以标识它应该连接到的远程队列管理器。 在管理终端中，使用以下命令导出 MQSERVER 变量：

        • 对于 Windows: SET MQSERVER=CLOUD.ADMIN.SVRCONN/TCP/<HOSTNAME>(<PORT>)
        • 对于 Linux: export MQSERVER="CLOUD.ADMIN.SVRCONN/TCP/<HOSTNAME>(<PORT>)"
          • <HOSTNAME>-这是文件 coordinationQMgrConnectionDetails.json 中的 "hostname"
          • <PORT>-这是 coordinationQMgrConnectionDetails.json 文件中的 "listenerPort"
    • 5.2 运行 runmqsc 以连接到远程队列管理器

      • <ADMIN_MQ_USER>-这是 platformApiKey.json 文件中的 "mqUsername"

      • <QUEUE_MANAGER_NAME>-这是文件 coordinationQMgrConnectionDetails.json 中的 "queueManagerName"

      • -c 使用 MQSERVER 变量通知 runmqsc 应该连接到远程队列管理器

      • 例如 runmqsc -c -u mamgainp -w60 QMCOORD

    • 5.3 在 CLI 中执行以下命令：
      • DEF QL(QMSRC) USAGE(XMITQ)
      • DEF QL(QMDEST) USAGE(XMITQ)
      • DEF CHANNEL(QMCOORD_TO_QMSRC) CHLTYPE(SDR) CONNAME('<HOSTNAME_OF_QMSRC>(<PORT_OF_QMSRC>)') XMITQ(QMSRC) REPLACE
        • 例如 : DEF CHANNEL(QMCOORD_TO_QMSRC) CHLTYPE(SDR) CONNAME('qmsrc-749b.qm2.us-preprod.appdomain.cloud(30339)') XMITQ(QMSRC) REPLACE
      • DEF CHANNEL(QMSRC_TO_QMCOORD) CHLTYPE(RCVR) REPLACE
      • DEF CHANNEL(QMCOORD_TO_QMDEST) CHLTYPE(SDR) CONNAME('<HOSTNAME_OF_QMDEST>(<PORT_OF_QMDEST>)') XMITQ(QMDEST) REPLACE
        • 例如 : DEF CHANNEL(QMCOORD_TO_QMDEST) CHLTYPE(SDR) CONNAME('qmdest-749b.qm.us-preprod.appdomain.cloud(31193)') XMITQ(QMDEST) REPLACE
      • DEF CHANNEL(QMDEST_TO_QMCOORD) CHLTYPE(RCVR) REPLACE

    此图显示在 IBM Cloud中创建的 "多个队列管理器"。

    • 5.4 不要关闭此终端，因为还必须使用此终端来启动通道（在后续步骤中）

  3. 转至系统 2，在系统上打开新终端，并将此终端命名为 终端 2。 在 QMSRC 上创建通道和必需对象。

    • 6.1 在管理终端中将源代理队列管理器详细信息指定为 MQSERVER 环境变量

      • runmqsc CLI 需要设置环境变量，以标识它应该连接到的远程队列管理器。 在管理终端中，使用以下命令导出 MQSERVER 变量：

        • 对于 Windows: SET MQSERVER=CLOUD.ADMIN.SVRCONN/TCP/<HOSTNAME>(<PORT>)
        • 对于 Linux: export MQSERVER="CLOUD.ADMIN.SVRCONN/TCP/<HOSTNAME>(<PORT>)"
          • <HOSTNAME>-这是 sourceAgentQMgrConnectionDetails.json 文件中的 "hostname"
          • <PORT>-这是文件 sourceAgentQMgrConnectionDetails.json 中的 "listenerPort"

    • 6.2 运行 runmqsc 以连接到远程队列管理器

      • <ADMIN_MQ_USER>-这是 platformApiKey.json 文件中的 "mqUsername"

      • <QUEUE_MANAGER_NAME>-这是文件 sourceAgentQMgrConnectionDetails.json 中的 "queueManagerName"

      • -c 使用 MQSERVER 变量通知 runmqsc 应该连接到远程队列管理器

      • 例如 runmqsc -c -u mamgainp -w60 QMSRC

    • 6.3 在 CLI 中执行以下命令：

      • DEF QL(QMDEST) USAGE(XMITQ)
      • DEF QL(QMCOORD) USAGE(XMITQ)
      • DEF CHANNEL(QMSRC_TO_QMDEST) CHLTYPE(SDR) CONNAME('<HOSTNAME_OF_QMDEST>(<PORT_OF_QMDEST>)') XMITQ(QMDEST) REPLACE
        • 例如 : DEF CHANNEL(QMSRC_TO_QMDEST) CHLTYPE(SDR) CONNAME('qmdest-749b.qm.us-preprod.appdomain.cloud(31193)') XMITQ(QMDEST) REPLACE
      • DEF CHANNEL(QMDEST_TO_QMSRC) CHLTYPE(RCVR) REPLACE
      • DEF CHANNEL(QMSRC_TO_QMCOORD) CHLTYPE(SDR) CONNAME('<HOSTNAME_OF_QMCOORD>(<PORT_OF_QMCOORD>)') XMITQ(QMCOORD) REPLACE
        • 例如 : DEF CHANNEL(QMSRC_TO_QMCOORD) CHLTYPE(SDR) CONNAME('qmcoord-749b.qm2.us-preprod.appdomain.cloud(31211)') XMITQ(QMCOORD) REPLACE
      • DEF CHANNEL(QMCOORD_TO_QMSRC) CHLTYPE(RCVR) REPLACE

    • 6.4 不要关闭此终端，因为还必须使用此终端来启动通道（在后续步骤中）

  4. 转至系统 3，在系统上打开新终端，并将此终端命名为 终端 3。 在 QMDEST 上创建通道和必需对象。

    • 7.1 在管理终端中将目标代理队列管理器详细信息指定为 MQSERVER 环境变量。

      • runmqsc CLI 需要设置环境变量，以标识它应该连接到的远程队列管理器。 在管理终端中，使用以下命令导出 MQSERVER 变量：

        • 对于 Windows: SET MQSERVER=CLOUD.ADMIN.SVRCONN/TCP/<HOSTNAME>(<PORT>)
        • 对于 Linux: export MQSERVER="CLOUD.ADMIN.SVRCONN/TCP/<HOSTNAME>(<PORT>)"
          • <HOSTNAME>-这是文件 destinationAgentQMgrConnectionDetails.json 中的 "hostname"
          • <PORT>-这是文件 destinationAgentQMgrConnectionDetails.json 中的 "listenerPort"

    • 7.2 运行 runmqsc 以连接到远程队列管理器

      • <ADMIN_MQ_USER>-这是 platformApiKey.json 文件中的 "mqUsername"

      • <QUEUE_MANAGER_NAME>-这是文件 destinationAgentQMgrConnectionDetails.json 中的 "queueManagerName"

      • -c 使用 MQSERVER 变量通知 runmqsc 应该连接到远程队列管理器

      • 例如 runmqsc -c -u mamgainp -w60 QMDEST

    • 7.3 在 CLI 中执行以下命令：

      • DEF QL(QMSRC) USAGE(XMITQ)
      • DEF QL(QMCOORD) USAGE(XMITQ)
      • DEF CHANNEL(QMDEST_TO_QMSRC) CHLTYPE(SDR) CONNAME('<HOSTNAME_OF_QMSRC>(<PORT_OF_QMSRC>)') XMITQ(QMSRC) REPLACE
        • 例如 : DEF CHANNEL(QMDEST_TO_QMSRC) CHLTYPE(SDR) CONNAME('qmsrc-749b.qm2.us-preprod.appdomain.cloud(30339)') XMITQ(QMSRC) REPLACE
      • DEF CHANNEL(QMSRC_TO_QMDEST) CHLTYPE(RCVR) REPLACE
      • DEF CHANNEL(QMDEST_TO_QMCOORD) CHLTYPE(SDR) CONNAME('<HOSTNAME_OF_QMCOORD>(<PORT_OF_QMCOORD>)') XMITQ(QMCOORD) REPLACE
        • 例如 : DEF CHANNEL(QMDEST_TO_QMCOORD) CHLTYPE(SDR) CONNAME('qmcoord-749b.qm2.us-preprod.appdomain.cloud(31211)') XMITQ(QMCOORD) REPLACE
      • DEF CHANNEL(QMCOORD_TO_QMDEST) CHLTYPE(RCVR) REPLACE

    • 7.4 不要关闭此终端，因为还必须使用此终端来启动通道（在后续步骤中）

  5. 在所有系统上启动通道

    • 8.1 转至 Terminal 1，此终端连接到 QMCOORD（即，协调队列管理器）

      • 8.1.1. 在 CLI 中执行以下命令：
        • START CHANNEL(QMCOORD_TO_QMSRC)
        • START CHANNEL(QMCOORD_TO_QMDEST)

      此图显示在 IBM Cloud中创建的 "多个队列管理器"。

    • 8.2 转至 Terminal 2，此终端连接到 QMSRC（即，源代理队列管理器）

      • 8.2.1. 在 CLI 中执行以下命令：
        • START CHANNEL(QMSRC_TO_QMDEST)
        • START CHANNEL(QMSRC_TO_QMCOORD)

      此图显示在 IBM Cloud中创建的 "多个队列管理器"。

    • 8.3 转至 Terminal 3，此终端连接到 QMDEST（即，目标代理队列管理器）

      • 8.3.1. 在 CLI 中执行以下命令：
        • START CHANNEL(QMDEST_TO_QMSRC)
        • START CHANNEL(QMDEST_TO_QMCOORD)

      此图显示在 IBM Cloud中创建的 "多个队列管理器"。

  6. 转至 终端 2。 将 QMSRC 设置为代理队列管理器和命令队列管理器

    • 9.1 此系统需要知道它要连接到的协调队列管理器

      • execute 命令 fteSetupCoordination -coordinationQMgr <queueManagerName> -coordinationQMgrHost <queueManagerHostname> -coordinationQMgrPort <queueManagerPort> -coordinationQMgrChannel <queueManagerChannel> -credentialsFile <filePath> -default
        • 例如 : fteSetupCoordination -coordinationQMgr QMCOORD -coordinationQMgrHost qmcoord-749b.qm2.us-preprod.appdomain.cloud -coordinationQMgrPort 31211 -coordinationQMgrChannel CLOUD.ADMIN.SVRCONN -credentialsFile "C:\Users\Administrator\MQMFTCredentials.xml" -default -f

    • 9.2 将 QMSRC 配置为代理的命令队列管理器

      • execute 命令 fteSetupCommands -p <configurationName> -connectionQMgr <sourceAgentQueueManagerName> -connectionQMgrHost <agentQueueManagerHost> -connectionQMgrPort <agentQueueManagerPort> -connectionQMgrChannel <queueManagerChannel> -credentialsFile <filePath> -f

        • agentQueueManagerHost-必需。这是 SourceAgentQueueManager 的 connection_info.txt 文件中的 "hostname"。

        • agentQueueManagerPort-必需。这是 SourceAgentQueueManager 的 connection_info.txt 文件中的 "listenerPort"。

        • agentQueueManagerChannel-必需。这是 SourceAgentQueueManager 的 connection_info.txt 文件中的 "adminChannelName"。

        • configurationOptions - 根据约定，这是协调队列管理器的名称

        • <filePath>-这是凭证文件所在的 "filePath" 例如- C:\Users\Administrator\MQMFTCredentials.xml 请参阅 附录 4 以获取更多详细信息

        • -f - 可选。 强制该命令覆盖现有配置。

        • 例如 : fteSetupCommands -p QMCOORD -connectionQMgr QMSRC -connectionQMgrHost qmsrc-749b.qm2.us-preprod.appdomain.cloud -connectionQMgrPort 30339 -connectionQMgrChannel CLOUD.ADMIN.SVRCONN -credentialsFile "C:\Users\Administrator\MQMFTCredentials.xml" -f

        显示 "fteSetup协调" 命令和 "fteSetup命令" 的图像

    • 9.3. 在 Terminal 2 中，运行以下命令以创建 SRC_AGENT（源代理）：

      • fteCreateAgent -agentName <agentName> -agentQMgr <agentQueueManager> -agentQMgrHost <agentQueueManagerHost> -agentQMgrPort <agentQueueManagerPort> -agentQMgrChannel <agentQueueManagerChannel> -p <configurationOptions> -f -credentialsFile <filePath>
        • agentName - 必需。 要创建的代理的名称。
        • agentQueueManager - 必需。 代理的队列管理器的名称。这是 SourceAgentQueueManager 的 connection_info.txt 文件中的“queueManagerName”。
        • agentQueueManagerHost-必需。这是 SourceAgentQueueManager 的 connection_info.txt 文件中的 "hostname"。
        • agentQueueManagerPort-必需。这是 SourceAgentQueueManager 的 connection_info.txt 文件中的 "listenerPort"。
        • agentQueueManagerChannel-必需。这是 SourceAgentQueueManager 的 connection_info.txt 文件中的 "adminChannelName"。
        • configurationOptions - 根据约定，这是协调队列管理器的名称
        • <filePath>-这是凭证文件所在的 "filePath" 例如- C:\Users\Administrator\MQMFTCredentials.xml 请参阅 附录 4 以获取更多详细信息
        • -f - 可选。 强制该命令覆盖现有配置。
        • 例如 : fteCreateAgent -agentName SRC_AGENT -agentQMgr QMSRC -agentQMgrHost qmsrc-749b.qm2.us-preprod.appdomain.cloud -agentQMgrPort 30339 -agentQMgrChannel CLOUD.ADMIN.SVRCONN -p QMCOORD -credentialsFile "C:\Users\Administrator\MQMFTCredentials.xml" -f

    • 9.4 运行 runmqsc 以连接到远程队列管理器

      • <ADMIN_MQ_USER>-这是 platformApiKey.json 文件中的 "mqUsername"

      • <QUEUE_MANAGER_NAME>-这是文件 sourceAgentQMgrConnectionDetails.json 中的 "queueManagerName"

      • -c 使用 MQSERVER 变量通知 runmqsc 应该连接到远程队列管理器

      • 例如 runmqsc -c -u mamgainp -w60 QMSRC

    • 9.5 终端将提示您输入密码

      • This is your <ADMIN_API_KEY> = 'apiKey' in the file platformApiKey.json of QMSRC.

    • 9.6 现在，终端在等待进行输入

    • 9.7 创建要用作代理队列管理器的队列管理器所需的 MQ 对象，此管理器将 MQOC 队列管理器设定为目标。

      • 将在位置 MQ_DATA_PATH\mqft\config\coordination_qmgr_name\agents\agent_name\agent_name_create.mqsc 创建 mqsc 文件。 您应该将此文件的内容复制并粘贴到 Terminal 2 中。

    • 9.8. 使用以下命令启动上面创建的代理

      • fteStartAgent -p <configurationOptions> <agentName> 其中

        • configurationOptions - 根据约定，这是协调队列管理器的名称
        • agentName-必需。要启动的 IBM MQ Managed File Transfer 代理的名称。
        • 例如 : fteStartAgent -p QMCOORD SRC_AGENT

        此图显示针对云队列管理器运行的 "fteStartAgent" 命令

  7. 转至 Terminal 3，然后重复相同的步骤并创建 DEST_AGENT：

  • 10.1 此系统需要知道它要连接到的协调队列管理器

    • execute 命令 fteSetupCoordination -coordinationQMgr <queueManagerName> -coordinationQMgrHost <queueManagerHostname> -coordinationQMgrPort <queueManagerPort> -coordinationQMgrChannel <queueManagerChannel> -credentialsFile <filePath> -default

      • 例如 : fteSetupCoordination -coordinationQMgr QMCOORD -coordinationQMgrHost qmcoord-749b.qm2.us-preprod.appdomain.cloud -coordinationQMgrPort 31211 -coordinationQMgrChannel CLOUD.ADMIN.SVRCONN -credentialsFile "C:\Users\Administrator\MQMFTCredentials.xml" -default -f

  • 10.2 将 QMDEST 配置为代理的命令队列管理器

    • execute 命令 fteSetupCommands -p <configurationName> -connectionQMgr <DestinationAgentQueueManager> -connectionQMgrHost <agentQueueManagerHost> -connectionQMgrPort <agentQueueManagerPort> -connectionQMgrChannel <queueManagerChannel> -credentialsFile <filePath> -f

      • agentQueueManagerHost-必需。这是 DestinationAgentQueueManager 的 connection_info.txt 文件中的 "hostname"。

      • agentQueueManagerPort-必需。这是 DestinationAgentQueueManager 的 connection_info.txt 文件中的 "listenerPort"。

      • agentQueueManagerChannel-必需。这是 DestinationAgentQueueManager 的 connection_info.txt 文件中的 "adminChannelName"。

      • configurationOptions - 根据约定，这是协调队列管理器的名称

      • <filePath>-这是凭证文件所在的 "filePath" 例如- C:\Users\Administrator\MQMFTCredentials.xml 请参阅 附录 4 以获取更多详细信息

      • -f - 可选。 强制该命令覆盖现有配置。

      • **例如 ** fteSetupCommands -p QMCOORD -connectionQMgr QMDEST -connectionQMgrHost qmdest-749b.qm.us-preprod.appdomain.cloud -connectionQMgrPort 31193 -connectionQMgrChannel CLOUD.ADMIN.SVRCONN -credentialsFile "C:\Users\Administrator\MQMFTCredentials.xml" -f
        显示 "fteSetup协调" 命令和 "fteSetup命令" 的图像

  • 10.3. 在 Terminal 3 中，运行以下命令以创建 DEST_AGENT（目标代理）：

    • fteCreateAgent -agentName <agentName> -agentQMgr <agentQueueManager> -agentQMgrHost <agentQueueManagerHost> -agentQMgrPort <agentQueueManagerPort> -agentQMgrChannel <agentQueueManagerChannel> -p <configurationOptions> -f -credentialsFile <filePath>
      • agentName - 必需。 要创建的代理的名称。
      • agentQueueManager - 必需。 代理的队列管理器的名称。这是 DestinationAgentQueueManager 的 connection_info.txt 文件中的“queueManagerName”。
      • agentQueueManagerHost-必需。这是 DestinationAgentQueueManager 的 connection_info.txt 文件中的 "hostname"。
      • agentQueueManagerPort-必需。这是 DestinationAgentQueueManager 的 connection_info.txt 文件中的 "listenerPort"。
      • agentQueueManagerChannel-必需。这是 DestinationAgentQueueManager 的 connection_info.txt 文件中的 "adminChannelName"。
      • configurationOptions - 根据约定，这是协调队列管理器的名称
      • <filePath>-这是凭证文件所在的 "filePath" 例如- C:\Users\Administrator\MQMFTCredentials.xml 请参阅 附录 4 以获取更多详细信息
      • -f - 可选。 强制该命令覆盖现有配置。
      • **例如 ** fteCreateAgent -agentName DEST_AGENT -agentQMgr QMDEST -agentQMgrHost qmdest-749b.qm.us-preprod.appdomain.cloud -agentQMgrPort 31193 -agentQMgrChannel CLOUD.ADMIN.SVRCONN -p QMCOORD -credentialsFile "C:\Users\Administrator\MQMFTCredentials.xml" -f 此图显示针对云队列管理器运行的 "fteCreateAgent" 命令

  • 10.4 运行 runmqsc 以连接到远程队列管理器

    • <ADMIN_MQ_USER>-这是 platformApiKey.json 文件中的 "mqUsername"

    • <QUEUE_MANAGER_NAME>-这是文件 destinationAgentQMgrConnectionDetails.json 中的 "queueManagerName"

    • -c 使用 MQSERVER 变量通知 runmqsc 应该连接到远程队列管理器

    • 例如 runmqsc -c -u mamgainp -w60 QMDEST

  • 10.5. 终端将提示您输入密码

    • This is your <ADMIN_API_KEY> = 'apiKey' in the file platformApiKey.json of QMDEST.

  • 10.6. 现在，终端在等待进行输入

  • 10.7. 创建要用作代理队列管理器的队列管理器所需的 MQ 对象，此管理器将 MQ on Cloud 队列管理器设定为目标。

    • 将在位置 MQ_DATA_PATH\mqft\config\coordination_qmgr_name\agents\agent_name\agent_name_create.mqsc 创建 mqsc 文件。 您应该将此文件的内容复制并粘贴到 Terminal 3 中。

  • 10.8. 使用以下命令启动上面创建的代理

    • fteStartAgent -p <configurationOptions> <agentName> 其中

      • configurationOptions - 根据约定，这是协调队列管理器的名称

      • agentName-必需。要启动的 IBM MQ Managed File Transfer 代理的名称。

      • 例如 : fteStartAgent -p QMCOORD DEST_AGENT

        此图显示针对云队列管理器运行的 "fteStartAgent" 命令

  1. 现在，新创建的两个代理都应该处于“活动/就绪”状态。 要检查其状态，请执行以下命令：

  • fteListAgents -p <configurationOptions>

    • configurationOptions - 根据约定，这是协调队列管理器的名称
    • 例如 : fteListAgents -p QMCOORD

    此图显示列出针对协调队列管理器运行的所有代理的 "fteListAgents" 命令。

现在，您已配置 IBM MQ Managed File Transfer 队列管理器来传输文件。

后续操作

转至步骤 2 以启动文件传输