Our documentation is getting an overhaul! We would like your input! Click here to take a look at the beta launch of our new documentation site! Only cPanel & WHM version 82 documentation exists on our beta at this time. 84 will be added to the new site soon! Leave your feedback here: https://go.cpanel.net/docsfeedback
Installation Guide - Troubleshoot Your Installation - 11.52 Documentation - cPanel Documentation
Page tree
Skip to end of metadata
Go to start of metadata

For cPanel & WHM version 11.52


This documentation describes additional steps to use if you install cPanel & WHM with this guide, but still experience problems.


License errors


You see license errors during or after the installation process.


Your license may be expired or improperly configured.


To check your cPanel license, perform the following steps:

  1. Run either of the following commands to obtain your license's IP address:

    curl -L http://cpanel.net/showip.cgi
    lynx -dump http://cpanel.net/showip.cgi
  2. Navigate to the cPanel License Verification page.
  3. Enter the IP address that you obtained in Step 1. Our website will display the status of your license.


    If your server’s IP address does not match the IP address on your license, contact cPanel Customer Service for further assistance.

  4. If your IP address matches the license, and you still experience problems, run the following script to verify your license:


    After the script runs, the command line will display no messages if your license works properly. If the script requires more than a few seconds to run, you may have connectivity issues.

  5. If the /usr/local/cpanel/cpkeyclt script fails, ensure that our licensing servers resolve. To test that you can resolve our servers, run the following command:

    host auth.cpanel.net

    You may also need to ensure that the time and date of the server are not set too far in the future or past.

Perl installation errors


You see the following error message during the installation process:

Fatal! Perl must be installed before proceeding!

Perl must exist on your server before the installation script for cPanel & WHM can run successfully. If Perl does not exist during installation, the cPanel & WHM installer attempts to install Perl via the yum -y install perl command. If the installation does not succeed, the system displays this error message.

  • We strongly recommend that you allow your operating system's distribution to control the system Perl installation. Do not customize this Perl installation.
  • For more information about Perl on your server, and which versions of Perl ship with specific operating systems, read our Guide to Perl in cPanel & WHM documentation. cPanel & WHM servers use multiple Perl environments.

Problems with yum generally cause this error. Make certain that yum functions properly on your server.

To attempt to install Perl again, run the following command:

yum install perl

Stuck backup partition


The backup partition is stuck with an active lock after the first time that you ran the backup process.


This problem occurs because of a known incompatibility when cPanel & WHM or cPanel DNSONLY run on CloudLinux™ under CentOS 5.x.


Manually unmount and remount the backup partition.

High CPU load on Hyper-V


The server reports a high CPU load, and Hyper-V's Dynamic Memory option is enabled.


This problem is due to an issue with sleep interruptability in Hyper-V.


For more information and a patch to fix the issue, visit the LKML website.

RPM installation failures


One or more RPMs fail during installation.


There are several reasons why your operating system's RPM installations may fail.


For steps to fix this issue, read our RPM Installation Failures documentation.

DNS problems


You experience problems that relate to DNS.

  • You may need to set up resolvers. Resolvers allow your server to communicate with DNS servers to find IP addresses that correspond to domain names.
  • One or more directories or partitions may be improperly configured.

To check your server's resolvers, run the following command, where example.com represents a domain on your server:

host example.com

If this command did not return results, perform the following steps to add resolvers to your server:

  1. Use a text editor to open the /etc/resolv.conf file.
  2. If this file does not contain any resolvers, enter nameserver IP in the file, where IP represents the IP address of the resolver.


    You should obtain at least two resolvers from your data center.

If this command returns results to the server, the resolvers are properly configured. Examine your file system's configuration for problems.

To examine all of the relevant directories and partitions, perform the following steps:

  1. To view information about all of your mounted file systems, run the following command:

    df -h
  2. To view information about the server's available memory, run the following command:

    free -m
  3. To view information about the server’s processing power, run the following command:

    cat /proc/cpuinfo
  4. To view more detailed information about the server’s memory, run the following command:

    cat /proc/meminfo



  • No labels