Page tree
Skip to end of metadata
Go to start of metadata

This document is for a previous release of cPanel & WHM. To view our latest documentation, visit our Home page.

For cPanel & WHM 11.40

Overview

An RPM target represents the group of RPMs that must be present on the server for a specific service to function properly.

Note:

For more information about how to override an RPM target in the /usr/local/cpanel/etc/rpm.versions file, read our How to Override the rpm.versions System and The /scripts/update_local_rpm_versions Script documentation.

 

What is an RPM target?

The rpm.versions system uses the target to determine whether the specific RPMs that are associated with that target should be installed or uninstalled. The cPanel-provided default for each target is listed in the target_settings section of the /usr/local/cpanel/etc/rpm.versions file.

For example, the cPanel-provided distribution of ClamAV consists of three RPMs: 

  • cpanel-clamav
  • cpanel-clamav-virusdefs
  • cpanel-perl-514-File-Scan-ClamAV

In the /usr/local/cpanel/etc/rpm.versions file, the setting for the clamav RPM target controls how the rpm.versions system manages all three of these components. 

For more information about the /usr/local/cpanel/etc/rpm.versions file, read our The /usr/local/cpanel/etc/rpm.versions File documentation.

 

List of RPM targets

The following table lists the associated targets for cPanel & WHM services:

ServiceAssociated target
third-party software

3rdparty

Warning:

Never set this target to unmanaged. It could cause serious problems on your server.

Bandminbandmin
ClamAV Scannerclamav
Couriercourier
cPanel

cpanel

Warning:

Never set this target to unmanaged. It could cause serious problems on your server.

cPanel Developer Tools

cpanel-devel

Note:

This RPM target controls the files that allow you to rebuild certain cPanel-provided RPMs. 

Dovecotdovecot
Exim

exim

Warning:

Only experienced system administrators, who understand the effects of the change, should set this target to unmanaged .

FTPproftpd and pure-ftpd
Gitgit
Muninmunin
MyDNSmydns
MySQLMySQL51, MySQL55, or MySQL56
NSDnsd
Perl 5.14

perl514

Warning:

Never set this target to unmanaged. It could cause serious problems on your server. 

PHPcpanel-php53 or cpanel-php54

 

RPM target states

The RPM targets on your server may be set to any of the following states:

  • installed — The rpm.versions system will ensure that the RPMs that are associated with that target are installed and functional.
  • uninstalled — The rpm.versions system will ensure that the RPMs that are associated with that target are uninstalled.
  • unmanaged — The rpm.versions system will ignore the RPMs that are associated with that target, regardless of whether they are installed on the server.

    Warning:

    You may experience problems with certain services if their targets are set to unmanaged:
    • RPMs for which the target is set to unmanaged are not updated through the rpm.versions system, and therefore require manual upgrades and maintenance.
    • If you upgrade a server for which the FTP targets are set to unmanaged, problems may occur in cPanel's FTP-related interfaces. 
    • It is possible that unmanaged RPM targets may become upgrade blockers for a future version of cPanel & WHM.

 

 

Why is my RPM target set to unmanaged?

The RPM targets for the following services may be set to the unmanaged state, even if you did not actively change them:

ServiceAssociated target
Bandminbandmin
Couriercourier
Dovecotdovecot
FTPproftpd and pure-ftpd
MySQLMySQL50, MySQL51, MySQL55, or MySQL56
NSDnsd

 

In cPanel & WHM version 11.34 and earlier, the update settings for these services were configured in the cPanel Package Updates feature. When cPanel implemented the rpm.versions system in cPanel & WHM version 11.36, these services were converted to the RPM system. If the services' updates were set to Never in the cPanel Package Updates interface, their targets were automatically set as unmanaged in the rpm.versions system.

 

The cPanel Package Updates feature in cPanel & WHM version 11.34


Warning:

While it was sometimes practical to set service updates to Never in earlier versions of cPanel & WHM, the related problems have been solved in more recent versions. We strongly encourage you to allow the rpm.versions system to manage all RPM targets.

 

Legacy RPMs

The RPMs that cPanel provided prior to the implementation of the rpm.versions system are now called "legacy" RPMs. The settings in the /var/cpanel/cpanel.config file control these legacy RPMs. The system stores these settings in the /usr/local/cpanel/etc/rpm.versions file.

Note:

As with all RPMs, the files in the /var/cpanel/rpm.versions.d/ directory can override the target_settings configuration. 

 

cpanel.config file settings

The following table lists the settings in the /var/cpanel/cpanel.config file that control the actions of legacy RPMs:

cpanel.config settingRPM target
mysql-versionMySQL51, MySQL55
local_nameserver_typebind, mydns, nsd
mailservercourier, dovecot
ftpserverpure-ftpd, proftpd