[Windows][Linux]

Redistributable Managed File Transfer Agent 创建初始配置

您可以配置 Managed File Transfer Agent 以连接到现有 IBM® MQ 配置。

开始之前

确保下载并解压缩 Redistributable Managed File Transfer Agent 软件包的内容。 有关详细信息,请参阅下载和配置可重新分配的托管文件传输组件

关于本任务

首先创建 Redistributable Managed File Transfer Agent 需要的环境。 然后,可以设置与 IBM MQ 服务器上运行的队列管理器的连接,然后在启动和验证代理之前配置代理和代理队列管理器。

IBM MQ 9.3.0开始,您创建的环境将与 Redistributable Managed File Transfer Logger共享。 有关更多信息,请参阅 为 Redistributable Managed File Transfer 记录器创建初始配置

过程

  1. Redistributable Managed File Transfer Agent创建环境。

    运行 fteCreateEnvironment 命令时,将创建包含 MFT 代理程序的配置信息的 MFT 数据目录。 确保您位于解压缩下载的 Redistributable Managed File Transfer Agent 组件时创建的 bin 目录中。 运行以下命令:

    • [Windows]
      fteCreateEnvironment.cmd -d datapath location
    • [Linux]
      . ./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 变量设置为正确的数据路径位置。
  2. 设置 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文件
  3. 为端点创建 MFT 代理程序定义。
    fteCreateAgent -p PRMFTDEMO2 -agentQMgrHost 9.121.59.233  
                -agentQMgrPort 3002 -agentQMgrChannel SYSTEM.DEF.SVRCONN 
                -agentName AGENT.TRI.BANK -agentQMgr PRMFTDEMO2 -f
    有关使用fteCreateAgent命令配置代理和代理队列管理器的更多信息,请参阅fteCreateAgent
    注: 您需要使用在命令输出中显示的 MQSC 命令来定义代理队列管理器上的代理对象,否则步骤 4 中的指示信息将不起作用。
    在每个代理的步骤 23 中,您将在代理队列管理器上创建队列和主题定义。
  4. 启动代理,然后随时可以开始传输文件。
    fteStartAgent -p PRMFTDEMO2 AGENT.TRI.BANK
    您可以通过运行以下命令来验证代理的状态:
    fteListAgents
    有关使用fteListAgents命令的更多详情,请参阅fteListAgents

后续操作

如果要配置Redistributable Managed File Transfer Logger,请完成创建可还原托管文件传输记录仪初始配置中的步骤。