Migrating MQ Telemetry on Windows
Follow these instructions to migrate your existing installation of MQ Telemetry to a later version of the product on Windows.
Before you begin
Before proceeding with this task, ensure that you back up your existing IBM MQ installation. You must stop the MQ Telemetry service SYSTEM.MQXR.SERVICE before migrating.
About this task
From Version 7.1 onwards, the telemetry server is included in the product as an optional installation.
For Version 7.1 and Version 7.5, the Client Software Development Kit (the telemetry clients) is also included in the optional installation. From Version 8.0 onwards, the Client Software Development Kit is no longer supplied as part of the product. Instead, the current version of the SDK is available as the IBM Messaging Telemetry Clients SupportPac.
Because MQ Telemetry is a component of IBM WebSphere MQ Version 7.1 and later, MQ Telemetry can either be installed with the main product, or installed after the main product has been installed. When you upgrade from a previous version of the product, you must download and use the latest version of the Client Software Development Kit.
After the successful upgrade, Windows systems retain the telemetry data in the installation directory of the product, for example: C:\Program Files (x86)\IBM\WebSphere MQ. Telemetry data is migrated to the later version of the product when the queue manager is started again.
Procedure
- Create a migration plan. See Plan to migrate IBM MQ to a later version on Windows.
- Migrate your queue managers to the later release.
- Install MQ Telemetry.
- Verify that the MQ Telemetry installation was successful. See Verifying the installation of MQ Telemetry .
Results
Message AMQ4616 indicates completion of the task. The existing MQTT channels and previous subscriptions are still present.