Page tree

Versions Compared

Key

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

...

Section
Column
width250px

Table of Contents
maxLevel2
excludeOverview
stylenone

Column

Overview

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

Tip
titleRemember:

License errors

Problem

You see license errors during or after the installation process.

Explanation

Your license may be expired or improperly configured.

Solution

To check your cPanel license, perform the following steps:

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

    Code Block
    languagebash
    linenumberstrue
    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.

    Note
    titleNote:

    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:

    Code Block
    languagebash
    /usr/local/cpanel/cpkeyclt

    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, your server may have encountered 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:

    Code Block
    languagebash
    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

Problem

You see the following error message during the installation process:

Code Block
languagetext
Fatal! Perl must be installed before proceeding!
Explanation

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.
Solution

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:

Code Block
languagebash
yum install perl

High CPU load on Hyper-V

Problem

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

Explanation

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

Solution

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

RPM installation failures

Problem

One or more RPMs fail during installation.

Explanation

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

Solution

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

IPv6 support failures

ProblemYou experience a fatal IPv6 error during the installation process.
Explanation

The system may not include the IPv6 support that cPanel & WHM requires. cPanel & WHM requires that your kernel includes the ipv6 module, or includes that functionality directly within the kernel.

  • If your kernel does not include it in the ipv6 module, the AF_INET6 address family must also be available.
  • Most distributed kernels include this support by default.
  • This problem often occurs on servers that use a custom kernel.
Solution

Ensure that your kernel provides the required support, or that you add the required modules to your kernel.

Warning
titleImportant:

Your server requires this support regardless of whether you wish to enable IPv6 on your server.

To disable IPv6 after installation, run the following command:

Code Block
echo 1 > /proc/sys/net/ipv6/conf/all/disable_ipv6

 

DNS problems

Problem

You experience problems that relate to DNS.

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

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

Code Block
languagebash
host example.com

If this command did not return results, the /etc/resolv.conf file does not contain resolvers. Use WHM's Resolver Configuration interface (Home >> Networking Setup >> Resolver Configuration) to add resolvers to your server.

To determine whether your server can communicate with a resolver, perform the following steps:

  1. Use SSH to log in to your server via the command line.
  2. Run the following commands to check communication via IPv4 and IPv6:

    Code Block
    languagebash
    linenumberstrue
    ping 8.8.8.8
    ping6 2001:4860:4860::8888
  3. If these commands fail, make certain that you used the correct IP addresses. Then, run the following commands to find the problem:

    Code Block
    languagebash
    linenumberstrue
    traceroute 8.8.8.8
    traceroute6 2001:4860:4860::8888
Note
titleNotes:
  • Replace 8.8.8.8 with the desired resolver's IPv4 address.
  • Replace 2001:4860:4860::8888 with the desired resolver's IPv6 address.

Additional documentation

Localtab Group
Localtab
activetrue
titleSuggested documentation

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel in ("installguide","server") and label in ("whm","dnsonly") and space = currentSpace()

Localtab
titleFor cPanel users

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel in ("installguide","server") and label = "cpanel" and space = currentSpace()

Localtab
titleFor WHM users

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel in ("installguide","server") and label = "whm" and space in (currentSpace(),"CKB")

Localtab
titleFor developers

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel in ("installguide","server") and space = "SDK"

...