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

Overview

This document describes the steps to update your system.

Update your system

EasyApache 4?

The EasyApache 4 feature updates Apache, as well as other applications and libraries. The /usr/local/cpanel/scripts/upcp script does not update Apache.

You can access EasyApache 4 in WHM's EasyApache 4 interface (WHM >> Home >> Software >> EasyApache 4).

To update EasyApache 4, perform either of the following actions:

  • Click Run System Update in WHM's EasyApache 4 interface (WHM >> Home >> Software >> EasyApache 4).
  • Run the yum update command.

    Important:

    We strongly recommend that you run EasyApache when a new Apache build becomes available.

For more information, read our EasyApache 4 documentation.

EasyApache 3?

Warning:

EasyApache 4 installs by default on new cPanel & WHM installations. We deprecated EasyApache 3 in cPanel & WHM version 60 and plan to remove it in a future version.

The EasyApache 3 feature updates Apache, as well as other applications and libraries. The /usr/local/cpanel/scripts/upcp script does not update Apache.

You can run EasyApache in the following locations:

InterfaceLocation
WHM (in browser)Home >> Software >> EasyApache 3
Command line/usr/local/cpanel/scripts/easyapache

When you run EasyApache, the feature prompts you to select the version of Apache that you wish to use. If you select a more recent version of Apache, EasyApache will update Apache accordingly.

Important:

We strongly recommend that you run EasyApache when a new Apache build becomes available.

For more information, read our EasyApache documentation.

What is the difference between the EasyApache interfaces in the browser and the command line?

The command line interface provides more flexible and powerful functionality. For example, if you run the /usr/local/cpanel/scripts/easyapache --build command, you can skip the configuration steps and build Apache immediately.

For a full list of command line arguments, run the /usr/local/cpanel/scripts/easyapache --help command.

For more information, read the EasyApache Profile documentation.

MySQL?

You can manage MySQL® with the WHM interface or manually with the rpm.versions system.

For more information, read the rpm.versions documentation.

If I manually update MySQL, will MySQL work with cPanel & WHM?

Yes. For more information, read the rpm.versions documentation.

Warning:

Compatibility problems may exist with any software that you choose to install manually. For that reason, we only support MySQL versions that we supply with cPanel & WHM.

Operating system's kernel?

To update your operating system kernel, perform either of the following actions:

  • Select the Include kernel packages checkbox when you update your system with WHM's Update System Software interface (WHM >> Home >> Software >> System Update).

  • Run the yum update command as the root user from the command line.

    Note:

    After you update the kernel, you must reboot your server.

Perl?

Instances of Perl on your server rely on RPMs for installation and maintenance.

When you run the /usr/local/cpanel/scripts/upcp script, WHM runs the /usr/local/cpanel/scripts/check_cpanel_rpms command, which updates the cPanel-included Perl installation.

When you run the yum update command, your system will update the server's Perl binary.

Warnings:

  • We strongly recommend that you allow your operating system's distribution to control updates to both the system and cPanel Perl installations. Do not customize either Perl installation. 
  • cPanel, Inc. does not support updates of Perl beyond the operating system's or cPanel's distribution.
  • We also do not support Perl downgrades. Your system will return Perl to the currently-supported version during the next system update.
  • Neither your system Perl or cPanel-included Perl are likely to corrupt. However, if you suspect that either instance of Perl is corrupt, a greater system issue may exist on your server. We recommend that you open a cPanel support ticket.

Perl modules?

When you run the /usr/local/cpanel/scripts/upcp script, WHM runs the /usr/local/cpanel/scripts/check_cpanel_rpms command, which updates your Perl modules.

PHP?

To update Apache's instance of PHP, run the /usr/local/cpanel/scripts/phpup script from the command line.

To change the version of Apache's instance of PHP, run EasyApache in WHM's EasyApache 4 interface (WHM >> Home >> Software >> EasyApache 4).

How do I update the instance of PHP that cPanel uses?

The system uses RPM to update PHP. For more information, read the rpm.versions documentation.

If I install a custom instance of PHP, will it work with cPanel & WHM?

The system uses RPM to update PHP. For more information, read the rpm.versions documentation.

PHP extensions and applications?

How do I update PHP extensions?

You can run EasyApache to update the PHP extensions that WHM provides.

Important:

You must manually update any PHP extensions that you installed manually.

How do I update PHP applications?

When you run the /usr/local/cpanel/scripts/upcp script, WHM will update any applications that it provides (for example, phpMyAdmin).

To update cPAddons that you have installed, use WHM's  Manage cPAddons Site Software  interface (WHM >> Home >> cPanel >> Manage cPAddons Site Software).

RPMs?

The /usr/local/cpanel/scripts/upcp script automatically updates RPMs and other modules that cPanel & WHM installs.

You must manually update any manually-installed RPMs that cPanel & WHM's default installation does not include. These RPMs and packages will only receive an update if you have added them to the YUM repository.

Warning:

Third-party repositories can cause problems with cPanel & WHM and updates from the OS repository. Be aware of the risks before you use a third-party repository.

Ruby Gems?

You must manually update any installed RubyGems.

When you run the /usr/local/cpanel/scripts/installruby script, WHM will only install a set of required modules. The /usr/local/cpanel/scripts/upcp script will automatically update these modules. 

CPaddons

You can manage specific configuration options for your cPAddons with WHM's Manage cPAddons Site Software interface (WHM >> Home >> cPanel >> Manage cPAddons). This feature allows you to select the cPAddons that you wish to update automatically.

A nightly cron job updates the cPAddon repository for the entire server.

Other update questions

What does the /usr/local/cpanel/scripts/upcp script do?

This script handles most of the updates on your cPanel & WHM system. You can run this script in the following locations:

InterfaceLocation
WHM (in browser)Home >> cPanel >> Upgrade to Latest Version
Command line/usr/local/cpanel/scripts/upcp (as the root user)
This script also calls a number of other scripts within the /usr/local/cpanel/scripts directory to update most of the software on your system. The /usr/local/cpanel/scripts/upcp script also runs the following scripts:
Script NameWHM FeatureDescription
/usr/local/cpanel/scripts/rpmup2 System Update This script updates your system software. It is essentially the same as the yum update command.
/usr/local/cpanel/scripts/sysup Update Server Software This script updates the software dependencies that the operating system provides and which cPanel & WHM requires.
The /usr/local/cpanel/scripts/*up ScriptsN/AA number of scripts update applications that ship with with cPanel & WHM. For a list of *up scripts, read our WHM scripts documentation.

What does the Update Server Software feature update?

The Update Server Software feature manages software dependencies that the operating system provides and which cPanel & WHM requires.

You can find and use this feature in the following locations:

InterfaceLocation
WHM (in browser)Home >> Software >> Update Server Software
Command line/usr/local/cpanel/scripts/sysup

What does the Update System Software feature update?

The System Update interface keeps your operating system up-to-date. This feature also updates any package that yum manages. Essentially, this feature is the same as when you run the yum update command as the root user on the command line.

You can use this feature in the following locations:

InterfaceLocation
WHM (in browser)Home >> Software >> System Update
Command line/usr/local/cpanel/scripts/rpmup2

Note:

This feature does not update your operating system's kernel. To update your operating system's kernel, run the yum update command as the root user from the command line.

WHM Update Preferences – What does "automatic" mean on the WHM Update Preferences screen?

Automatic updates occur every night at midnight.

For more information about Update Preferences, see our Update Preferences documentation.

What does the yum update command do?

YUM (Yellowdog Updater, Modified) is an open-source command line package management utility for Linux. When you run the yum update command from the command line and do not specify a package, YUM performs the following actions:

  1. it updates all of the packages within your system's local YUM repository.
  2. It updates your operating system's kernel.
  3. It verifies that the updates satisfy all dependencies.

What are release tiers? Which one is right for me?

For an explanation of our release tiers, read our cPanel & WHM Versions and the Release Process documentation.

How do I make sure that my server has the latest version of cPanel & WHM?

WHM displays the version in the upper right corner of the interface.

You can also run the /usr/local/cpanel/cpanel -V command on the command line to verify the version of cPanel & WHM.

To define how you wish to update your server's software, you can adjust your Update Preferences. To learn more about this feature, read our Update Preferences  documentation.

For the latest available version of cPanel, read our update documentation.

Where do I go to find out when a new build of cPanel is released?

To find the latest builds, look for the latest version available for your operating system on our update page.

What do I do if cPanel & WHM will not update?

If cPanel & WHM will not update, submit a ticket to cPanel support.

 

Additional documentation