[Linux]

Migrating IBM MQ Telemetry on Linux

Follow these instructions to migrate your existing installation of IBM® 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 IBM 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. Similar sample applications continue to be freely available from Eclipse Paho and MQTT.org. See MQ Telemetry Transport sample programs.

Because IBM MQ Telemetry is a component of IBM MQ, IBM 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 AIX and Linux.
  2. Migrate your queue managers to the latest release.
  3. Installation considerations for IBM MQ Telemetry.
  4. Verify that the IBM MQ Telemetry installation was successful. See Verifying the installation of IBM MQ Telemetry.
  5. If the passphrases for your MQTT TLS channels are stored in plain text, you should encrypt the passphrases.
    Before IBM MQ 9.3.0, passphrases for MQTT TLS channels were stored in plain text. From IBM MQ 9.3.0, support for the encryption of passphrases for MQTT TLS channels is provided.
    Existing plain text passphrase are not changed to an encrypted form automatically. You must update your plain text passphrases to an encrypted form. For more information on how to encrypt your passphrases, see Encryption of passphrases for MQTT TLS channels.

Results

Message AMQ4616 indicates completion of the task. The existing MQTT channels and previous subscriptions are still present.