[Linux]

Migrating MQ Telemetry on Linux

Follow these instructions to migrate your existing installation of MQ Telemetry on Linux® to the latest version of the product.

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

The telemetry server is included in the product as an optional installation.

For IBM WebSphere® MQ 7.5, the Client Software Development Kit (the telemetry clients) is also included in the optional installation. From IBM MQ 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 MQ, 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, Linux systems retain all telemetry data kept in /var/mqm. Telemetry data is migrated to the later version of the product when the queue manager is started again.

Procedure

  1. Create a migration plan.
    See Planning to migrate IBM MQ to a later version on UNIX or Linux.
  2. Migrate your queue managers to the latest release.
  3. Install MQ Telemetry.
  4. 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.