Instructions for HADR Package Installation ---------------------------------------------------------- Issue(s) addressed by this patch (PL-25320): Due to an NBD driver issue, a kernel panic may occur when there is a network error. This HOTFIX provides the solution developed by the NBD maintainer. A request has been made to Red Hat to include this fix in future kernels. ------------------------- Patch Description: This patch provides an updated nbd kernel module that will properly handle the network error and return an IO error. ------------------------- AFFECTED ENVIRONMENTS: * Operating system * Red Hat Enterprise Linux 9.4 * Oracle Linux 9.4 (RHCK) * Rocky Linux 9.4 * Miracle Linux 9.4 * AlmaLinux 9.4 * Application Recovery Kit * DataKeeper This patch is built for the 9.4 GA kernel 5.14.0-427.13.1.el9_4. It is compatible with 5.14.0-427.20.1.el9_4 and 5.14.0-427.40.1.el9_4. Note: These affected environments do not depend on LifeKeeper versions. All LifeKeeper versions require the steps described in this guide. These installation steps are not required when DataKeeper is not used, UEK on Oracle Linux is used, or LifeKeeper Single Server Protection for Linux is used. ------------------------- Patch Installation 1) Download the patch This patch can be found on the SIOS FTP site at the following location: http://ftp.us.sios.com/pickup/HOTFIX-PL-25320-NBD_RHEL9.4_patch To download the patch and associated files on Linux perform the following steps: # wget http://ftp.us.sios.com/pickup/HOTFIX-PL-25320-NBD_RHEL9.4_patch/HADR-RHAS-5.14.0-427.13.1.el9_4.x86_64.rpm # wget http://ftp.us.sios.com/pickup/HOTFIX-PL-25320-NBD_RHEL9.4_patch/HADR-RHAS-5.14.0-427.13.1.el9_4.x86_64.rpm.sha256sum # wget http://ftp.us.sios.com/pickup/HOTFIX-PL-25320-NBD_RHEL9.4_patch/collect_11_overwrite.sh # wget http://ftp.us.sios.com/pickup/HOTFIX-PL-25320-NBD_RHEL9.4_patch/readme.txt Note: If there are issues using the wget command, run the wget commands with the following additions: # wget --cipher 'DEFAULT:!DH' 2) Verify the download Verify the checksum by running the following command: # sha256sum -c HADR-RHAS-5.14.0-427.13.1.el9_4.x86_64.rpm.sha256sum NOTE: Alternative download methods can be used but must include all files. Once the download is complete a verification of the sha256sum should be performed. 3a) Fresh Installation of LifeKeeper Place the HADR package and the collect_11_overwrite.sh file anywhere on the server where LifeKeeper will be installed. In this document, it is assumed to be placed under /root. For other locations, change the path name accordingly. The HADR package differs for each OS version. Follow the normal LifeKeeper installation steps to the point of running the setup script. In this guide, LifeKeeper installation image is assumed to have been mounted on /mnt. For other locations, change the path name accordingly. Follow these steps to install the HADR patch during the install: # cp -a /mnt/setuplibs /tmp/setuplibs # cp /root/collect_11_overwrite.sh /tmp/setuplibs/collect_11_overwrite.sh # chmod +x /tmp/setuplibs/collect_11_overwrite.sh # /mnt/setup --extlibdir /tmp/setuplibs --addHADR /root/HADR-RHAS-5.14.0-427.13.1.el9_4.x86_64.rpm Complete the setup script as usual. After install is complete these downloaded temporary files can be removed: # rm -rf /tmp/setuplibs # rm -f /root/collect_11_overwrite.sh # rm -f /root/HADR-RHAS-5.14.0-427.13.1.el9_4.x86_64.rpm # rm -f /root/HADR-RHAS-5.14.0-427.13.1.el9_4.x86_64.rpm.sha256sum # rm -f /root/readme.txt Perform the steps in the 'Verifying the HADR package installation' to ensure that the specified HADR package has been installed correctly. 3b) Installing the HADR package on an installed LifeKeeper server: To install the HADR package, LifeKeeper needs to be stopped. A rolling update needs to be performed to install the HADR package without stopping the services. Install the HADR package on each node using the following steps. No need to recreate the resources. - Perform a switchover of all protected resources to one of the nodes. - Stop LifeKeeper on the node where the resource is currently out of service. - Install the HADR package using the same steps described in 'Fresh installation of LifeKeeper'. - Start LifeKeeper. - Perform a switchover of all the resources to the nodes where the HADR package is installed and wait until the DataKeeper mirror synchronization is completed. - Stop LifeKeeper on the node where the resource is currently out of service and install the HADR package using the same steps described in the 'Fresh installation of LifeKeeper'. - In a cluster environment with more than two nodes, install the HADR package on the rest of the nodes as well. 4) Upgrading LifeKeeper To re-run setup for installing additional ARKs or upgrading LifeKeeper on a system with this HADR package, LifeKeeper must be stopped and then setup using "3b) Installing the HADR package on an installed LifeKeeper server". 5) Verifying the HADR package installation Verify the successful completion of the installation using the following two ways. 1. Verify the HADR package has been installed by running: # rpm -qa | grep HADR-RHAS The output should include: HADR-RHAS-5.14.0-427.13.1.el9_4-9.9.0-7718.x86_64 2. Verify that the srcversion value for each installed HADR package is as follows by executing: # modinfo nbd The output should include: srcversion: D7AC88B21EBD11AB27B67B9 ------------------------- Uninstalling the HADR package # rpm -evh HADR-RHAS-5.14.0-427.13.1.el9_4-9.9.0-7718