We have a new documentation site for cPanel & WHM! You can find our new documentation site at docs.cpanel.net.
We will continue to maintain our API documentation on this server.
This page was last updated on:
You must remove the Microsoft FrontPage RPM from your server before you upgrade to cPanel & WHM version 11.46.
The FrontPage RPM and the FrontPage opt mod (
mod_frontpage) in EasyApache are separate entities. The presence of
mod_frontpage will not block upgrades to cPanel & WHM version 11.46.
In cPanel & WHM version 11.46 and later, fresh installations and upgrades require at least 3 GB of available disk space for staging purposes.
cpanel-php53 RPM target is set to
installed on your server, you cannot upgrade to cPanel & WHM version 11.46.
To uninstall the
cpanel-php53 RPM target, run the following commands:
Version 126.96.36.199 introduces the Staging Directory. The system notifies you if there is insufficient space available to complete the upgrade and allows you to select a new location for the Staging Directory.
In cPanel & WHM version 11.46, if you use the cPanel interface to log in to Webmail, you will automatically log in to the email account. However, if you go directly to the URL of the Webmail interface, you must use the email account's username and password.
In cPanel & WHM version 11.46, we have added interfaces that allow users to manage ModSecurity rules and configurations.
WHM now includes the following interfaces:
cPanel now includes the ModSecurity Domain Manager interface (Home >> Security >> ModSecurity™ Domain Manager), which allows you to disable ModSecurity for one or more domains.
In cPanel & WHM version 11.46, MySQL backups now include triggers and events.
We strongly recommend that you do not disable the Maintenance cPanel RPM Check and Maintenance cPanel RPM Digest Check settings. If you disable these settings, the system will not check existing RPMs for problems during updates or maintenance. This could leave your system vulnerable to unnoticed tampering or other risks.
/scripts/check_cpanel_rpmsscript, during your system's nightly maintenance.
Maintenance cPanel RPM Digest Check— This option allows you to enable or disable digest authentication for the cPanel RPM check during your system's nightly maintenance. If you disable this setting, nightly maintenance runs the
/scripts/check_cpanel_rpms script with the
Both of these options default to On. You can also modify these settings via the
maintenance_rpm_version_digest_check values in the
The number of days to keep record of ModSecurity™ rule hits. — This setting allows you to specify the number of days that you wish to maintain your hits records in the
cPanel & WHM version 11.46 introduces the use of UI Includes in Paper Lantern. Resellers and administrators can use Template Toolkit to insert custom content in the cPanel interface.
rootuser can insert global header and footer content across all of the interfaces in cPanel.
For more information, read our Customize Content in Paper Lantern documentation.
You can now edit the TTL for all of the zones that your account owns. To do this, use WHM's Set Zone Time to Live (TTL) interface (Home >> DNS Functions >> Set Zone Time to Live (TTL)) and the
In cPanel & WHM version 11.46, users can now customize their cPanel dashboards. Resellers and
root users can choose to either develop a style or use WHM's Customize Paper Lantern interface (Home >> cPanel >> Customize Paper Lantern) to create new styles and share them with their customers.
For more information, read our Paper Lantern 11.46 Release Notes.
We have improved the upgrade process to ensure that upgrades finish on the latest version of cPanel & WHM possible, even if the upgrade encounters blockers for the next major version of cPanel & WHM.
For example, if you begin an upgrade from cPanel & WHM version 11.40 to version 11.46, but Microsoft® Frontpage® is installed on the server, the server will upgrade to the latest release of version 11.44.
For more information about the upgrade process, read our Upgrade Blockers documentation.
cpsrvdnow supports SSL. For this reason, we no longer ship
cpsrvd-sslas a separate entity.
We have updated cPanel's
dynamicui.conf file. If you use a custom x3 style, you may need to refork the x3 theme after you upgrade. If you do not refork the x3 theme for your custom branding, you may see nonfunctional features in the cPanel Home interface.
We upgraded the cPanel-provided installation of Apache SpamAssassin™ to Apache SpamAssassin version 3.4.
For more information, read the Apache SpamAssassin 3.4 release notes.
We have updated the re2c RPM to version 0.13.7.4. cPanel & WHM uses re2c to compile the Apache SpamAssassin™ ruleset. For more information, visit the re2c website.
We now compile cPanel binaries against Perl 5.14.4, instead of Perl 5.6.2. We have also updated all cPanel-included CPAN modules to the newest available version as of July 2014.
If you use custom Perl modules or Perl scripts on your server, or if you are a third-party developer, it is critical that you test your plugins and hook code against Perl 5.14.4 to be certain that it functions correctly. Modules that were built and used against Perl 5.6.2 will not work with the new cPanel & WHM version 11.46 binaries.
Custom modules that you previously compiled with the
buildperl system will not function properly in cPanel & WHM version 11.46 and later, because the module was built against an older version of Perl.
Before you recompile all of your modules, check whether cPanel & WHM already includes your modules. We have added many modules to the list of modules that cPanel ships, and expect that cPanel & WHM will now ship with the majority of the modules that developers built with this tool.
/opt/cpanel/perl5/514/site_liblibrary with the
/usr/local/cpanel/3rdparty/perl/514/bin/cpancommand, this will cause further problems when cPanel switches to even newer versions of Perl.
For more information about the available Perl environments, read our Guide to Perl in cPanel & WHM documentation.
To test whether the module that you need already ships with cPanel & WHM, run the following command, where
My::Module represents your module's name:
LWP is a common module that was previously compiled against the
buildperl system. cPanel & WHM ships with
LWP version 6.05 with Perl 5.14, as shown by the following command and its output:
Due to the updates to cPanel & WHM's Perl binary, we have removed the
WHM's Security Advisor interface (Home >> Security Center >> Security Advisor) now reports an issue if the following custom modules exist on your server:
If these modules are present on your server, we strongly recommend that you rebuild EasyApache without FrontPage to remove the modules. cPanel & WHM version 11.46 and later do not support Microsoft® FrontPage®.
rsyncif both the source and target servers have
The WHM News section now uses bootstrap styling, and we have improved it to behave more consistently.
In cPanel & WHM version 11.46 and later, we have reduced the number of
cpanel.config file validation notifications:
/var/cpanel/cpanel.configfile if the system could not find the
cpanel.configvalues are missing or invalid, the system will update the file and log the changes to the
For more information about
cpanel.config file validation, read our The cpanel.config File documentation.
When you delete an account through the command line interface, we no longer recommend that you use the
killacct script. The default behavior of this script did not remove DNS entries for an account. Instead, we recommend that you use the
/scripts/removeacct script, which, by default, removes an account and its DNS entries.
cPanel's Advanced DNS Zone Editor interface (Home >> Domains >> Advanced DNS Zone Editor) now supports AAAA and SRV record types.
You can now use the cPanel interface's x3 theme in 29 different locales. You can choose from the following locales:
Latin American Spanish
To change your interface to these locales, select them from the login interface or the Change Language page (Home >> Preferences >> Change Language) of x3. x3 will automatically default to your browser language setting.
Dovecot and Courier can now listen to IPv6 requests for POP3 and IMAP. This includes POP3SSL and IMAPSSL.
This is configurable in the Mailserver Configuration .
cPanel & WHM considers the underscore character (
) to be a separator between the reseller that owns the package and the package's name. The system considers characters to the left of the underscore to be the reseller's name, and characters to the right of the underscore to be the package's name.
As of cPanel & WHM version 11.46, the cPanel interface only displays the package's name. For example, the interface will display the
reseller_package package as
For more information, read our Add a Package.
We deprecated Interchange in cPanel & WHM version 11.38. In cPanel & WHM version 11.46, we have removed all references to it from the cPanel & WHM codebase.
This includes the removal of the following items:
res-cart) feature limit.
interchangeversetting in the
We have removed the ModSecurity Plugin interface.
cPanel & WHM version 11.46 deprecates the old style LANG system.
Examine your systems for use of the deprecated lookup keys. Sometimes these keys are called short tags. The following are examples of these deprecated keys:
A full list of deprecated lookup keys can be found in
If you used the LANG system to provide your own custom translations, the x3 and Paper Lantern themes will no longer use them. Your users will only see English text. To allow them to function, you will need to convert your translations to the Locale Maketext format. To translate phrases, use WHM's Edit a Locale interface (Home >> Locales >> Edit a Locale) .
If you have implemented deprecated lookup keys in one of the following ways, the correct text will continue to display:
We have removed the following variables from the
maildirparameter will continue to do so.
Be certain that you update any third-party code that may use these variables.
The following scripts are now deprecated:
Be certain that you have updated any cron jobs or other dependencies that may have used these scripts.
We have removed the following scripts:
Prior to cPanel & WHM version 188.8.131.52, the
/scripts/chownpublichtmls script could change file and directory ownership within the target user's
public_html directory if it was run with
root permissions. In cPanel & WHM version 184.108.40.206 and later, we modified the script to perform ownership changes with the effective UID and GID of the target user. This change addresses a security vulnerability in the script, but also limits the script's usefulness.
Be certain to update any cron jobs or other dependencies that may have used these scripts.
cPanel & WHM version 11.46 includes the following third-party applications.
This section lists the applications' version numbers and the minor build of cPanel & WHM that corresponds to each version.
|Third-party application||Version||Corresponding cPanel & WHM minor version|
New UAPI Calls
Brand::read— This function returns the information configured in WHM's Customize Paper Lantern interface (Home >> cPanel >> Customize Paper Lantern).
Styles::list— This function lists information about all of the styles that are available to the reseller account.
Styles::set_default— This function allows you to set a default style for your customers.
Styles::update— This function applies a new style to the cPanel interface.
New WHM API Calls
abort_transfer_session — This function allows you to abort an active transfer session.
load_style— This function retrieves information about your custom style.
modsec_add_rule — This function adds a new ModSecurity rule to the specified ModSecurity configuration-staging file.
modsec_batch_settings — This function processes a set of global ModSecurity configuration directives.
modsec_deploy_rule_changes — This function takes the staged changes for the ModSecurity configuration file, deploys them to the live configuration file, and restarts Apache.
modsec_deploy_settings_changes — This function deploys the staged changes to the /usr/local/apache/conf/modsec2.conf file and attempts to restart Apache.
modsec_disable_rule — This function disables a single ModSecurity rule for a specified rule ID in a specified ModSecurity configuration file.
modsec_discard_rule_changes — This function discards the staged rule changes, if present, for the specified configuration file.
modsec_edit_rule — This function allows you to edit an existing rule in a ModSecurity configuration file.
modsec_get_config_text — This function retrieves the contents of a ModSecurity configuration file.
modsec_get_configs — This function retrieves the list of known ModSecurity configuration files which are eligible for this API to manage.
modsec_get_configs_with_changes_pending — This function searches for ModSecurity configuration files that contain staged pending changes and returns a list of those files.
modsec_get_log — This function retrieves ModSecurity log events from the modsec MySQL database.
modsec_get_rules — This function retrieves the ModSecurity rules from a single ModSecurity configuration file.
modsec_get_settings — This function retrieves the ModSecurity settings stored in the /usr/local/apache/conf/modsec2.conf file.
modsec_is_installed — This function verifies whether the ModSecurity Apache module is installed.
modsec_make_config_active — This function adds an include for a ModSecurity configuration file in the modsec2.cpanel.conf file.
modsec_make_config_inactive — This function removes an include for a ModSecurity configuration file in the modsec2.cpanel.conf file.
modsec_remove_rule — This function removes a ModSecurity rule from the specified ModSecurity configuration file.
modsec_remove_setting — This function allows you to remove a single global ModSecurity configuration directive.
modsec_set_config_text — This function allows you to set the contents of a specified ModSecurity configuration file.
modsec_set_setting — This function sets the value of a single global ModSecurity configuration directive.
modsec_undisable_rule — This function enables a single ModSecurity rule with a specified rule ID in a specified ModSecurity configuration file.
save_style— This function allows you to save an uploaded style and retrieve it later.
Modified WHM API Calls
create_user_session— This function now accepts the
webmaildvalue for the
listacls— This function no longer returns the
myprivs— This function no longer accepts the
saveacllist— This function no longer accepts the
setacls— This function no longer accepts the
Modified cPanel API Calls
Frontpage::fpstatus— This function will now only return the
Frontpage::delfp— This function will now only return a
Microsoft® FrontPage® is not available on servers that run cPanel & WHM version 11.46 and later.message.
Frontpage::addfp— This function will now only return a
Microsoft® FrontPage® is not available on servers that run cPanel & WHM version 11.46 and later.message.