Upgrading an IBM MQ installation on Linux Ubuntu using dpkg

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

1. 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.
2. Log in as root, or with sufficient authority to run the following commands.

   You can do this by adding sudo before the commands, or by changing to the root user in the shell with the su command. For more information, see Exploring the differences between sudo and su commands in Linux.

3. 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.
4. Set your current directory to the location of the installation files.
5. 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.
6. Upgrade each IBM MQ package by using the following command for each package:

   dpkg -i packageName

   where packageName specifies the name of the package to upgrade.

   Important: Although dpkg permits multiple package files in the same command, this does not work for IBM MQ because of inter-package dependencies. You must upgrade the packages individually in the order shown. If you use apt to upgrade, the inter-package dependencies are handled for you. For more information, see Upgrading an IBM MQ installation on Linux Ubuntu using apt.

   • ibmmq-runtime
   • ibmmq-jre
   • ibmmq-java
   • ibmmq-gskit
   • ibmmq-server
   • ibmmq-web
   • ibmmq-ftbase
   • ibmmq-ftagent
   • ibmmq-ftservice
   • ibmmq-ftlogger
   • ibmmq-fttools
   • ibmmq-amqp
   • ibmmq-ams
   • ibmmq-xrservice
   • ibmmq-explorer
   • ibmmq-client
   • ibmmq-man
   • ibmmq-msg_language
   • ibmmq-samples
   • ibmmq-sdk
7. Use the dspmqver command to verify that the version is as expected:

   dspmqver