{"id":263,"date":"2021-07-23T12:26:48","date_gmt":"2021-07-23T12:26:48","guid":{"rendered":"https:\/\/ssdsunucum.com\/blog\/the-check_cpanel_rpms-script\/"},"modified":"2021-07-23T12:26:48","modified_gmt":"2021-07-23T12:26:48","slug":"the-check_cpanel_rpms-script","status":"publish","type":"post","link":"https:\/\/ssdsunucum.com\/blog\/the-check_cpanel_rpms-script\/","title":{"rendered":"The check_cpanel_rpms Script"},"content":{"rendered":"<\/p>\n
\n
<\/div>\n
\n

Overview<\/h2>\n

The \/usr\/local\/cpanel\/scripts\/check_cpanel_rpms<\/code> script scans every installed RedHat\u00ae Package Manager (RPM) file on your server for problems. This script can also reinstall any affected cPanel & WHM RPMs to repair them.<\/p>\n

\n
Note:<\/div>\n
\n

To run the \/usr\/local\/cpanel\/scripts\/check_cpanel_rpms<\/code> script nightly, use the Maintenance cPanel RPM Check<\/em> and Maintenance cPanel RPM Digest Check<\/em> settings in the Software<\/em> section of WHM\u2019s Tweak Settings interface (WHM >> Home >> Server Configuration >> Tweak Settings<\/em>).<\/p>\n<\/p><\/div>\n<\/div>\n

Script functions<\/h2>\n

The \/usr\/local\/cpanel\/scripts\/check_cpanel_rpms<\/code> script performs four basic functions each time that it runs:<\/p>\n

    \n
  1. Discovers missing RPMs.<\/li>\n
  2. Tracks RPMs that are out-of-date and need updates.<\/li>\n
  3. Checks for any altered RPMs. Altered RPMs meet any of the following conditions:\n
      \n
    • Unordered sub-list.<\/li>\n
    • Unordered sub-list.<\/li>\n
    • Their mode has changed.<\/li>\n
    • An MD5 checksum does not exist.<\/li>\n
    • They are symlinks, and the file points to the wrong path.<\/li>\n
    • They are missing.<\/li>\n<\/ul>\n<\/li>\n
    • Checks whether to uninstall any cPanel-managed RPMs.<\/li>\n<\/ol>\n
      \n
      Note:<\/div>\n
      \n
        \n
      • The \/usr\/local\/cpanel\/scripts\/check_cpanel_rpms<\/code> script runs for a few minutes. If it does not detect any problems, it will not<\/strong> produce any output and exit to the command prompt.<\/li>\n
      • The \/usr\/local\/cpanel\/scripts\/check_cpanel_rpms<\/code> script does not<\/strong> check for problems with incorrect file permissions.<\/li>\n<\/ul><\/div>\n<\/div>\n

        Run the script<\/h2>\n

        To run the \/usr\/local\/cpanel\/scripts\/check_cpanel_rpms<\/code> script on the command line, use the following format:\n<\/p>\n

        \n
        \/usr\/local\/cpanel\/scripts\/check_cpanel_rpms [<\/span>options]<\/span><\/code><\/pre>\n<\/div>\n
        Options<\/h3>\n
        You can use the following options with the \/usr\/local\/cpanel\/scripts\/check_cpanel_rpms<\/code> script:<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n
        Options<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
        --download-only<\/code><\/td>\nDownloads any missing packages to the \/usr\/local\/cpanel\/tmp\/rpm.versions<\/code> file, then exits.<\/p>\n
          \n
        • The script downloads a new copy of a package only<\/strong> if the package is missing.<\/li>\n
        • If the package already exists, the script lists the package name only<\/strong> and then exits.<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n
        --fix<\/code><\/td>\nShows any problems and automatically corrects them.<\/td>\n<\/tr>\n
        --list-only<\/code><\/td>\nLists altered RPMs and then exits.<\/td>\n<\/tr>\n
        --long-list<\/code><\/td>\nShows the altered RPMs and files in an easily-parsed format.<\/td>\n<\/tr>\n
        --no-broken<\/code><\/td>\nInstalls missing RPMs and uninstalls unneeded RPMs. The script will not check for broken RPMs.<\/td>\n<\/tr>\n
        --no-digest<\/code><\/td>\nPerforms a size validation.<\/p>\n
          \n
        • This option will not report altered RPMs.<\/li>\n
        • If the script detects an altered RPM, but the file size is identical, this option will not report the change.<\/li>\n
        • This option applies the --nodigest<\/code> and --nomd5<\/code> options to the rpm -Vv<\/code> check.<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n
        --nodir<\/code><\/td>\nThe script will not read the \/var\/cpanel\/rpm.versions.d<\/code> directory.<\/td>\n<\/tr>\n
        --notify<\/code><\/td>\nSends a notification that lists any altered RPMs. Then, the script describes any actions that the system performed.<\/td>\n<\/tr>\n
        --targets<\/code><\/td>\nFilters RPMs based on provided targets (comma-delimited).<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
        Example<\/h3>\n
        For example, to use the --fix<\/code> option, run the following command:\n<\/p>\n
        \n
        \/usr\/local\/cpanel\/scripts\/check_cpanel_rpms --fix<\/code><\/pre>\n<\/div>\n
        Checks performed<\/h2>\n
        The \/usr\/local\/cpanel\/scripts\/check_cpanel_rpms<\/code> script runs the rpm -Vv<\/code> check on all cPanel-managed RPMs. This checks for changes in the files since their installation. The script does not check configuration and documentation files.<\/p>\n
        \n
        Note:<\/div>\n
        \n
        If the output indicates that only Mode<\/code> or mTime<\/code> have changed, the script will not report that as an altered RPM.<\/p>\n<\/p><\/div>\n<\/div>\n
        The output of the rpm -Vv<\/code> check lists the following changes:<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n
        Check<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
        S<\/code><\/td>\nFile size differs.<\/td>\n<\/tr>\n
        M<\/code><\/td>\nMode differs. This includes permissions and file type.<\/td>\n<\/tr>\n
        5<\/code><\/td>\nMD5 sum differs.<\/td>\n<\/tr>\n
        D<\/code><\/td>\nDevice major or minor number mismatch.<\/td>\n<\/tr>\n
        L<\/code><\/td>\nreadLink(2)<\/code> path mismatch.<\/td>\n<\/tr>\n
        U<\/code><\/td>\nUser ownership differs.<\/td>\n<\/tr>\n
        G<\/code><\/td>\nGroup ownership differs.<\/td>\n<\/tr>\n
        T<\/code><\/td>\nmTime<\/code> differs. mTime<\/code> refers to the last time the file was modified.<\/td>\n<\/tr>\n
        P<\/code><\/td>\nCapabilities differ.<\/td>\n<\/tr>\n<\/tbody>\n<\/table><\/div>\n","protected":false},"excerpt":{"rendered":"
        Overview The \/usr\/local\/cpanel\/scripts\/check_cpanel_rpms script scans every installed RedHat\u00ae Package Manager (RPM) file on your server for problems. This script can also reinstall any affected cPanel & WHM RPMs to repair them. Note: To run the \/usr\/local\/cpanel\/scripts\/check_cpanel_rpms script nightly, use the Maintenance cPanel RPM Check and Maintenance cPanel RPM Digest Check settings in the Software section …<\/p>\n","protected":false},"author":1,"featured_media":264,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[1],"tags":[],"amp_enabled":true,"_links":{"self":[{"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/posts\/263"}],"collection":[{"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/comments?post=263"}],"version-history":[{"count":0,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/posts\/263\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/media\/264"}],"wp:attachment":[{"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/media?parent=263"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/categories?post=263"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/tags?post=263"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}