Upgrading an IBM MQ installation on Linux Ubuntu using apt

You can use apt to upgrade an IBM® MQ installation on Linux® Ubuntu systems.

Before you begin

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

[MQ 9.4.0 Jun 2024] 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.

Important:

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 9.4.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 9.4.0 or later.
From IBM MQ 9.3.0, IBM MQ Explorer has been removed from the IBM MQ install package. 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 9.4.4 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 might 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
```

For more information about modifying an IBM MQ installation on Ubuntu, see Uninstalling or modifying IBM MQ on Linux Ubuntu using Debian packages.

Procedure

Complete the following tasks:
1. Stop all your IBM MQ applications.
  
  If you use the Managed File Transfer (MFT) component, ensure that any file transfers that MFT agents are engaged in are completed. The SYSTEM.FTE.STATE queues must contain no messages.
2. Stopped the mqweb server by using the endmqweb command.
3. Stopped your listeners by using the endmqlsr command.
4. Stopped all your queue managers by using the endmqm command.
  If a queue manager is part of a cluster, you must suspend the queue manager before you stop it. For more information, see Maintaining a queue manager in a cluster.
5. Backed up your data.
  For more information, see Backing up and restoring queue manager data.
Log in as root, or switch to the root user by using the su or su - commands. Alternatively, you can use the sudo command to run commands as the root user, if your system administrator gave you the privilege to do so.

To use the sudo command, add sudo before the command that you want to run. For more information about the su and sudo commands, see Exploring the differences between sudo and su commands in Linux on the Red Hat® website.
Optional: If your installation media is a downloadable installation image, obtained from Passport Advantage, you must decompress the tar.gz file and extract the installation files from the file:
1. Decompress the file by using the following command:
```
gunzip partName.tar.gz
```
  where partName is the name of the installation image file.
2. Extract the installation files from the file by using the following command:
```
tar -xvf partName.tar
```
  where partName is the name of the installation image file.
  Important: You must use GNU tar (also known as gtar) to unpack any tar images.
Set your current directory to the location of the installation files.
From IBM MQ 9.2.0, you have the option of accepting the license before or after you install the product. To accept the license before installing, run the mqlicense.sh script. The license agreement is displayed in a language appropriate to your environment and you are prompted to accept or decline the terms of the license:
- To display the license agreement in the default manner, which uses an X-window where possible, use the following command:
```
./mqlicense.sh
```
- To display the license agreement as text in the current shell, which can be read by a screen reader, use the following command:
```
./mqlicense.sh -text_only 
```
See Accepting the license on IBM MQ for Linux for more information about license acceptance.
Open the IBM_MQ.list file from the /etc/apt/sources.list.d directory.
Add the following line to the end of the IBM_MQ.list file:
```
deb [trusted=yes] file:installationFileLocation ./
```
where installationFileLocation is the directory where the unpacked files are located.
Refresh the repository index by using the following command:
```
apt-get update
```
Upgrade IBM MQ by using the following command:
```
apt-get upgrade "ibmmq-*"
```
Use the dspmqver command to verify that the version is as expected:
```
dspmqver
```