Package conflicts prevent MySQL 8.4 installations on AlmaLinux 10.2

Symptoms

When installing cPanel on AlmaLinux 10.2, with MySQL 8.4 selected as the SQL server, it fails with the following:

CONFIG_TEXT:  The background process “SQL Databases and dependent apps” failed with a fatal error: The subprocess reported error number 2 when it ended.

Cause

MariaDB packages are being included when installing on AlmaLinux 10.2, causing a conflict with MySQL 8.4 and preventing the installation from completing. This can be noted in the installation log with errors similar to the following:

CONFIG_TEXT: file /usr/bin/mysql conflicts between attempted installs of mariadb11.8-3:11.8.6-2.el10_2.alma.1.x86_64 and mysql-community-client-8.4.9-1.el10.x86_64
 file /usr/bin/mysqladmin conflicts between attempted installs of mariadb11.8-3:11.8.6-2.el10_2.alma.1.x86_64 and mysql-community-client-8.4.9-1.el10.x86_64
 file /usr/bin/mysqlbinlog conflicts between attempted installs of mariadb11.8-3:11.8.6-2.el10_2.alma.1.x86_64 and mysql-community-client-8.4.9-1.el10.x86_64
 file /usr/bin/mysqlcheck conflicts between attempted installs of mariadb11.8-3:11.8.6-2.el10_2.alma.1.x86_64 and mysql-community-client-8.4.9-1.el10.x86_64
 file /usr/bin/mysqldump conflicts between attempted installs of mariadb11.8-3:11.8.6-2.el10_2.alma.1.x86_64 and mysql-community-client-8.4.9-1.el10.x86_64
 file /usr/bin/mysqlimport conflicts between attempted installs of mariadb11.8-3:11.8.6-2.el10_2.alma.1.x86_64 and mysql-community-client-8.4.9-1.el10.x86_64
 file /usr/bin/mysqlshow conflicts between attempted installs of mariadb11.8-3:11.8.6-2.el10_2.alma.1.x86_64 and mysql-community-client-8.4.9-1.el10.x86_64
 file /usr/bin/mysqlslap conflicts between attempted installs of mariadb11.8-3:11.8.6-2.el10_2.alma.1.x86_64 and mysql-community-client-8.4.9-1.el10.x86_64
 file /usr/share/man/man1/mysql.1.gz conflicts between attempted installs of mariadb11.8-3:11.8.6-2.el10_2.alma.1.x86_64 and mysql-community-client-8.4.9-1.el

We've opened an internal case for our development team to investigate this further. For reference, the case number is CPANEL-53703. Follow this article to receive an email notification when a solution is published in the product.

Resolution

Note: This issue only impacts cPanel installations attempting to be performed on AlmaLinux 10.2. If you are able to use a previous version of AlmaLinux 10 as the OS, you can install cPanel and update to AlmaLinux 10.2 after.

1. After the failed cPanel install edit the /etc/yum.conf file, add the following to the exclude line:

   CONFIG_TEXT: mysql8.4* mariadb11.8*

2. Run the following to continue the installation:

   # export CPANEL_BASE_INSTALL=1 

   # /usr/local/cpanel/scripts/cpanel_initial_install