Overview

If you do not want cPanel & WHM's rpm.versions system to manage an RPM, you can set that RPM's target to unmanaged. This document provides steps for how to set RPM targets to both the managed and unmanaged states.

Common unmanaged RPM problems

Upgrade MySQL/MariaDB interface errors

The following message in WHM's MySQL or MariaDB Upgrade interface (WHM >> Home >> Software >> MySQL/MariaDB Upgrade), explains that the RPM target for the blocked version of MySQL® is not installed:

Your server's MySQL RPM target is set to "uninstalled". You cannot use the MySQL Upgrade feature while your server is in this state. To allow cPanel & WHM to upgrade MySQL on your server, read the rpm.versions system documentation.

To correct this issue, you must set the MySQL RPM target to the managed state, which allows cPanel & WHM to manage the RPM. To return the MySQL RPM target to the managed state, perform the steps in the Return an RPM target to the managed state section below.

In cPanel & WHM version 11.50 and later, if you set a MySQL target to the unmanaged state, the system will also block MariaDB on the server. To successfully run a cPanel-managed installation of either MySQL or MariaDB, the rpm.versions system must manage both softwares' RPM targets.

Why is my RPM target set to unmanaged?

We strongly recommend that you to allow the rpm.versions system to manage all RPM targets.

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

ServiceAssociated target
Bandmin

bandmin

Courier

courier

Dovecot®dovecot
FTPproftpd and pure-ftpd
MySQLMySQL55, MySQL56, or MySQL57
NSD

nsd

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: 

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

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


Analog Statsanalog
AWStatsawstats
ClamAV Scannerclamav
Composercomposer
cPanel

cpanel

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


cPanel Developer Tools

cpanel-devel

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


Dovecot

dovecot

We removed this target in cPanel & WHM version 58. The exim target controls Dovecot.


Exim

exim

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

We added MariaDB102 in cPanel & WHM version 66.


Muninmunin
MyDNSmydns
MySQL

MySQL50, MySQL51, MySQL55, MySQL56, or MySQL57

  • We deprecated the MySQL50 and MySQL51 targets in cPanel & WHM version 60, and removed them in cPanel & WHM version 68.
  • We removed the MySQL55 target in cPanel & WHM version 80.
  • We added MySQL57 in cPanel & WHM version 70.


NSDnsd
Obsolete servicesobsolete
Passive OS Fingerprintingp0f
Pluggable Authentication Modules

pam

We added this target in cPanel & WHM version 72.


Perl 5.22

perl522

  • Never set this target to unmanaged. It could cause serious problems on your server.
  • We removed this target in cPanel & WHM version 64.


Perl 5.24

perl524

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


Perl 5.26

perl526

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


Perl 5.28

perl528

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


PHP

cpanel-php56, cpanel-php72

  • We removed the cpanel-php56 target in cPanel & WHM version 76.
  • We added cpanel-php72 in cPanel & WHM version 76.


PowerDNSpowerdns
Roundcube Webmailroundcube
SQLitesqlite
SquirrelMail

cpanel-squirrelmail

We deprecated SquirrelMail and its functionality in cPanel & WHM version 76 and removed it in cPanel & WHM version 78.


System updateupdatenow
cPanel user interfaceuserinterface
Webalizerwebalizer


Set an RPM target to unmanaged

To set an RPM target to the unmanaged state, perform the following steps:

  1. Run the following command, where service represents the name of the RPM target that you wish to set to the unmanaged state:

    /usr/local/cpanel/scripts/update_local_rpm_versions --edit target_settings.service unmanaged


  2. To confirm that the target is unmanaged, open the following file in your preferred text editor:

    /var/cpanel/rpm.versions.d/local.versions 

    Notice the unmanaged value for the target. 

Example

If you set the pure-ftpd and proftpd targets to unmanaged, the /var/cpanel/rpm.versions.d/local.versions file might appear similar to the following example:

file_format: 
 version: 2
install_targets: {}
 
rpm_groups: {}
 
rpm_locations: {}
 
srpm_sub_packages: {}
 
srpm_versions: {}
 
target_settings: 
 cpanel-devel: installed
 pure-ftpd: unmanaged
 proftpd: unmanaged
url_templates: {}


To set FTP services to unmanaged, you must run these commands for both the pure-ftpd and proftpd RPM targets. 

Return an RPM target to the managed state

To return an unmanaged RPM target to the managed state, perform the following steps:

  1. Run the following command, where service represents the name of the RPM target that you wish to set to the managed state:

    /usr/local/cpanel/scripts/update_local_rpm_versions --del target_settings.service


    When you enter the --del option with the /usr/local/cpanel/scripts/update_local_rpm_versions script, you return that RPM target to its default in the managed state, which could be installed or uninstalled.


  2. To confirm that the RPM target is no longer unmanaged, open the following file in your preferred text editor:

    /var/cpanel/rpm.versions.d/local.versions 

    Notice that the /var/cpanel/rpm.versions.d/local.versions file no longer lists that RPM target.

To return FTP services to the managed state, you may must run these commands for both the pure-ftpd and proftpd targets. 

Additional documentation