Update DRBD kernel module before nodes are rebooted into a new kernel

If an OS update requires a DRBD kernel update, you should follow this procedure before you reboot the nodes into the new OS kernel.

About this task

Note: You should only apply RHEL updates within a version, for example from 9.2 to 9.3. You should not update versions, for example, from RHEL 8 to RHEL 9.

There are different procedures for updating the DRBD kernel module for a high availability (HA) configuration, a disaster recovery (DR) configuration, or a combined DR/HA configuration.

For HA configurations, complete the steps on each node in the HA group in turn. Processing can continue on other nodes while the update is in progress.

Update the DRBD kernel module before a node is rebooted into a new kernel for RDQM HA

Procedure

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. This information also applies to UNIX systems in general.
Suspend the node from the HA group:
```
rdqmadm -s
```
Update the OS. For example:
```
dnf update
```
Determine which DRBD kernel module is compatible with the new kernel level (see https://ibm.biz/mqrdqmkernelmods for guidance on which kernel module is compatible).
Helper scripts are provided in the kmod-drbd-9 directories. For example, on a RHEL 9.2 system, running the helper script Advanced/RDQM/PreReqs/el9/kmod-drbd-9/modver returns the following information, identifying the kernel module that you need to install:
```
kmod-drbd-9.2.7+ptf.14.gdc5453714_5.14.0_284.11.1-1.x86_64
```
Update the DRBD kernel module with the one you identified in step 4. For example:
```
dnf install kmod-drbd-9.2.7+ptf.14.gdc5453714_5.14.0_284.11.1-1.x86_64.rpm
```
Reboot the node. This will reboot to the new kernel level:
```
sudo reboot
```
Resume the node in the HA group:
```
rdqmadm -r
```

Update the DRBD kernel module before nodes are rebooted into a new kernel for RDQM DR

Procedure

Update the OS and the DRBD kernel module on the DR secondary node:
1. 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.
2. Update the OS. For example:
```
dnf update
```
3. Determine which DRBD kernel module is compatible with the new kernel level (see https://ibm.biz/mqrdqmkernelmods for guidance on which kernel module is compatible).
  Helper scripts are provided in the kmod-drbd-9 directories. For example, on a RHEL 9.2 system, running the helper script Advanced/RDQM/PreReqs/el9/kmod-drbd-9/modver returns the following information, identifying the kernel module that you need to install:
```
kmod-drbd-9.2.7+ptf.14.gdc5453714_5.14.0_284.11.1-1.x86_64
```
4. Update the DRBD kernel module with the one you identified in step c. For example:
```
dnf install kmod-drbd-9.2.7+ptf.14.gdc5453714_5.14.0_284.11.1-1.x86_64.rpm
```
5. Reboot the node. This will reboot to the new kernel level:
```
sudo reboot
```
On the DR primary node, complete one of the following steps:
- End the DR queue managers, or
- Perform a managed failover of the DR queue managers to the DR secondary node.
Update the OS and the DRBD kernel module on DR primary node:
1. 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.
2. Update the OS. For example:
```
dnf update
```
3. Determine which DRBD kernel module is compatible with the new kernel level (see https://ibm.biz/mqrdqmkernelmods for guidance on which kernel module is compatible).
  Helper scripts are provided in the kmod-drbd-9 directories. For example, on a RHEL 9.2 system, running the helper script Advanced/RDQM/PreReqs/el9/kmod-drbd-9/modver returns the following information, identifying the kernel module that you need to install:
```
kmod-drbd-9.2.7+ptf.14.gdc5453714_5.14.0_284.11.1-1.x86_64
```
4. Update the DRBD kernel module with the one you identified in step c. For example:
```
dnf install kmod-drbd-9.2.7+ptf.14.gdc5453714_5.14.0_284.11.1-1.x86_64.rpm
```
5. Reboot the node. This will reboot to the new kernel level:
```
sudo reboot
```
On the DR primary node, complete one of the following steps:
- Start the DR queue managers, or
- Perform a managed failover of the DR queue managers to the DR primary node.

Update the DRBD kernel module before nodes are rebooted into a new kernel for RDQM DR/HA

Procedure

Update the OS and the DRBD kernel module on your recovery site. Complete the following steps on each node in the group in turn.
1. 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.
2. Suspend the node from the HA group:
```
rdqmadm -s
```
3. Update the OS. For example:
```
dnf update
```
4. Determine which DRBD kernel module is compatible with the new kernel level (see https://ibm.biz/mqrdqmkernelmods for guidance on which kernel module is compatible).
  Helper scripts are provided in the kmod-drbd-9 directories. For example, on a RHEL 9.2 system, running the helper script Advanced/RDQM/PreReqs/el9/kmod-drbd-9/modver returns the following information, identifying the kernel module that you need to install:
```
kmod-drbd-9.2.7+ptf.14.gdc5453714_5.14.0_284.11.1-1.x86_64
```
5. Update the DRBD kernel module with the one you identified in step d. For example:
```
dnf install kmod-drbd-9.2.7+ptf.14.gdc5453714_5.14.0_284.11.1-1.x86_64.rpm
```
6. Reboot the node. This will reboot to the new kernel level:
```
sudo reboot
```
7. Resume the node in the HA group:
```
rdqmadm -r
```
You can now repeat this procedure for the next node in the HA group.
Update the OS and the DRBD kernel module on your main site. Complete the following steps on each node in the group in turn.
1. 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.
2. Suspend the node from the HA group:
```
rdqmadm -s
```
3. Update the OS. For example:
```
dnf update
```
4. Determine which DRBD kernel module is compatible with the new kernel level (see https://ibm.biz/mqrdqmkernelmods for guidance on which kernel module is compatible).
  Helper scripts are provided in the kmod-drbd-9 directories. For example, on a RHEL 9.2 system, running the helper script Advanced/RDQM/PreReqs/el9/kmod-drbd-9/modver returns the following information, identifying the kernel module that you need to install:
```
kmod-drbd-9.2.7+ptf.14.gdc5453714_5.14.0_284.11.1-1.x86_64
```
5. Update the DRBD kernel module with the one you identified in step d. For example:
```
dnf install kmod-drbd-9.2.7+ptf.14.gdc5453714_5.14.0_284.11.1-1.x86_64.rpm
```
6. Reboot the node. This will reboot to the new kernel level:
```
sudo reboot
```
7. Resume the node in the HA group:
```
rdqmadm -r
```
You can now repeat this procedure for the next node in the HA group.