Using rpm.versions.local to manage RPMs

For WHM version 11.38

As of cPanel & WHM 11.30, cPanel-managed RPMs are specific to versions of cPanel. This means that your cPanel-managed RPMs update only when cPanel & WHM updates.

cPanel-managed RPMs will be maintained based on the contents of /usr/local/cpanel/etc/rpm.versions, which will specify which version of an RPM is supported. This file only changes when cPanel updates.

To override any of the supported versions specified in rpm.versions, you will need to create the file /usr/local/cpanel/etc/rpm.versions.local.

• You should format this file similarly to rpm.versions.
• The system will not install or upgrade RPMs past the versions mentioned in rpm.versions.local.

Warning: If you choose this method to manage your RPMs, you may inadvertently block your cPanel version from upgrading. This can happen if you block RPMs that cPanel requires in order to update.

• Example: If you specify that you wish to support a custom Exim RPM, and the new version of cPanel requires Exim 4.72 for DKIM support, then cPanel will not upgrade until you resolve this conflict manually.

How do I format rpm.versions.local?

You must follow a specific format when modifying the rpm.versions.local file. The line format must adhere to the following example:

tag|identifier|URL

Note: Each section of the entry is pipe-delimited (|).

In the example above:

How do I format the templated URL?

The URL must follow this template:

http://[% httpupdate %]/RPM01/[% rpm_dist %]/[% rpm_dist_ver %]/[% rpm_arch %]/MySQL-client-5.1.56-0.glibc23.[% rpm_arch %].rpm

Each element in the URL contained within brackets ([ ]) is a variable that holds information about the system. Ultimately, these variables specify where the system will download the RPM. You can use any variable in /var/cpanel/sysinfo.config to create the URL. Only the following 4 variables are required:

Example

The following is an example of what you would need to put into the rpm.versions.local file in order to maintain the MySQL version 5.1.56.

mysql51_client|MySQL-client-5.1.56-0.glibc23|http://[% httpupdate %]/RPM01/[% rpm_dist %]/[% rpm_dist_ver %]/[% rpm_arch %]/MySQL-client-5.1.56-0.glibc23.[% rpm_arch %].rpm

Remember: Each main section of the entry is pipe-delimited (|).

In the example above: