Preventive Service Planning
Abstract
The Replicated Data Queue Manager (RDQM) feature of IBM MQ Advanced relies on a kernel module to provide data replication.
Content
The Replicated Data Queue Manager (RDQM) feature of IBM MQ Advanced relies on a kernel module to provide data replication.
The kernel module is only required when the RDQM component is installed.
Each IBM MQ Continuous Delivery (CD) and Long Term Support (LTS) image includes the RDQM kernel modules for each Red Hat Enterprise Linux (RHEL) kernel supported by that image.
If you upgrade to a newer RHEL kernel, then you might need to upgrade the RDQM kernel module before you are able to use RDQM with that new RHEL kernel. Failure to upgrade the RDQM kernel module, where needed, results in a failure to start the Replicated Data Queue Managers.
This document will typically lists the most recent DRBD versions, MQ LTS maintenance and CD levels available at the point where the RHEL kernel level was tested. Newer DRBD levels are assumed to be compatible unless explicitly stated otherwise, and where the V.R (e.g. 9.2) version of the DRBD package matches the V.R version of DRBD shipped with MQ. For example, an ifix bundles that contain DRBD kernel module version 9.2.* should be compatible with earlier MQ versions that also used 9.2*.
Jump to:
- Kernel module packages on IBM Fix Central
- Kernel versions with known compatibility issues
- Latest kernel versions successfully validated by IBM
- Useful links
Delivery of updated RDQM kernel modules
From September 2023, the delivery mechanism for kernel module updates has changed. The latest available kernel modules will continue to be shipped with each IBM MQ release and its subsequent maintenance. However, the recommended mechanism to obtain kernel modules is to download the kernel module package from IBM Fix Central for the required IBM MQ release.
The kernel module packages on IBM Fix Central are updated whenever new maintenance is released for each MQ version, and when additional kernel modules are required to support newer kernel levels that are released by Red Hat. This means that the kernel module package on IBM Fix Central might contain additional kernel modules that are not present in the most recent MQ maintenance downloads.
Kernel modules are validated by IBM prior to being included in the kernel module packages. This document lists the most recent kernel levels and the corresponding kernel module that has been validated by IBM for each RHEL version and MQ release combination. A minimum MQ version is listed for the latest kernel level where earlier MQ versions are not compatible with it. In these cases, the MQ version must be updated to at least the stated level before using the later kernel level and its corresponding kernel module.
As a result of the changes to the delivery of kernel module updates, this document no longer lists the kernel module levels shipped with each GA release and maintenance level of MQ.
Regardless of whether kernel modules are obtained from the product install media or the kernel module packages on IBM Fix Central, the included modver utility can be used to confirm which supplied kernel module is appropriate for use with the current kernel level.
The following downloads are available on IBM Fix Central for entitled MQ Advanced users, and are maintained with the latest available RDQM kernel module levels
Fix Central Fix ID | Description |
9.1.0-IBM-MQ-RDQM-Kmods | Latest kernel module package for 9.1.0.x long term support installations |
9.2.0-IBM-MQ-RDQM-Kmods | Latest kernel module package for 9.2.0.x long term support installations |
9.3.0-IBM-MQ-RDQM-Kmods | Latest kernel module package for 9.3.0.x long term support installations |
9.4.0-IBM-MQ-RDQM-Kmods | Latest kernel module package for 9.4.0.x long term support installations |
9.4-CD-IBM-MQ-RDQM-Kmods | Latest kernel module package for 9.4.x.x continuous delivery installations |
RHEL Kernel Releases
Each RHEL release introduces a new kernel release, as documented at https://access.redhat.com/articles/3078
For example, RHEL 7.5 introduced kernel release 3.10.0-862.
There can be kernel updates within a RHEL release, and some of these updates require an updated RDQM kernel module.
A typical RHEL kernel release has an identifier like this:
3.10.0-862.3.2
The extra digits, in this example ".3.2", are referred to in this document as a subrelease. However, this is not official terminology.
Where releases and subreleases require different RDQM kernel modules, IBM provides an RDQM kernel module for each one.
Kernel versions with known compatibility issues
Kernel versions listed here have been tested by IBM and are known to require a new kernel module to function correctly with IBM MQ RDQM. IBM makes compatible kernel modules available at the earliest opportunity in this situation. RDQM users are advised to defer updating to these kernel versions until updated kernel modules are available.
RHEL version | Kernel versions with known compatibility issues |
---|---|
RHEL7 | None |
RHEL8 | None |
RHEL9 | None |
RHEL version | Kernel version | Validated IBM MQ version | Kernel module version | Minimum expected compatible IBM MQ version |
---|---|---|---|---|
RHEL7 |
3.10.0-1160.119.1
|
9.1.0.21 | kmod-drbd-9.0.32_3.10.0_1160-1 | 9.1.0.0 |
9.2.0.25 | kmod-drbd-9.1.20_3.10.0_1160-1 | 9.2.0.7 | ||
9.3.0.17 | kmod-drbd-9.1.20_3.10.0_1160-1 | 9.3.0.0 | ||
9.3.5.0 | kmod-drbd-9.2.7+ptf.14.gdc5453714_3.10.0_1160-1 | 9.3.0.0 | ||
RHEL8 | 4.18.0-553.33.1 | 9.2.0.30 | kmod-drbd-9.1.22_4.18.0_553-1 | 9.2.0.7 |
9.3.0.26 | kmod-drbd-9.1.22_4.18.0_553-1 | 9.3.0.0 | ||
9.4.0.6 | kmod-drbd-9.2.10_4.18.0_553-1 | 9.4.0.0 | ||
9.4.1.0 | kmod-drbd-9.2.11_4.18.0_553-1 | 9.4.0.0 | ||
RHEL9 | 5.14.0-503.19.1 | 9.2.0.30 | kmod-drbd-9.1.22_5.14.0_503.11.1-1 | 9.2.0.7 |
9.3.0.26 | kmod-drbd-9.1.22_5.14.0_503.11.1-1 | 9.3.0.0 | ||
9.4.0.7 | kmod-drbd-9.2.11_5.14.0_503.11.1-1 | 9.4.0.0 | ||
9.4.1.0 | kmod-drbd-9.2.11_5.14.0_503.11.1-1 | 9.4.0.0 |
- JSON metadata on validated kernel modules: https://ibm.biz/mqRdqmKmodJson
- Details on RDQM Kernel module administration improvements, as well as an explanation of the above JSON data: https://community.ibm.com/community/user/integration/blogs/alex-chatt/2023/12/15/rdqm-kernel-module-administration-improvements
Was this topic helpful?
Document Information
Modified date:
20 December 2024
UID
ibm11087143