How to Set or Unset RPM Management


Last modified: September 3, 2019

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

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 or 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:

  • Bandminbandmin

    Warning:

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

  • Couriercourier

    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

  • NSDnsd

    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 lists the associated targets for cPanel & WHM services:

  • Third-party software3rdparty

    Warning:

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

  • Analog Statsanalog

  • AWStatsawstats

  • ClamAV Scannerclamav

  • Composercomposer

  • cPanel privilege managementcpanel-wrap

    Warning:

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

  • cPanelcpanel

    Warning:

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

  • cPanel Developer Toolscpanel-devel

    Note:

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

  • Dovecotdovecot

    Note:

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

  • Eximexim

    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, horde72

    Note:

    We added horde72 in cPanel & WHM version 84.

  • Mailmanmailman

  • MariaDBMariaDB100, MariaDB101, or MariaDB102

    Note:

    We added MariaDB102 in cPanel & WHM version 66.

  • Muninmunin

  • MyDNSmydns

  • MySQLMySQL50, 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 Modulespam

    Note:

    We added this target in cPanel & WHM version 72.

  • Perl 5.22perl522

    Warning:
    • 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.24perl524

    Warning:

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

  • Perl 5.26perl526

    Warning:

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

  • Perl 5.28perl528

    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.

  • PHPcpanel-php56, cpanel-php72, cpanel-php73

    Note:
    • We added cpanel-php73 in cPanel & WHM version 84.
    • We added cpanel-php72 and removed the cpanel-php56 target in cPanel & WHM version 76.

  • PowerDNSpowerdns

  • Roundcube Webmailroundcube

  • cPanel Site Publishersitepublisher

  • SQLitesqlite

  • SquirrelMailcpanel-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.service 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:
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    
    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 the 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.service
    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 command 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:
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    
    file_format:
      version: 2
    install_targets: {}
    rpm_groups: {}
    rpm_locations: {}
    srpm_sub_packages: {}
    srpm_versions: {}
    target_settings:
      cpanel-devel: installed
    url_templates: {}

Additional Documentation