{"id":265,"date":"2021-07-23T12:26:51","date_gmt":"2021-07-23T12:26:51","guid":{"rendered":"https:\/\/ssdsunucum.com\/blog\/the-rpm-versions-file\/"},"modified":"2021-07-23T12:26:51","modified_gmt":"2021-07-23T12:26:51","slug":"the-rpm-versions-file","status":"publish","type":"post","link":"https:\/\/ssdsunucum.com\/blog\/the-rpm-versions-file\/","title":{"rendered":"The rpm.versions File"},"content":{"rendered":"<\/p>\n
\n
<\/div>\n
\n

Overview<\/h2>\n

The \/usr\/local\/cpanel\/etc\/rpm.versions<\/code> file contains all of the cPanel-provided settings for the rpm.versions system. We provide these settings based on the version of cPanel & WHM that your server runs. Your server automatically updates this file whenever cPanel & WHM updates.<\/p>\n

The system stores the \/usr\/local\/cpanel\/etc\/rpm.versions<\/code> file in the YAML format. The sections below describe each of the file\u2019s headers and their contents.<\/p>\n

\n
Warning:<\/div>\n
\n

We strongly recommend that you never<\/strong> directly edit this file, because you will lose your changes when you perform an upgrade. Instead, use the \/var\/cpanel\/rpm.versions.d\/local.versions<\/code> file to make changes.<\/p>\n<\/p><\/div>\n<\/div>\n

install_targets \u2014 Target components and dependencies<\/h2>\n

The install_targets<\/code> section of the \/usr\/local\/cpanel\/etc\/rpm.versions<\/code> file lists each RPM target with its component RPMs and dependencies.<\/p>\n

Each target entry displays information in the following format:<\/p>\n

\n
\n\n\n
\n
1\n<\/span>2\n<\/span>3\n<\/span>4\n<\/span>5\n<\/span>6\n<\/span>7\n<\/span><\/code><\/pre>\n<\/td>\n
\n
rpmtarget<\/span>:\n    components<\/span>:\n      -<\/span> component_rpm_1<\/span>\n      -<\/span> component_rpm_2<\/span>\n    dependencies<\/span>:\n      -<\/span> dependency_1<\/span>\n      -<\/span> dependency_2<\/span><\/code><\/pre>\n<\/td>\n<\/tr>\n<\/table>\n<\/div>\n<\/div>\n
This example uses the following variables:<\/p>\n
    \n
  • rpmtarget<\/code> is the name of the RPM target.<\/li>\n
  • component_rpm_1<\/code> and component_rpm_2<\/code> are RPMs that are necessary for the rpmtarget<\/code> service to function properly.<\/li>\n
  • dependency_1<\/code> and dependency_2<\/code> are additional RPMs on which the component RPMs are dependent.<\/li>\n<\/ul>\n
    \n
    Note:<\/div>\n
    \n
    Instead of individual RPMs, the components<\/code> and dependencies<\/code> sections may also list the names of RPM groups, as the rpm_groups<\/code> section of the \/usr\/local\/cpanel\/etc\/rpm.versions<\/code> file defines.<\/p>\n<\/p><\/div>\n<\/div>\n
    rpm_groups \u2014 RPM groups<\/h2>\n
    The rpm_groups<\/code> section of the \/usr\/local\/cpanel\/etc\/rpm.versions<\/code> file lists groups of RPMs under their assigned group name. In the other sections of the file, this group name represents that list of RPMs, which eliminates the need for repetitive lists of frequently-used RPM names.<\/p>\n
    Each group entry appears in the following format:<\/p>\n
    \n
    \n\n\n
    \n
    1\n<\/span>2\n<\/span>3\n<\/span><\/code><\/pre>\n<\/td>\n
    		\n
    groupname<\/span>:\n    -<\/span> grouped_rpm_1<\/span>\n    -<\/span> grouped_rpm_2<\/span><\/code><\/pre>\n<\/td>\n<\/tr>\n<\/table>\n<\/div>\n<\/div>\n
    This example uses the followng variables:<\/p>\n
      \n
    • groupname<\/code> is the name of the RPM group.<\/li>\n
    • grouped_rpm_1<\/code> and grouped_rpm_2<\/code> are the names of individual RPMs that are part of the group.<\/li>\n<\/ul>\n
      rpm_locations \u2014 RPM file locations<\/h2>\n
      The rpm_locations<\/code> section of the \/usr\/local\/cpanel\/etc\/rpm.versions<\/code> file specifies which URL template the rpm.versions system uses to find that target\u2019s RPMs.<\/p>\n
      Each file location entry appears in the following format:<\/p>\n
      \n
      RPM: template<\/code><\/pre>\n<\/div>\n
      This example uses the following variables:<\/p>\n
        \n
      • RPM<\/code> is the name of the RPM.<\/li>\n
      • template<\/code> is the name of the URL template, as the file\u2019s url_templates<\/code> section specifies.<\/li>\n<\/ul>\n
        srpm_sub_packages \u2014 Source RPM information<\/h2>\n
        The srpm_sub_packages<\/code> section of the \/usr\/local\/cpanel\/etc\/rpm.versions<\/code> file specifies a list of Source RPMs (SRPMs) for each RPM target.<\/p>\n
        Each SRPM entry appears in the following format:<\/p>\n
        \n
        \n\n\n
        \n
        1\n<\/span>2\n<\/span>3\n<\/span>4\n<\/span><\/code><\/pre>\n<\/td>\n
        		\n
        rpmtarget<\/span>:\n    -<\/span> srpm1<\/span>\n    -<\/span> srpm2<\/span>\n    -<\/span> srpm3<\/span><\/code><\/pre>\n<\/td>\n<\/tr>\n<\/table>\n<\/div>\n<\/div>\n
        This example uses the following variables:<\/p>\n
          \n
        • rpmtarget<\/code> is the name of the RPM target.<\/li>\n
        • srpm1<\/code>, srpm2<\/code>, and srpm3<\/code> are the names of the target\u2019s SRPMs.<\/li>\n<\/ul>\n
          srpm_versions \u2014 Source RPM versions<\/h2>\n
          The srpm_versions<\/code> section of the \/usr\/local\/cpanel\/etc\/rpm.versions<\/code> file specifies the exact version number for each RPM target.<\/p>\n
          Each SRPM version entry appears in the following format:<\/p>\n
          \n
          rpmtarget: version-revision.distribution<\/code><\/pre>\n<\/div>\n
          In this example:<\/p>\n
            \n
          • rpmtarget<\/code> is the name of the RPM target.<\/li>\n
          • version<\/code> is the exact version number.<\/li>\n
          • revision<\/code> is the revision number for the RPM.<\/li>\n
          • distribution<\/code> corresponds to the major version of cPanel & WHM with which this version was released.<\/li>\n<\/ul>\n
            For example, the SRPM version for the MySQL56<\/code> target appears similar to the following example:<\/p>\n
            \n
            MySQL56: 5<\/span>.6.16-4.cp1142<\/code><\/pre>\n<\/div>\n
            This example uses the following variables:<\/p>\n
              \n
            • The MySQL\u00ae version is 5.6.16<\/code>.<\/li>\n
            • The revision number is 4<\/code>.<\/li>\n
            • The version of cPanel & WHM is version 11.42.<\/li>\n<\/ul>\n
              target_settings \u2014 Target installation settings<\/h2>\n
              The target_settings<\/code> section of the \/usr\/local\/cpanel\/etc\/rpm.version<\/code> file specifies each RPM target\u2019s default installation status.<\/p>\n
              For more information about RPM targets, read our RPM Targets documentation.<\/p>\n
              unsupported_rpms – Unsupported RPMs<\/h2>\n
              The unsupported_rpms<\/code> section of usr\/local\/cpanel\/etc\/rpm.versions<\/code> file specifies RPMs that an operating system will not install.<\/p>\n
              The following example from cPanel & WHM version 94 demonstrates this section of the file:\n<\/p>\n
              \n
              \n\n\n
              \n
              1\n<\/span>2\n<\/span>3\n<\/span>4\n<\/span><\/code><\/pre>\n<\/td>\n
              		\n
              redhat6<\/span>:\n  -<\/span> cpanel<\/span>-<\/span>perl<\/span>-<\/span>532<\/span>-<\/span>Linux<\/span>-<\/span>Systemd<\/span>\nredhat8<\/span>:\n  -<\/span> cpanel<\/span>-<\/span>perl<\/span>-<\/span>532<\/span>-<\/span>Authen<\/span>-<\/span>Libwrap<\/span><\/code><\/pre>\n<\/td>\n<\/tr>\n<\/table>\n<\/div>\n<\/div>\n
              url_templates \u2014 URL templates<\/h2>\n
              The url_templates<\/code> section defines the template that the rpm.versions system uses to find specific RPM files. In the \/usr\/local\/cpanel\/etc\/rpm.versions<\/code> file, all of these templates point to locations on cPanel\u2019s httpupdate server.<\/p>\n
              Each URL template appears in one of the following formats:<\/p>\n
              \n
              \n\n\n
              \n
              1\n<\/span>2\n<\/span><\/code><\/pre>\n<\/td>\n
              		\n
              template<\/span>: '<\/span>http<\/span>:\/\/[% httpupdate %]\/RPM\/version\/[% rpm_dist %]\/[% rpm_dist_ver %]\/[% rpm_arch %]\/[% package %]-[% package_version %]-[% package_revision %].[% rpm_arch %].rpm'\n<\/span><\/span>noarchtemplate<\/span>: '<\/span>http<\/span>:\/\/<\/span>[%<\/span> httpupdate<\/span> %<\/span>]\/<\/span>RPM<\/span>\/<\/span>version<\/span>\/<\/span>[%<\/span> rpm_dist<\/span> %<\/span>]\/<\/span>[%<\/span> rpm_dist_ver<\/span> %<\/span>]\/<\/span>[%<\/span> rpm_arch<\/span> %<\/span>]\/<\/span>[%<\/span> package<\/span> %<\/span>]-<\/span>[%<\/span> package_version<\/span> %<\/span>]-<\/span>[%<\/span> package_revision<\/span> %<\/span>].noarch<\/span>.rpm<\/span>'<\/span><\/code><\/pre>\n<\/td>\n<\/tr>\n<\/table>\n<\/div>\n<\/div>\n
              This example uses the following variables:<\/p>\n
                \n
              • template<\/code> and noarchtemplate<\/code> are the names of RPM file location templates.<\/li>\n
              • httpupdate<\/code> is the hostname at which to download the RPMs.<\/li>\n
              • version<\/code> is the cPanel & WHM major version that first contained that RPM target.<\/li>\n
              • rpm_dist<\/code> is the name of the system\u2019s OS distribution (for example, centos<\/code>).<\/li>\n
              • rpm_dist_ver<\/code> is the system\u2019s OS distribution\u2019s version number (for example, 5<\/code>).<\/li>\n
              • rpm_arch<\/code> is the OS\u2019s architecture (for example, i686<\/code>).<\/li>\n
              • package<\/code> is the name of the RPM.<\/li>\n
              • package_version<\/code> is the RPM version number.<\/li>\n
              • package_revision<\/code> is the RPM revision number.<\/li>\n<\/ul>\n
                The presence or absence of .noarch<\/code> in the RPM\u2019s location indicates differences in the RPM template, which changes how the rpm.versions system generates information, such as RPM filenames, for that RPM.<\/p>\n<\/p><\/div>\n","protected":false},"excerpt":{"rendered":"
                Overview The \/usr\/local\/cpanel\/etc\/rpm.versions file contains all of the cPanel-provided settings for the rpm.versions system. We provide these settings based on the version of cPanel & WHM that your server runs. Your server automatically updates this file whenever cPanel & WHM updates. The system stores the \/usr\/local\/cpanel\/etc\/rpm.versions file in the YAML format. The sections below describe …<\/p>\n","protected":false},"author":1,"featured_media":266,"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\/265"}],"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=265"}],"version-history":[{"count":0,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/posts\/265\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/media\/266"}],"wp:attachment":[{"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/media?parent=265"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/categories?post=265"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/tags?post=265"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}