Creating the initial configuration

You can configure a Managed File Transfer Agent to connect to an existing IBM® MQ configuration.

Before you begin

Make sure that you download and extract the contents of the Redistributable Managed File Transfer Agent package. For more information, see Configuring the Redistributable Managed File Transfer Agent.

1. Create the environment for the Redistributable Managed File Transfer Agent.
   When you run the fteCreateEnvironment command, the MFT data directory with the configuration information for MFT Agents is created. Ensure that you are in the bin directory that was created when you extracted the downloaded MFT Agent redistributable component. Run the following command:

   • 

     fteCreateEnvironment.cmd -d datapath location

   • 

     . ./fteCreateEnvironment -d datapath location

     This command takes one optional parameter:

     -d

     Location for data path where the MFT configuration is created, stored, and maintained. If the user runs the fteCreateEnvironment without specifying the data location, the directory mftdata is created in the location where the Redistributable Managed File Transfer Agent is extracted.

     Note: If the redistributable agent is going to run as a Windows service, then the BFG_DATA environment variable needs to be set in the system environment for the service to work.

   You can also set the environment variable BFG_DATA with the data path location:

   BFG_DATA=Datapath location

   Before creating, starting, and stopping an agent, or any other commands, you must ensure that the BFG_DATA variable is set to the correct data path location.
2. Set up the IBM MQ connectivity.
   1. Set up the coordination queue manager by using the fteSetupCoordination command.
      The fteSetupCoordination command creates the set that is up required for coordination queue managers and the directories that are needed for further configuration. Redistributable Managed File Transfer Agent works in client mode so you must provide extra parameters with this command to avoid an error, as bindings mode is not supported.

      fteSetupCoordination -coordinationQMgr PRMFTDEMO2 
                    -coordinationQMgrHost 9.121.59.233 -coordinationQMgrPort 3002 
                    -coordinationQMgrChannel SYSTEM.DEF.SVRCONN

      For more details and steps for using the fteSetupCoordination command, see fteSetupCoordination. For information on how to configure the coordination queue manager, see Configuring the coordination queue manager for MFT.
   2. Create and set up the command queue manager:

      fteSetupCommands -p PRMFTDEMO2 -connectionQMgrHost 9.121.59.233 
                    -connectionQMgrPort 3002 -connectionQMgrChannel SYSTEM.DEF.SVRCONN 
                    -connectionQMgr PRMFTDEMO2 -f

      For more details and steps for using the fteSetupCommands command, see fteSetupCommands: create the MFT command.properties file.
3. Create MFT Agent definition for an end point.

   fteCreateAgent -p PRMFTDEMO2 -agentQMgrHost 9.121.59.233  
               -agentQMgrPort 3002 -agentQMgrChannel SYSTEM.DEF.SVRCONN 
               -agentName AGENT.TRI.BANK -agentQMgr PRMFTDEMO2 -f

   For more information on using the fteCreateAgent command to configure an agent and the agent queue manager, see fteCreateAgent (create an MFT agent).
   In steps 2 and 3 for each agent, you create queue and topic definitions on the agent queue manager.
4. Start the agent and you are ready to transfer files.

   fteStartAgent -p PRMFTDEMO2 AGENT.TRI.BANK

   You can verify the status of the agent by running the following command:

   fteListAgents

   For more details on using the fteListAgents command, see fteListAgents: list the MFT agents for a coordination queue manager.