WHAT TO DO WHEN A CENTOS 7 YUM UPDATE FAILS
- Category : Server Administration
- Posted on : Feb 25, 2018
- Views : 1,994
- By : Ingavar J.
Package manager yum is one of the most important tools available to a CentOS 7 system administrator. If the command fails to work, due to various reasons, the update, installation and removal of packages becomes a very difficult task.
While software can still be installed from RPMs or compiled from source, yum has many advantages such as the automatic installation of dependencies and easy system updates.
In this article, we will assume there are no general issues such as a broken Internet connection or serious system-wide problems.
The goal of this post is to discuss the most common examples of yum command failure, explaining both the root cause and how it can be fixed.
NO REPOSITORIES AVAILABLE
Some CentOS 7 installations don’t configure any yum repositories by default, so yum will be unable to install or update any package.
You can quickly check if this is the case by navigating to the /etc/yum.repos.d folder to see if any files are present, or by executing the following command:
yum repolist all
If they are missing, you will have to create and populate the files yourself. A Google search will help you find the right repository information for your version of CentOS 7.
Another possible issue is when a repository is configured but disabled, which is hard to troubleshoot because no error message is displayed.
For example, if the epel repository is disabled, trying to install a package such as htop will fail because yum is unable to find it.
Here is an example of a disabled repository in the file /etc/yum.repos.d/epel.repo:
name=Extra Packages for Enterprise Linux 7 - $basearch
The easy fix is to change the value on the enabled line to 1, then run yum update to refresh the package list and install the software you need.
Individual packages can also be excluded from updates. These are configured in the /etc/yum.conf file, look for a line that starts with exclude.
Another very common problem is the presence of broken repositories, which can make the entire yum update process fail.
This can happen for several reasons, such as a typo in the configuration files, or repositories that are no longer available or have changed their URLs.
Unlike other yum issues, this one tends to be easy to diagnose because the program will display an error that indicates the failed repository.
Edit its file in /etc/yum.repos.d and either correct the mistake or disable the broken repository completely, in order to allow the rest of the update to finish.
Yum will normally install and update any dependencies automatically, without additional user input. There are cases however when a package can’t be installed because a dependency is not found or is the wrong version.
This issue can be quite complex and there is no general fix available for it.
Sometimes you can simply install the missing dependencies manually, and then execute the initial command again. Version conflicts can be fixed by uninstalling the package found on the system.
In some cases, the only option is to configure an additional repository where the correct dependency can be found.
The package manager can be configured to keep package data on disk after an installation, in order to speed up future tasks.
By default, the location where the data is stored is the /var/cache/yum folder.
Sometimes, the cache can become corrupt and cause the command to fail completely. You can manually delete all the contents of the cache folder, or use the yum command itself to clean it:
yum clean all
The above command deletes all data in the folder, an alternative is to force yum to check the cache without deleting it:
CentOs 7 systems maintain two different package databases on disk, both of them can become corrupted and lead to errors.
When the RPM database is broken, yum will throw errors similar to “Fatal error, run database recovery”.
You will have to manually delete the database, and then rebuild it with these commands:
rm -f /var/lib/rpm/__db*
yum clean all
Yum’s own package information database is stored under the folder /var/lib/yum/yumdb and can be accessed using the yumdb command (part of the yum-utils package).
When the database is broken, it can trigger the “database disk image is malformed” error when running yum.
In most cases, the issue is easily fixed with this command:
yum clean dbcache
However, if updates still fail afterwards, you might have to rebuild the RPM database first, and then clean the yum one again.
Yum is a very powerful package manager that greatly simplifies software installation and updates. While there are many possible causes of yum failure, we have presented the most common ones in the limited space of this blog post, as well as the required troubleshooting steps.
- cPanel Question 47
- cPanel Software Management 29
- cPanel Tutorials 13
- Development 29
- Domain 13
- General 19
- Linux Helpline (Easy Guide) 156
- Marketing 47
- MySQL Question 13
- News 2
- PHP Configuration 14
- SEO 4
- SEO 42
- Server Administration 84
- SSL Installation 54
- Tips and Tricks 24
- VPS 3
- Web Hosting 44
- Website Security 22
- WHM questions 13
- WordPress 148
Subscribe Now10,000 successful online businessmen like to have our content directly delivered to their inbox. Subscribe to our newsletter!
Posted on : Sep 17
Posted on : Sep 10
Posted on : Aug 04
Posted on : Apr 01
- server load
- ddos mitigation
- layer 7
- seo vpn
- Hosting Security
- smtp relay
- VPS Hosting
- cheap vpn
- Small Business
- SSD Hosting
- Link Building