Migrating an FTE Version 7.0 agent to MQ Version 7.5 or later

Use the fteMigrateAgent command to migrate an WebSphere MQ File Transfer Edition Version 7.0 agent to IBM WebSphere MQ Version 7.5, or later. If an agent is configured to run as a Windows service, we must complete the optional steps in this task.

Before starting

From Version 9.0, Managed File Transfer does not support web agents. If you attempt to use the fteMigrateAgent command to migrate a web agent from an earlier release to Version 9.0, an error message is displayed to explain that the migration of a web agent is not supported.

Identify instances of the IBM WebSphere MQ File Transfer Edition agent installed as part of IBM WebSphere MQ File Transfer Edition.

The information in this topic does not apply to IBM i. If we are using IBM i, migrate your queue manager to IBM MQ Version 8.0 before using Managed File Transfer Version 8.0.

About this task

To migrate to IBM WebSphere MQ Version 7.5 or later, first stop the agent, then migrate the queue manager installation to IBM WebSphere MQ Version 7.5 or later, and additionally select the File Transfer components. When the queue manager has been migrated, we can migrate the agent's configuration to the IBM WebSphere MQ Version 7.5 or later, installation using the fteMigrateAgent command. Start the migrated agent using the IBM WebSphere MQ Version 7.5 or later, queue manager.

If the agent is connecting to its queue manager using IBM WebSphere MQ bindings mode and the queue manager is at Version 7.0.1, Fix Pack 6 or later, we can alternatively perform a side-by-side migration by using multiple installations and the steps listed below. If we do not wish to perform a side-by-side migration, instead migrate the queue manager and agent using the steps as described above.

If the agent is connecting to its queue manager using IBM WebSphere MQ bindings mode and the queue manager is at Version 7.0.1, Fix Pack 5 or earlier, we must either migrate this installation to Version 7.0.1, Fix Pack 6, to permit a side-by-side migration, or you must migrate this installation directly to IBM WebSphere MQ Version 7.5 or later.

If the agent is connecting to its queue manager across a network as an IBM WebSphere MQ client, we can migrate the agent to IBM WebSphere MQ Version 7.5 or later by completing step 7 only.

If the agent is configured as a Windows service you must run the command with the -f parameter. For more information, see fteMigrateAgent.

Procedure

1. Install IBM WebSphere MQ Version 7.5 or later alongside the existing queue manager installation, selecting the MQ Server and File Transfer components.
2. Stop the IBM WebSphere MQ File Transfer Edition v7.0.x agent.
3. Move the queue manager to the IBM WebSphere MQ Version 7.5, or later installation.
4. Use the fteMigrateAgent command to migrate the agent configuration from the IBM WebSphere MQ File Transfer Edition v7.0.x installation to the agent capability integrated with IBM WebSphere MQ Version 7.5 or later.
5. Optional: If the IBM WebSphere MQ File Transfer Edition v7.0.x agent is configured as a Windows service, complete the following optional steps:
   1. Use the fteModifyAgent command to reconfigure the agent so that it is no longer a Windows service.
   2. Use the fteModifyAgent command from the IBM WebSphere MQ Version 7.5 or later, installation to configure the IBM WebSphere MQ Version 7.5 or later, version of the agent to be a Windows service.

6. Start the IBM WebSphere MQ Version 7.5 or later, agent.
7. Optional: To migrate an agent connecting to its queue manager across a network as a client:
   1. Install IBM WebSphere MQ Version 7.5 or later, onto the system
   2. Use the fteMigrateAgent command to migrate the agent configuration from the WMQFTE v7.0.x installation to the agent capability integrated with IBM WebSphere MQ Version 7.5 or later.
   3. Stop the IBM WebSphere MQ File Transfer Edition v7.0.x agent.
   4. If the IBM WebSphere MQ File Transfer Edition v7.0.x agent is configured as a Windows service, use the fteModifyAgent command from the IBM WebSphere MQ File Transfer Edition v7.0.x installation to re-configure the agent so that it is not run as a Windows service
   5. If the IBM WebSphere MQ File Transfer Edition v7.0.x agent is configured as a Windows service, use the fteModifyAgent command from the IBM WebSphere MQ Version 7.5 or later installation to configure the IBM WebSphere MQ Version 7.5 or later agent as a Windows service.
   6. Start the IBM WebSphere MQ Version 7.5 or later agent.

Parent topic: Migrating IBM MQ Managed File Transfer