RPM Installation Failures
Last modified: June 12, 2024
Overview
This document provides examples of common RPM installation failures. You can use these examples to help identify and resolve issues that you may encounter when you install RPMs.
-
This document only applies to installation failures for operating system-related RPMs on Red Hat-based servers. This document does not include information for RPMs that The rpm.versions System controls or for packages on servers running the UbuntuĀ® operating system.
-
To install operating system packages, use WHM’s Install Distro Packages interface (WHM » Home »Software »Install Distro Packages).
-
To change how your server processes updates for these packages, use the Operating System Package Updates section of WHM’s Update Preferences interface (WHM » Home » Server Configuration » Update Preferences).
-
To scan your installed cPanel-managed packages for problems, use the
/usr/local/cpanel/scripts/check_cpanel_pkgs
script. You can also use this script to reinstall cPanel & WHM packages that are out-of-date or altered.
If you continue to experience problems with the RPM installation process after you review this document, open a support ticket.
The no package available error
If the /etc/yum.conf
file excludes a required package from updates, or a package does not exist on your server, the installation process fails.
The no package available error Error
In this example, the absence of the wget
package causes the installation to fail:
|
|
Troubleshoot The no package available error
To troubleshoot this issue, perform the following steps:
-
Open the
/etc/yum.conf
file with a text editor and remove the required package from theexclude
line. For example:exclude=bind-chroot courier* dovecot* exim* filesystem httpd* mod_ssl* mysql* perl* php* proftpd* pure-ftpd* ruby* spamassassin*
-
Save your changes and run the RPM installation process again.
The package is obsoleted error
This error generally occurs due to conflicts that exist between the RPMs and a third-party repository. An RPM installation may fail if the system classifies a package as obsolete.
The package is obsoleted error Error
In this example, the system classifies the curl-devel
package as obsolete:
|
|
Troubleshoot The package is obsoleted error
To troubleshoot this error, perform the following steps:
-
Run the
rpm -qa|grep curl
command to determine which third-partycurl
RPMs exist on your system. The output will resemble the following example:1 2 3 4 5
compat-libcurl3-7.15.5-2.el5.remi curl-7.15.5-15.el5 curl-7.21.7-5.el5.remi.2 libcurl-devel-7.21.7-5.el5.remi.2 libcurl-7.21.7-5.el5.remi.2
-
Run the
ls /etc/yum.repos.d
command to confirm whether your server uses a third-party repository. The output will resemble the following example:1 2 3
./ CentOS-Debuginfo.repo epel.repo remi.repo.save ../ CentOS-Media.repo epel-testing.repo CentOS-Base.repo CentOS-Vault.repo remi.repo
-
Disable the third-party repository that caused the error. To do this, run the following command:
yum-config-manager --disable repositoryname
Note:In this example,
repositoryname
represents the third-party repository to disable. -
Run the RPM installation process again.
RPM conflicts
RPMs in the system’s update log that do not match similar RPMs in the repository are commonly known as “rogue RPMs,” and cause the installation process to fail.
RPM conflicts Error
In this example, the MySQL
RPM causes the installation process to fail:
|
|
Troubleshoot RPM conflicts
To troubleshoot this error, perform the following steps
-
Run the
rpm -qa|grep -i ^mysql
command to locate the version of the MySQL RPM in the update log. The output will resemble the following example:mysql-5.0.77-4.el5_4.2
-
Run the previous command on another server and compare the output to the output of the first server. For example:
MySQL-server-5.5.28-2.cp.1148
Note:The difference in RPM versions indicates that the
mysql-5.0.77-4.el5_4.2
RPM is a rogue RPM, which is why it conflicts with the MySQL installation. -
Remove the “rogue” RPM file. For example:
rpm -e --nodeps mysql-5.0.77-4.el5_4.2
-
Run the RPM installation process again.
RPM package file conflicts
An RPM installation can fail if there are package file conflicts. This can occur when a previous RPM file isn’t removed from the system. You must remove any conflicting files before you can successfully install an RPM.
RPM package file conflicts Error
In this example, the clamav-0.100.3-1.el6.x86_64
file conflicts with the RPM package file:
|
|
Troubleshoot RPM package file conflicts
To troubleshoot this error, perform the following steps:
-
Run the
rpm -qa | grep -i clamav
command to locate the version of the ClamAV RPM in the update log. The output will resemble the following example:1 2 3
cpanel-perl-528-File-Scan-ClamAV-1.95-1.cp1178.noarch cpanel-clamav-virusdefs-0.100.2-1.cp1170.x86_64 cpanel-clamav-0.100.2-1.cp1170.x86_64
-
Run the
rpm -qa | grep -i clamav
command on another server. Compare the output to the output of the first server. For example:1 2 3 4 5
clamav-0.100.3-1.el6.x86_64 cpanel-clamav-virusdefs-0.100.2-1.cp1170.x86_64 cpanel-perl-528-File-Scan-ClamAV-1.95-1.cp1178.noarch clamav-db-0.100.3-1.el6.x86_64 cpanel-clamav-0.100.2-1.cp1170.x86_64
-
Remove the conflicting RPM file. For example:
rpm -e --nodeps clamav-0.100.3-1.el6.x86_64
-
Run the RPM installation process again.
Failure to unpack a new package
An RPM installation fails if the update process cannot unpack the new package to the correct location. Binaries that you cannot modify (immutable binaries) cause this error.
Failure to unpack a new package Error
In this example, both the tar
and unzip
packages cause the installation process to fail:
|
|
Troubleshoot Failure to unpack a new package
To troubleshoot this error, perform the following steps:
-
Run the
lsattr /usr/bin/unzip
command to determine whether immutable binaries caused this error. The following example indicates that the system contains immutable binaries:1 2
----i-------- /usr/bin/unzip ----i-------- /bin/tar
-
Remove the immutable flags. To do this, run the following commands:
1 2
chattr -i /usr/bin/unzip chattr -i /bin/tar
-
Run the RPM installation process again.
The Your RPM database appears unstable error
An RPM installation fails if the destination directory is immutable or full.
The Your RPM database appears unstable error Error
In this example, any attempt to install an RPM causes the installation process to fail.
|
|
Troubleshoot The Your RPM database appears unstable error
To troubleshoot this error, perform either of the following actions:
-
Rebuild the RPM database in WHM’s Rebuild RPM Database interface (WHM » Home » Software » Rebuild RPM Database).
-
Run the
/usr/local/cpanel/scripts/find_and_fix_rpm_issues
command.