For cPanel & WHM version 11.46 and older
This document describes how to replace the cPanel-provided and cPanel-managed MySQL® installation with your own installation of MariaDB.
- We strongly recommend that you use WHM's MySQL or MariaDB Upgrade interface (Home >> Software >> MariaDB/MySQL Upgrade) to replace the cPanel-provided and cPanel-managed MySQL installation with MariaDB. To do this, you must upgrade your server to cPanel & WHM version 11.48 or later.
- This document describes an unsupported workaround that is not guaranteed to work in the future.
- After a system administrator performs these steps on a server, it is the system administrator's responsibility to manage and maintain the server's database software.
- We recommend that only experienced system administrators attempt to perform these steps.
- We are not responsible for any data loss that an attempt to perform these steps causes.
Replace MySQL with MariaDB
To replace the cPanel-provided MySQL installation with MariaDB, perform the following steps:
Run the following commands to back up your existing MySQL data:
Run the following commands to disable the MySQL RPM targets. cPanel & WHM will no longer handle MySQL updates, and the rpm.versions system will mark the associated MySQL RPMs as
Run the following command to remove the existing MySQL RPMs from your server. This will leave a clean slate for the MariaDB installation.
You will see a message that is similar to the following output:
Run the following command to create a
yumrepository for MariaDB:
Enter the following contents for the
VERSIONrepresents the currently-available version of MariaDB. For example, if the current version is 5.5.40, then the
MariaDB.repofile would contain:
Use your preferred text editor to open the
/etc/yum.conffile and remove
excludeline in your
/etc/yum.conffile may appear similar to the following example:
- Run the following commands to install MariaDB and restart the appropriate services:
Run the following command to rebuild EasyApache's PHP to ensure that all PHP modules remain intact:
There is no content with the specified labels