1. cPanel & WHM Documentation
  2. WHM
  3. Scripts
  4. The find_and_fix_rpm_issues Script
whmadvanced rpms

The find_and_fix_rpm_issues Script

Valid for versions 82 through the latest version

Version:

82

Last modified: March 27, 2024

Overview

The /usr/local/cpanel/scripts/find_and_fix_rpm_issues script detects issues with your server’s RPM database and rebuilds the database if problems exist. This script also detects duplicate cPanel RPMs, removes them, and then re-installs them if necessary. You can use this script if you experience failures when you install RPMs.

Note:
  • You must run this script as the root user.
  • You can also rebuild the RPM database in WHM’s Rebuild RPM Database interface (WHM » Home » Software » Rebuild RPM Database).
  • For a list of common RPM installation issues, read our RPM Installation Failures documentation.
  • This script does not support Ubuntu operating systems.

Run the script

To run this script on the command line, use the following format:

/usr/local/cpanel/scripts/find_and_fix_rpm_issues [option]

Options

Use the following options with this script:

Important:
You can only pass one option when you run the script.
Options Description Example
--findonly Detect and report any RPM problems, but do not make any changes. --findonly
--rebuildonly Unconditionally rebuild the RPM database. --rebuildonly

Example

For example, to check for RPM database issues but not rebuild the database, run the following command:

/usr/local/cpanel/scripts/find_and_fix_rpm_issues --findonly

Output

The output will display any issues that the system finds with the RPM database.

The script’s output could resemble the following example:

1
2
3
4
5
6
7
8
9

Checking that the RPM DB is OK...
glibc-2.17-222.el7.x86_64
OK: RPM DB is responding to queries
Testing if rpm_is_working RPM is installed
package rpm_is_working is not installed
Testing if it's possible to install a simple RPM
Preparing...                          ########################################
Updating / installing...
rpm_is_working-1.0-0                  ########################################

If you pass the --rebuildonly option, the script does not return output.

Additional Documentation