Issue Summary
During a cPanel update, the RPM test transaction fails with errors similar to:
libmariadb.so.3()(64bit) is needed by net-snmp
libmariadb.so.3(libmysqlclient_18)(64bit) is needed by net-snmp-agent-libs
Exit Code: 94
This prevents the update from completing.
Root Cause
The system is missing or has a broken version of the MariaDB client library:
-
libmariadb.so.3 -
Required by:
-
net-snmp -
net-snmp-agent-libs
-
This typically occurs due to:
-
Removal or corruption of
mariadb-connector-c -
Conflicts between MySQL and MariaDB repositories
-
Partial or failed package upgrades
-
Repository misconfiguration on AlmaLinux / RockyLinux / CentOS 8
Resolution Steps
Step 1: Verify Library Presence
Check if the required library exists:
find /usr -name "libmariadb.so.3"
-
If no output → library is missing
-
If present → may be broken or not linked properly
Step 2: Install / Reinstall MariaDB Connector
Install the required package:
dnf install -y mariadb-connector-c
If already installed:
dnf reinstall -y mariadb-connector-c
Step 3: Confirm Package Provides the Library
dnf provides "*/libmariadb.so.3"
Expected output should include:
mariadb-connector-c
Step 4: Clean and Rebuild RPM Database
rpm --rebuilddb
dnf clean all
dnf makecache
Step 5: Retry cPanel Update
/scripts/upcp --force
Troubleshooting (If Issue Persists)
Check Repository Conflicts
dnf repolist
Look for:
-
External MySQL repositories (e.g., Oracle MySQL)
-
Duplicate or conflicting repos
Force Correct Package Installation
dnf install -y mariadb-connector-c --allowerasing
Reinstall Dependent Packages
dnf reinstall -y net-snmp net-snmp-agent-libs mariadb-connector-c
Important Notes
-
Do not remove
net-snmpmanually — it is required by the system. -
Avoid mixing MySQL and MariaDB repositories unless explicitly configured.
-
Always ensure repository consistency before running cPanel updates.
Impact
-
cPanel update fails (
upcp) -
RPM transactions cannot proceed
-
System packages remain in inconsistent state
Summary
The error is caused by a missing or mismatched MariaDB client library (libmariadb.so.3).
Reinstalling mariadb-connector-c and resolving repository conflicts restores dependency integrity and allows the update to proceed.
Reference
-
cPanel documentation:
https://go.cpanel.net/rpmcheckfailed
If the issue continues after all steps, collect the following for deeper analysis:
dnf list installed | grep -i maria
dnf list installed | grep -i mysql
rpm -qa | grep -E 'maria|mysql|snmp'
