[MQ 9.4.0 Jun 2024]

Removing maintenance on Linux using dnf

From IBM® MQ 9.4.0, you can use the dnf command to remove maintenance from an IBM MQ installation on Linux® Red Hat® systems.

Before you begin

When you use dnf the IBM MQ installation that includes the maintenance level is replaced with an installation at an earlier level of IBM MQ. Therefore, you must decide which level of IBM MQ you want to revert to. Then you must ensure that the installation files for the earlier level of IBM MQ are available on the system.

About this task

You can use dnf only to roll back the fix pack level of your installation. You cannot use the command to roll back the version, release, or modification level of your IBM MQ installation. To roll back the version, release, or modification level of your installation, you must uninstall the higher level and then install the earlier level that you require. However, any queue managers that are running at a higher version or release of IBM MQ cannot then be started on the earlier version or release. For more information, see Queue manager migration.

Procedure

  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 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.

  3. Set your current directory to the location of the earlier level installation files. The location might be a network location, or a local file system directory.
  4. Optional: If there is more than one installation on the system, or if you want to remove maintenance from an IBM MQ installation in a nondefault location, create a unique set of packages:
    1. Run the crtmqpkg to create a unique set of packages: 
      ./crtmqpkg suffix
      where suffix specifies a name of your choosing that uniquely identifies the installation packages on the system. suffix is not the same as an installation name, although the names can be identical. suffix is limited to 16 characters in the ranges A-Z, a-z, and 0-9.
      Note: This command creates a full copy of the installation packages in a temporary directory. By default, the temporary directory is at /var/tmp. Ensure that the system has enough available space before you run this command. To use a different location, you can set the TMPDIR environment variable before you run the crtmqpkg command. For example: 
      $ TMPDIR=/test ./crtmqpkg suffix installationPath
    2. Set your current directory to the location that is specified when the crtmqpkg command operation completes successfully.
  5. Clear the repository cache by entering the following command: 
    dnf clean all
  6. Remove the IBM MQ maintenance level:
    • To remove the maintenance level from all installed components in the default location, use the following command:
      dnf -y downgrade pathToInstallationFiles/MQSeries*
      where pathToInstallationFiles specifies the path where the earlier level IBM MQ installation files are located.
    • To remove the maintenance level from all installed components in a nondefault location, use the following command:
      dnf -y downgrade pathToInstallationFiles/MQSeries*suffix*
      where pathToInstallationFiles specifies the path where the earlier level IBM MQ rpm installation files are located, and suffix specifies the suffix that was chosen when you ran the crtmqpkg command.
  7. Use the dspmqver command to verify that the level is as expected: 
    dspmqver