Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Include Page
_Version
_Version

Table of Contents
maxLevel3
stylenone

Overview

When you upgrade to a newer version of cPanel & WHM or install cPanel & WHM on a new server, cPanel & WHM checks your system for compatibility with the version of cPanel & WHM that you wish to install.

Warning
titleImportant:

Before you begin a new installation, read our Installation Guide and System Requirements documentation.

Note
titleNote:

The cPanel & WHM installation and upgrade processes require at least 3 GB of additional disk space for staging purposes. 

What is a blocker?

Blockers are conditions that do not allow the cPanel & WHM update process (upcp) to install a particular version.

Upgrades that include multiple major versions

If you run an update that includes multiple major version upgrades of cPanel & WHM, the cPanel & WHM update process (upcp) will upgrade your server to each intermediate version. The update process performs compatibility checks for each intermediate version prior to the upgrade to that version.

For example, after a system administrator runs an update on a server that runs cPanel & WHM version 11.50, and the target version is cPanel & WHM version 56, the cPanel & WHM update process (upcp) performs the following actions:

  1. The update process detects that the system must first upgrade to cPanel & WHM version 11.52.
  2. The update process performs compatibility checks for the upgrade to cPanel & WHM version 11.52.
    • If the system is compatible, the update process upgrades cPanel & WHM to version 11.52.
    • If the system is not compatible, the update process sends a list of the compatibility issues to the system administrator, and the server remains on cPanel & WHM version 11.50.
  3. After the upgrade to version 11.52 is complete, the update process performs compatibility checks for the upgrade to cPanel & WHM version 54. 
    • If the system is compatible, the update process upgrades cPanel & WHM to version 54.
    • If the system is not compatible, the update process sends a list of the compatibility issues to the system administrator, and the server remains on cPanel & WHM version 11.52.
  4. After the upgrade to version 54 is complete, the update process performs compatibility checks for the upgrade to cPanel & WHM version 56. 
    • If the system is compatible, the update process upgrades cPanel & WHM to version 56.
    • If the system is not compatible, the update process sends a list of the compatibility issues to the system administrator, and the server remains on cPanel & WHM version 54.

System and software checks

The cPanel & WHM update and installation process performs two types of checks:

  • Standard — Standard checks apply to all installations and upgrades.
  • Version-specific — Version-specific checks are requirements that are specific to the version of cPanel & WHM to which you begin an installation or upgrade.

If cPanel & WHM encounters a compatibility issue that blocks the installation or upgrade process, the following events happen:

  1. If you started an upgrade, the system remains at the last known compatible version. If you started a new installation of cPanel & WHM, the system remains in its pre-installation status.
  2. cPanel & WHM sends a list of the blockers to the system administrator.
  3. The installation or upgrade process exits.
Warning
titleWarning:

As of cPanel & WHM version 11.34, after you upgrade to a new major version of cPanel & WHM, you cannot downgrade to a previous major version.

Note
titleNote:

Before you upgrade the version of cPanel & WHM on a server, we strongly recommend that you restore cPanel & WHM's management of all FTP targets on your server. If the FTP RPM's target is set to unmanaged on a server that you wish to upgrade, you may encounter problems in the cPanel user interface.

For more information on how to restore cPanel & WHM management of all FTP targets on your server, read our How to Set or Unset RPM Management documentation.

Standard checks for all upgrades

When you run an upgrade of cPanel & WHM to any version, the update process performs the following standard checks:

License files

You cannot upgrade cPanel & WHM if any of the following conditions are true:

If you experience difficulties with your license, contact our customer service department.

Read-only file systems

To ensure that the system can write files to critical directories, the cPanel & WHM update process will fail if the following directories file systems exist in a read-only state:

Code Block
languagetext
linenumberstrue
/etc
/var
/var/lib/rpm
/var/cpanel
/usr/local
/usr/local/cpanel
/usr/local/bin
/usr/bin
/tmp
/var/tmp

RPM database integrity

As of cPanel & WHM version 11.36, the update process verifies the integrity of the RPM database. To verify the integrity of the RPM database, the update process installs and uninstalls a test RPM. The update process attempts to repair the problem, but if it cannot repair the RPM database, the upgrade attempt fails.

cPanel & WHM version-specific installation requirements and upgrade blockers

The following table includes the installation requirements and upgrade blockers for each version of cPanel & WHM:

Warning
titleImportant:

If a blocker for the version of cPanel & WHM to which you wish to upgrade is present on your system when you start the cPanel & WHM update process, the update process will fail.

cPanel & WHM versionUpgrade requirements

Upgrade blockers

 

11.30NoneNone
11.32
  • CentOS 4 or newer or Red Hat® Enterprise Linux (RHEL) 4 or newer.
  • The Maildir mail storage format. For more information on how to convert the mbox mail storage system to Maildir, read our How to Convert mbox Accounts to Maildir documentation. 
  • Exim 4.77 or newer. To install Exim 4.77, enable Exim updates in WHM's Update Preferences interface (Home >> Server Configuration >> Update Preferences).
  • The /var/cpanel/sysinfo.config file must exist and must contain entries. For more information on the /var/cpanel/sysinfo.config file, read the sysinfo.config section below.
  • FreeBSD®
  • CentOS 3 or earlier
  • Red Hat 3 or earlier
  • The mbox mail storage system
  • Exim 4.0 or earlier
  • The /var/cpanel/sysinfo.config file is empty or does not exist.
11.34
  • CentOS 5 or newer, CloudLinux™ 5 or newer, or RHEL 5 or newer
  • MySQL® 5.0 or newer
  • CentOS 4 or earlier, CloudLinux 4 or earlier or RHEL 4 or earlier
  • MySQL 4.x or earlier
11.36
  • At least 1.6 GB of space available in the /usr/local/cpanel / directory
  • cPanel package updates set to Automatic or Inherit. For more information on how to set the cPanel package updates to Automatic or Inherit, read the cPanel package updates section below.

Note
titleNote:

When you upgrade to cPanel & WHM version 11.36, the cPanel & WHM update process may rebuild your Exim configuration. We recommend that you check your Exim configuration after you upgrade to cPanel & WHM version 11.36.

  • Less than 1.6 GB available in the /usr/local/cpanel directory.
  • The /usr/local/cpanel/scripts/sysup script is disabled.

  • Third-party packages are disabled.

11.38None

Interchange is enabled.

11.40

None

None

11.42NoneNone
11.44

None

None

11.46None
  • Microsoft® FrontPage® Extensions
  • The cpanel-php53 RPM target is set to installed.
11.48NoneNone
11.50New installations on CentOS 7 servers require at least 1 GB of RAM, and are only available for 64-bit systems.None
11.52
  • New installations on CloudLinux and RHEL 7 servers require at least 1 GB of RAM, and are only available for 64-bit systems.
  • New installations on Amazon Linux are only available for 64-bit systems.
None
54NoneNone
56NoneNone
58Only available for 64-bit systems.
  • CentOS 5, RHEL 5, and CloudLinux 5.
  • 32-bit systems.
  • The perl514 RPM target is set to installed or unmanaged.
60

SNI support

Apache (httpd) 2.2.11 or older
62MySQL® version 5.5 and later.MySQL version 5.1 and earlier.
64NoneNone

Additional blocker information

cPanel & WHM version 11.32

sysinfo.config

cPanel & WHM automatically attempts to run the/usr/local/cpanel/scripts/gensysinfo script to generate this file during the upgrade procedure. If you encounter this error, perform the following steps:

cPanel & WHM version 11.36

Disk space on all cPanel version changes and new installs

As of cPanel & WHM version 11.36, to ensure that a partial upgrade does not break your current installation, the cPanel & WHM update process downloads new files to a staging directory inside the /usr/local/cpanel/ directory.

To ensure that there is enough disk space available for the new files, the cPanel update process checks for a minimum of 1.6GB of available disk space in the /usr/local/cpanel/ directory before an upgrade, update, or new installation can begin. After the cPanel & WHM update process downloads the files and completes the compatibility checks, the update process replaces the prior version of each file with the new version.

Note
titleNote:

cPanel & WHM checks for the amount of available disk space in the /usr/local/cpanel/ directory, but some legacy RPMs (for example, Exim or MySQL) install outside that space. We do not check for sufficient disk space in the /usr/ directory if it is in a different partition from the /usr/local/cpanel/ directory.

cPanel package updates set to Automatic or Inherit

To update to cPanel & WHM version 11.36, the following cPanel package updates must be set to Automatic or Inherit:

Note
titleNotes:
Exim configuration

You cannot upgrade to cPanel & WHM version 11.36 if you set the EXIMUP key's value to never in the /etc/cpupdate.conf file.

To upgrade from cPanel & WHM version 11.34 and earlier, perform the following steps:

  1. Run the touch /var/cpanel/exim.unmanaged command.
  2. Run the cPanel & WHM update process.

To upgrade from a cPanel & WHM version 11.36 release prior to 11.36.07, perform the following steps:

  1. Run the following command:

    Code Block
    languagebash
    /usr/local/cpanel/scripts/update_local_rpm_versions --edit target_settings.exim unmanaged
  2. Run the cPanel & WHM update process.

If you set the EXIMUP key's value to inherit in the /etc/cpupdate.conf file, you may receive an error that informs you that the EXIMUP key's value is set to never. To resolve this issue, perform the following steps:

  1. Set the CPANEL key's value to 11.36 in the /etc/cpupdate.conf file.
  2. Run the cPanel & WHM update process.
  3. Set the CPANEL key's value to your desired support tier (for example, RELEASE) in the /etc/cpupdate.conf file.

    Note
    titleNote:

    For more information about support tiers, read our Product Versions and the Release Process documentation.

  4. Run the cPanel & WHM update process again.

cPanel & WHM version 11.44

Nobody must own the transfer database

If a user owns the whmxfer database, you must delete the database.

cPanel & WHM version 11.46

Microsoft FrontPage Extensions

You must remove the Microsoft FrontPage Extensions RPM entirely from your system. In cPanel & WHM version 11.44, you can remove FrontPage in WHM's Uninstall FrontPage Extensions interface (Home >> Front Page >> Uninstall FrontPage Extensions).

The cpanel-php53 RPM target

If you have set the cpanel-php53 RPM target to installed in the rpm.versions system, the system will block an upgrade to cPanel & WHM version 11.46. 

To uninstall the cpanel-php53 target, run the following commands:

Code Block
languagebash
/scripts/update_local_rpm_versions --del target_settings.cpanel-php53 uninstalled
/scripts/check_cpanel_rpms --fix 
Note
titleNote:

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

cPanel & WHM version 11.50
New installations on CentOS 7 servers

New installations on CentOS 7 servers require a minimum of 1 GB of RAM, and are only available for 64-bit systems.

cPanel & WHM version 11.52
New installations on CloudLinux and RHEL 7, and Amazon Linux servers
  • New installations on CloudLinux and RHEL 7 servers require a minimum of 1 GB of RAM, and are only available for 64-bit systems.
  • New installations on Amazon Linux are only available for 64-bit systems.
cPanel & WHM version 58
64-bit systems only

cPanel & WHM version 58 is only available for 64-bit systems. You cannot install or upgrade to cPanel & WHM version 58 on a 32-bit system.

CentOS, RHEL, and CloudLinux systems require version 6 or later

If your server runs the CentOS, RHEL, or CloudLinux operating systems, it must run version 6 or later. You cannot install or upgrade to cPanel & WHM version 58 on a server that runs CentOS 5, RHEL 5, or CloudLinux version 5.

The perl514 RPM target is set to installed or unmanaged

If the perl514 RPM target's state is installed or unmanaged in any .versions file in the /var/cpanel/rpm.versions.d/ directory, the upgrade to cPanel & WHM version 58 will fail.

cPanel & WHM version 60

SNI Required
cPanel & WHM version 60 requires a web server that supports SNI (for example, Apache (httpd) 2.2.12, Litetspeed 4.1, or Openlitespeed 1.4.12 or greater). You cannot upgrade to cPanel & WHM version 60 if your web server does not support SNI. Use WHM's EasyApache interface (Home >> Software >> EasyApache) to upgrade your web server.
 

cPanel & WHM version 62

MySQL upgrade required

cPanel & WHM version 62 requires that your server runs MySQL version 5.1 or earlier. You must upgrade your MySQL version to at least MySQL version 5.5 before you can upgrade your cPanel & WHM server. You can upgrade your MySQL version in WHM's MySQL or MariaDB Upgrade interface (Home >> Software >> MariaDB/MySQL Upgrade).

Additional documentation

Localtab Group
Localtab
activetrue
titleSuggested documentation

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel = "updates" and label = "whm" and space = currentSpace()

Localtab
titleFor cPanel users

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel = "updates" and label = "cpanel" and space = currentSpace()

Localtab
titleFor WHM users

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel = "updates" and label = "whm" and space = currentSpace()

Localtab
titleFor developers

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel = "updates" and space = "SDK"