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

Overview

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

Common unmanaged RPM problems

Warning:

You may experience problems with certain services if cPanel & WHM does not manage them:
  • The rpm.versions system does not update unmanaged RPMs. These RPMs require manual upgrades and maintenance.
  • If you upgrade a server with unmanaged FTP targets, problems may occur in cPanel's FTP-related interfaces. For more information, read our How to Restore Missing FTP Interfaces in cPanel documentation.
  • Unmanaged RPM targets may become upgrade blockers for a future version of cPanel & WHM.
  • If a MySQL® RPM target is unmanaged, 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 RPM targets.

Upgrade MySQL/MariaDB interface errors

The system will notify you when the RPM target for the blocked version of MySQL® is not installed. The following message will appear in WHM's MySQL or MariaDB Upgrade interface (WHM >> Home >> Software >> MySQL/MariaDB Upgrade):

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 fix this issue, you must set the MySQL RPM target to the managed state. This allows cPanel & WHM to manage the RPM. To do this, perform the steps in the Return an RPM target to the managed state section below.

Important:

In cPanel & WHM version 11.50 and later, if you set a MySQL target to the unmanaged state, the system also blocks MariaDB® on the server. To run a cPanel-managed install for MySQL or MariaDB, the rpm.versions system must manage the RPM targets for both.

Why is my RPM target set to unmanaged?

Warning:

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 in the unmanaged state, even if you did not change them:

ServiceAssociated target
Bandmin

bandmin

Warning:

We removed the Bandmin feature from cPanel & WHM version 58. This feature only exists in cPanel & WHM version 56 and earlier.

Courier

courier

Warning:

We removed the Courier mail server in cPanel & WHM version 54. The Courier mail server only exists for cPanel & WHM version 11.52 and earlier.

Dovecot®

dovecot

Note:

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

FTPproftpd and pure-ftpd
MySQLMySQL55, MySQL56, or MySQL57
NSD
nsd

Warning:

We deprecated the MyDNS and NSD nameservers in cPanel & WHM version 78 and plan to remove them a future release. We strongly recommend that you migrate to PowerDNS. For more information, read our cPanel Deprecation Plan.

What is an RPM target?

The rpm.versions system uses target settings. This determines whether the system will install or uninstall a target's specific RPMs. The /usr/local/cpanel/etc/rpm.versions file contains the target_settings section. This contains the cPanel-provided default status for each target.

For example, cPanel provides a distribution of Clam AntiVirus Scanner (ClamAV). This consists of the following RPMs:

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

In this example, the /usr/local/cpanel/etc/rpm.versions file's setting for the clamav RPM target controls the ClamAV RPMs. It also determines how the rpm.versions system manages these components. For more information, read our rpm.versions file documentation.

List of RPM targets

This table lists the associated targets for cPanel & WHM services:

ServiceAssociated target
Third-party software

3rdparty

Warning:

Never set this target to unmanaged. This can cause serious problems on your server.

Analog Statsanalog
AWStatsawstats
ClamAV Scannerclamav
Composercomposer

cPanel privilege management

cpanel-wrap

Warning:

Never set this target to the unmanaged state. This can cause serious problems on your server.

cPanel

cpanel

Warning:

Never set this target to the unmanaged state. This can cause serious problems on your server.

cPanel Developer Tools

cpanel-devel

Note:

This controls the files that allow you to rebuild certain RPMs provided by cPanel. 

Dovecot

dovecot

Note:

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

Exim

exim

Warning:

Only experienced users should set this target to unmanaged. If you do not understand the effects of the change, it can cause serious problems on your server.

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, MySQL56, or MySQL57

Note:

  • We deprecated the MySQL50 and MySQL51 targets in cPanel & WHM version 60. We removed them in cPanel & WHM version 68.
  • We added MySQL57 in cPanel & WHM version 70.
  • We removed the MySQL55 target in cPanel & WHM version 80.
NSDnsd
Obsolete servicesobsolete
Passive OS Fingerprintingp0f
PHPMyAdminphpmy
Pluggable Authentication Modules

pam

Note:

We added this target in cPanel & WHM version 72.

Perl 5.22

perl522

Warnings:

  • Never set this target to the unmanaged state. This can cause serious problems on your server.

  • We removed this target in cPanel & WHM version 64.
Perl 5.24

perl524

Warning:

Never set this target to the unmanaged state. This can cause serious problems on your server.

Perl 5.26

perl526

Warning:

Never set this target to the unmanaged state. This can cause serious problems on your server.

Perl 5.28

perl528

Warning:

Never set this target to the unmanaged state. This can cause serious problems on your server.

Note:

We added this target in cPanel & WHM version 78.

PHP

cpanel-php56, cpanel-php72

Note:

  • We removed the cpanel-php56 target in cPanel & WHM version 76.
  • We added cpanel-php72 in cPanel & WHM version 76.
PowerDNSpowerdns
Roundcube Webmailroundcube
cPanel Site Publishersitepublisher
SQLitesqlite
SquirrelMail

cpanel-squirrelmail

Warning:

  • We deprecated SquirrelMail and its functionality in cPanel & WHM version 76.
  • We removed SquirrelMail in cPanel & WHM version 78.
  • When you upgrade to cPanel & WHM version 78 or later, the system will remove this target.
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. In this example, target represents the name of the RPM target that you want to set to the unmanaged state:

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

    Note:

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

  2. Confirm that the RPM target is now unmanaged. Open the following file in your preferred text editor:

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

    Notice the RPM target's unmanaged value. For example, if you use the roundcube RPM target, this file might look like the following example:

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

Return an RPM target to the managed state

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

  1. Run the following command. In this example, target represents the name of the RPM target that you want to set to the managed state:

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

    Note:

    • This script's --del option returns an RPM target to its default managed state. This can be either an installed or uninstalled state.
    • To set FTP services to the managed state, you must run this commands for both the pure-ftpd and proftpd RPM targets.
  2. 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 file no longer lists the RPM target in the target_settings list. For example, if you use the roundcube RPM target, this file might look like the following example:

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

Additional documentation