Upgrading an IBM MQ installation on Linux

You can upgrade an IBM® MQ installation on Linux® systems without uninstalling the earlier version.

Before you begin

The version that you are upgrading from must be IBM MQ 9.2.0, or later.

If your current version is at IBM MQ 9.4.0 or higher, you can upgrade your installation with fix packs installed. That is, the fix pack number in the version.release.modification.fixpack (V.R.M.F) release identifier does not need to be 0.

If your current version is earlier than IBM MQ 9.4.0, you can upgrade only if no fix packs are installed. That is, the fix pack number in the version.release.modification.fixpack (V.R.M.F) release identifier must be 0.

About this task

You can use rpm, a Debian installer on Linux Ubuntu, or the dnf installer on Linux Red Hat®.

Before you begin, ensure that you have backed up your data.

Note:

The IBM MQ Bridge to Salesforce is deprecated across all releases from November 22 2022 (see US Announcement letter 222-341).
The IBM MQ Bridge to Salesforce is removed from the product at IBM MQ 9.4.0. Salesforce connectivity can be achieved with IBM App Connect Enterprise. Salesforce Input and Salesforce Request nodes can be used to interact with Salesforce applications. For more information, see Using Salesforce with IBM App Connect Enterprise.

On Linux for x86-64 only, if you are migrating from an installation where the IBM MQ Bridge to Salesforce is present, you must remove it before you upgrade to IBM MQ 10.0.0 or later.
For Continuous Delivery, the IBM MQ Bridge to blockchain is removed from the product at IBM MQ 9.3.2.
For Long Term Support, IBM MQ Bridge to blockchain is removed at IBM MQ 9.3.0 Fix Pack 15.

Blockchain connectivity can be achieved with IBM App Connect or through App Connect capabilities available with IBM Cloud Pak® for Integration.

On Linux for x86-64 only, if you are migrating from an installation where the IBM MQ Bridge to blockchain is present, you must remove it before you upgrade to IBM MQ 10.0.0 or later.
From IBM MQ 9.3.0, IBM MQ Explorer has been removed from the IBM MQ install package. It remains available as a separate download. For more information, see Installing and uninstalling IBM MQ Explorer as a stand-alone application on Linux and Windows.

On Linux for x86-64 only, if you are migrating on an installation where the IBM MQ Explorer is present as part of the IBM MQ installation, you must remove it before you upgrade to IBM MQ 9.3.0 or later.
From IBM MQ 10.0.0 Continuous Delivery, the Russian language translation support is removed. If you are upgrading from an earlier version that includes this component on the Linux platform, you must manually uninstall it before proceeding with the upgrade. Failure to do so may result in the following error during the upgrade process:
```
MQSeriesRuntime = 9.x.x-0 is needed by (installed) MQSeriesMsg_ru-9.x.x-0.x86_64
```