Overview

The /usr/local/cpanel/etc/rpm.versions file contains all of the cPanel-provided settings for the rpm.versions system. cPanel provides 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 each of the file's headers and their contents.

We strongly recommend that you never 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 file to make changes.

install_targets — Target components and dependencies

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

Each target entry displays information in the following format:

rpmtarget:
    components:
      - component_rpm_1
      - component_rpm_2
    dependencies:
      - dependency_1
      - dependency_2 

This example uses the following variables:

Instead of individual RPMs, the components and dependencies sections may also list the names of RPM groups, as the rpm_groups section of the /usr/local/cpanel/etc/rpm.versions file defines. For more information, see the    rpm_groupsRPM groups section.

rpm_groups — RPM groups

The rpm_groups section of the /usr/local/cpanel/etc/rpm.versions 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.

Each group entry appears in the following format:

groupname:
    - grouped_rpm_1
    - grouped_rpm_2

This example uses the followng variables:

rpm_locations — RPM file locations

The rpm_locations section of the /usr/local/cpanel/etc/rpm.versions file specifies which URL template the rpm.versions system uses to find that target's RPMs.

Each file location entry appears in the following format:

  RPM: template

This example uses the following variables:

srpm_sub_packages — Source RPM information

The srpm_sub_packages section of the /usr/local/cpanel/etc/rpm.versions file specifies a list of Source RPMs (SRPMs) for each RPM target.

Each SRPM entry appears in the following format:

rpmtarget:
    - srpm1
    - srpm2
    - srpm3

This example uses the following variables:

srpm_versions — Source RPM versions

The srpm_versions section of the /usr/local/cpanel/etc/rpm.versions file specifies the exact version number for each RPM target.

Each SRPM version entry appears in the following format:

 

rpmtarget: version-revision.distribution

In this example:

For example, the SRPM version for the MySQL56 target appears similar to the following example:

MySQL56: 5.6.16-4.cp1142

This example uses the following variables:

target_settings — Target installation settings

The target_settings section of the /usr/local/cpanel/etc/rpm.versions file specifies each RPM target's default installation status.

For more information about RPM targets, read our RPM Targets documentation.

url_templates — URL templates

The url_templates section defines the template that the rpm.versions system uses to find specific RPM files. In the /usr/local/cpanel/etc/rpm.versions file, all of these templates point to locations on cPanel's httpupdate server.

Each URL template appears in one of the following formats:

 

template: 'http://[% httpupdate %]/RPM/version/[% rpm_dist %]/[% rpm_dist_ver %]/[% rpm_arch %]/[% package %]-[% package_version %]-[% package_revision %].[% rpm_arch %].rpm'
noarchtemplate: 'http://[% httpupdate %]/RPM/version/[% rpm_dist %]/[% rpm_dist_ver %]/[% rpm_arch %]/[% package %]-[% package_version %]-[% package_revision %].noarch.rpm'

This example uses the following variables:

Additional documentation