Migrating an FTE 7.0 agent to MQ version 7.5 or later

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

Before you begin

From IBM MQ 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 IBM MQ 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.

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

About this task

To migrate to IBM WebSphere MQ 7.5 or later, first stop the agent, then migrate the queue manager installation to IBM WebSphere MQ 7.5 or later, and additionally select the File Transfer components. When the queue manager has been migrated, you can migrate the agent's configuration to the IBM WebSphere MQ 7.5 or later, installation using the fteMigrateAgent command. Start the migrated agent using the IBM WebSphere MQ 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 IBM WebSphere MQ 7.0.1 Fix Pack 6 or later, you can alternatively perform a side-by-side migration by using multiple installations and the steps listed below. If you 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 IBM WebSphere MQ 7.0.1 Fix Pack 5 or earlier, you must either migrate this installation to IBM WebSphere MQ 7.0.1 Fix Pack 6, to permit a side-by-side migration, or you must migrate this installation directly to IBM WebSphere MQ 7.5 or later.

If the agent is connecting to its queue manager across a network as an IBM WebSphere MQ client, you can migrate the agent to IBM WebSphere MQ 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 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 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 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 7.5 or later, installation to configure the IBM WebSphere MQ 7.5 or later, version of the agent to be a Windows service.
  6. Start the IBM WebSphere MQ 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 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 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 7.5 or later installation to configure the IBM WebSphere MQ 7.5 or later agent as a Windows service.
    6. Start the IBM WebSphere MQ 7.5 or later agent.