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

For cPanel & WHM version 60

Overview

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

What is an RPM target?

The rpm.versions system uses the target setting to determine whether to install or uninstall that target's specific RPMs. The target_settings section of the /usr/local/cpanel/etc/rpm.versions file contains the cPanel-provided default status for each target.

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

  • cpanel-clamav
  • cpanel-clamav-virusdefs
  • cpanel-perl-522-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 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.

Analog Statsanalog
AWStatsawstats
ClamAV Scannerclamav
Composercomposer
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 or pure-ftpd
Gitgit
Hordehorde
Mailmanmailman
MariaDB

MariaDB100, MariaDB101, or MariaDB102

Note:

We added MariaDB102 in cPanel & WHM version 66.

Muninmunin
MyDNSmydns
MySQL®

MySQL50, MySQL51, MySQL55, or MySQL56

Note:

We deprecated the MySQL50 and MySQL51 targets in cPanel & WHM version 60, and removed them in cPanel & WHM version 68. 

NSDnsd
Obsolete servicesobsolete
Passive OS Fingerprintingp0f
Perl 5.22

perl522

Warning:

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

Perl 5.24

perl524

Warning:

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

PHPcpanel-php56
PowerDNSpowerdns
Roundcube Webmailroundcube
SQLitesqlite
System updateupdatenow
cPanel user interfaceuserinterface
Webalizerwebalizer

RPM target states

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

  • installed — The rpm.versions system ensures that the RPMs that are associated with that target are installed and functional.
  • uninstalled — The rpm.versions system ensures that the RPMs that are associated with that target are uninstalled.
  • unmanaged  — The rpm.versions system ignores 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:
    • The rpm.versions system does not update RPMs for which the target is set to unmanaged. These RPMs 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.
    • If you set a MySQL target to the unmanaged state, the system also blocks MariaDB on the server. To successfully use a cPanel-managed installation of either MySQL or MariaDB, the rpm.versions system must manage both softwares' RPM targets.

For more information, read our How to Set or Unset RPM Management documentation.

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-versionMySQL55, MySQL56, MariaDB100
local_nameserver_typebind, mydns, nsd
mailserverdovecot, exim
ftpserverpure-ftpd, proftpd

For more information, read our The cpanel.config File documentation.

Additional documentation

  • How to Set or Unset RPM Management — This document provides steps for how to set RPM targets to unmanaged, and how to return RPM targets to a managed state.
  • How to Override the rpm.versions System — This document explains the files in the /var/cpanel/rpm.versions.d/ directory, which system administrators and third-party developers can use to modify cPanel-provided RPM management.
  • The update_local_rpm_versions Script — Use the /scripts/update_local_rpm_versions script to update the /var/cpanel/rpm.versions.d/local.versions file.

There is no content with the specified labels