WHM FAQ

What is an express transfer?

An express transfer, in addition to transferring the requested cPanel account(s), performs the following actions on the source server:

1. Updates the account's A record to point to the destination server.
2. Whenever appropriate, changes the domain's nameserver entry to point to the destination server.
3. Updates the mail databases to point to the destination server.
4. Adds a redirect for the Account Moved page (cgi-sys/movingpage.cgi) for the following file extensions:
   • .dynamiccontent
   • .pl
   • .plx
   • .perl
   • .cgi
   • .php
   • .php4
   • .php5
   • .php6
   • .php3
   • .shmtl
5. Blocks SSH and FTP logins to the source server for accounts that were transferred.

Note: Changes are handled on the source server via /usr/local/cpanel/scripts/xferpoint.

How do I block an IP address from my server?

You can now block IP addresses using WHM's Host Access Control feature ( Main >> Security Center >> Host Access Control).

How do I clear a full partition?

There are a few possible solutions.

Usually, /var is what fills up first. This is because /var holds all the system logs.

To see what directory or log is taking up all the room, start at the base. Issue the following commands from a terminal session:

1. cd /var
2. du -sh *

This will show how much space is used and available in each directory, as well as the file sizes of each file in the current directory. Examine the command's output. Once you see what directory is taking up all the space, cd to it and type the same command again. Follow this searching pattern until you find the files taking up the space.

Once found, you can either delete the files or, if you'd like to save some of the most recent entries to it, you can type this:

1. tail -5000 filename > filename.new
2. mv filename.new filename
3. sync

This will copy the last 5000 lines from the file to a temporary file. Now you probably want to restart whatever service it is that created the file, to release its file lock.

The /usr directory also fills up sometimes, because of Apache. The first thing you should look at is usually the Apache logs.

1. cd /usr/local/apache
2. du -sh *

You will likely find that the logs/error_log or logs/access_log files are very large. At this point, you are free to delete them or use the tail trick above.

How do I restart a daemon ?

Most of the services can be restarted from WHM; however, you may need to restart them from the shell. You must be logged in as root to do this. All standard Linux services, such as HTTP, FTP, Exim, cPanel & WHM, MySQL, etc, have init scripts in /etc/rc.d/init.d/

root@host [~]# ls /etc/rc.d/init.d/
./ atd* exim* httpd.tmpeditlib kdcrotate* named* nscd* rawdevices* snmpd* yppasswdd*
../ autofs* filelimits* identd* keytable* netfs* portmap* rstatd* sshd* ypserv* 
anacron* bandmin* functions* ipaliases* killall* network* portsentry* rusersd* syslog* ypxfrd*
antirelayd* chkservd* gpm* ipchains* kudzu* nfs* proftpd* rwalld* xfs* 
apmd* cpanel3* halt* iptables* lpd* nfslock* radvd* rwhod* xinetd* 
arpwatch* crond* httpd@ isdn* mysql* nofsck* random* single* ypbind*

This is typical of what you will find in this directory. The main ones you should be concerned with are:

• cpanel3 — starts/stops cPanel and WHM. This includes cppop and cluster management services as well.
• exim — starts/stops the exim mail server.
• httpd — starts/stops the Apache web server.
• mysql — starts/stops the MySQL database server.
• named — Starts/stops the BIND DNS server.
• proftpd — Starts/stop the ProFTPd or Pure-FTPd (depending on which is enabled) FTP server.

Using these scripts is very easy. Let's say that named/BIND is down and we need to restart it. As root, type:

• /etc/rc.d/init.d/named start

You should see it start up, with a green [OK] message on the left side of the shell/terminal window.

If you see a red [FAILED] message, check the message log.

• tail /var/log/messages

You should be able to see the error. If you cannot fix it yourself, contact tech support. Some of these services have more options than just "start" and "stop," and other ways to do them.

Let's say you have a lot of domains using your DNS server and you don't want to stop and restart named just because you edited one domain. Type:

• ndc reload

If you make a minor change to the /usr/local/apache/conf/httpd.conf, but don't want to restart it, type:

• /etc/rc.d/init.d/httpd graceful to do a graceful restart. A graceful restart finishes current requests before killing the child processes.

If you want to learn more about the commands a script offers, you can simply run the script without passing any arguments to it.

root@saturn [~]# /etc/rc.d/init.d/cpanel3 <br />Usage: /etc/rc.d/init.d/cpanel3 {start|stop|status|restart}

This lets us know we can start, stop, check the running status of the service(s), or restart it. If you can't get a service to start, and don't know how to fix it, contact tech support for assistance.

How do I fix WHM News if it's broken?

Issue the following command in a terminal session:

• rm -f /var/cpanel/objcache/whmnews

How do I reinstall FrontPage extensions for the entire server?

Issue the following commands in a terminal session:

• rpm -Uvh http://httpupdate.cpanel.net/fp-5.0-upgrade/frontpage/frontpage-5.0-0.i386.rpm

How can I fix "ndc connection refused" errors?

Run the following scripts:

1. /scripts/upcp
   
2. /scripts/fixndc
   
3. /scripts/fixndc
   • The fixndc script needs to be run twice.

How does cPanel move things from Alabnza servers?

Does it redo the folder structure into public_html instead of domain-www?

Yes.

Does it move the email files over from /home/user/domain-mail/emailaddressfile to /home/user/mail/emailaddress/emailaddressfile?

Yes.

Does it keep all of the email settings such as forwarders, auto replies, etc...?

Yes.

Does it also grab the parked domain names?

No.

How do I manually move an account to another server?

When an account is too large to feasibly move using the web browser, the following should work to move the account:

In this example, our domain will be domain.com and our username will be dom.

1. Make a temp directory on /home (we'll call it /home/cptemp/) where you can store the accounts files while copying.
   • mkdir /home/cptemp
2. Almost all space for an account is in the public_html directory, so we'll want to tar and gzip it, and move that over using scp.
   • cd /home/dom/
   • tar czvf public_html_dom.tgz public_html
   • mv public_html_dom.tgz /home/cptemp/
   • mv public_html /home/cptemp/
3. Also, oftentimes large sites have large weblogs, which are packaged and transferred, so we take care of those as well:
   • cd /usr/local/apache/domlogs/
   • gzip domain.com
   • mv domain.com.gz /home/cptemp/
4. Now, with these files in /home/cptemp/, try moving the account over in WHM. Hopefully, it will succeed and set up the new account on the new server. Now we go back to /home/cptemp/ and scp the files to their new home,
   • scp public_html_dom.tgz root@newserver.com:/home/dom/
5. Enter the root pass for the new server and let it copy the file over.
   • scp domain.com.gz root@newserver.com:/usr/local/apache/domlogs/
6. Enter the required login information.
7. Now go to the new server and unpack the two large files you just moved.
   • cd /home/dom/
   • gzip -d domain.com.gz
   • tar xzvf public_html_dom.tgz
   • cd /usr/local/apache/domlogs/

Where is the PureFTPd configuration file?

• /etc/sysconfig/pure-ftpd

How do I enable anonymous uploads with Pure-FTPd?

• Find this in the Pure-FTPd configuration file (/etc/sysconfig/pure-ftpd):
  • # disallow uploads for anonymous users
  • #--anonymouscantupload

Make sure the second line has the # in front of it, then restart PureFTPd.

How can I disable the SMART errors?

Run the following from a command line:

1. touch /var/cpanel/disablesmartcheck
2. /scripts/upcp

How can I debug problems with ProFTPD?

1. Shut it down from the init script.
   • /etc/rc.d/init.d/proftpd stop
2. Start it up from the shell with:
   • proftpd -nd9

You might need to type the full path for debug mode. The default path is:

• /usr/sbin/proftpd

My hard drive is slow and backups take a long time. How can I fix this?

You should make sure that DMA is enabled on your drives.

Note: Some older drives/motherboards have a problem with this, so you should ask your datacenter to be sure it's ok before enabling DMA on your drives.

• To enable DMA for a hard drive: hdparm -d1 /dev/hda
• To disable DMA for a hard drive: hdparm -d0 /dev/hda
• To measure transfer rate of a hard drive: hdparm -Tt /dev/hda
• To see what options are enabled for a hard drive: hdparm /dev/hda
• To see more info on your drive than you wanted to know: (this will show which UDMA modes are supported/enabled) hdparm -i /dev/hda

Can I change the Home and Logout buttons through WHM branding?

These cannot be changed through branding. You will need to edit the WHM theme to modify buttons, background colors, etc.

How do I fix the error "License File Expired"?

Your server needs to be able to communicate with the licensing servers.

To confirm that your server's main IP address matches the IP address stored in the cPanel licensing servers, follow these steps:

1. Run the following via the command line as the root user:

   curl http://www.cpanel.net/apps/myip/

   If the IP addresses do not match, then you will need to do one of the following:
   • Change the routing in your server and network to route outbound traffic from the IP address that is licensed.
   • Change the IP address on the license to match the IP address returned by the curl command.
2. Check the license on http://verify.cpanel.net to ensure that it is valid. If it is not, please contact your license provider.
3. If your license is valid, run the following via the command line as the root user:

   rdate -s rdate.cpanel.net
   /usr/local/cpanel/cpkeyclt

4. Ensure that your server can query the root nameservers and has a valid hostname. If you need assistance with this, contact your hosting provider.

If these steps did not fix the issue, contact your license provider.

Why am I receiving groupadd/useradd errors when attempting to create a new account?

Make sure your /etc/passwd and /etc/group file does not have the +i (immutable flag). You can check by running lsattr /etc/group and lsattr /etc/shadow. If it does have a +i flag, remove it by executing chattr -i /etc/passwd and/or chattr -i /etc/group.

It is also possible that your group shadow file is corrupt. To fix this, move /etc/gshadow to /etc/gshadow.corrupted and run grpconv to rebuild the file. You may need to remove grshadow.lock and/or group.lock if either exists.

Some services (like MySQL) aren't starting on reboots. I get errors about create/write to file in /tmp (Errcode: 13).

This is most likely due to improper permissions on the real /tmp directory. If using /scripts/securetmp at boot time, you may not notice the problem since the script sets permissions correctly after it's booted. The most common error you will see related to this is that mysqld will not start with errors like the following:

 061113 00:14:46 mysqld started 

 /usr/sbin/mysqld: Can't create/write to file '/tmp/ibEkcOgQ' (Errcode: 13) 

 061113 0:14:47 InnoDB: Error: unable to create temporary file; errno: 13 

 061113 0:14:47 [ERROR] Can't init databases 

 061113 0:14:47 [ERROR] Aborting 

 061113 0:14:47 [Note] /usr/sbin/mysqld: Shutdown complete 

 061113 00:14:47 mysqld ended 

To fix this, unmount the /var/tmp and /tmp partitions and set the permissions correctly on the real /tmp directory ilke so:

 # umount /var/tmp 

 # umount /tmp 

 # chmod 1777 /tmp 

Edit /etc/rc.sysinit and add the following line somewhere near the rest of the /tmp stuff:

chmod 1777 /tmp 

Then you can reenable /scripts/securetmp if you'd like.

If you are having trouble with other services, be sure they are enabled:

chkconfig --add pure-ftpd

If you are still getting messages after each reboot from chkservd about

services not being down, you may want to disable it with chkconfig and add it to the end of /etc/rc.local instead, to ensure that other services have time to start up first.

How do I change nameservers in cPanel?

You can change nameservers in WHM under Basic cPanel & WHM Setup.

If you need to change the nameservers associated with your domain, you may need to contact your web host and your domain registrar to update the information with them.

I see this error message: [a fatal error or timeout occurred while processing this directive]. What is wrong?

Check /usr/local/cpanel/logs/error_log for the specific error. You may need to submit a support request to get this issue resolved.

How can I uninstall cPanel & WHM?

The best way to uninstall cPanel & WHM is to reformat your server. It is recommended to reinstall your operating system to return your server to a default setting if you are not going to continue to use cPanel & WHM.

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

You can find out what version of cPanel & WHM you are using by logging into WHM (WebHost Manager). The version will be displayed in the upper right-hand corner. You can also find out the version by running /usr/local/cpanel/cpanel -V from the command prompt. To see what the latest available cPanel version is in your chosen tree (STABLE/RELEASE/CURRENT/EDGE), please visit http://httpupdate.cpanel.net.

If you wish to update cPanel through WHM, under the cPanel cateogry, select Upgrade to Latest Version. If you wish to update cPanel from the command prompt as root, run /scripts/upcp --force.

If you would like your server to automatically update to the latest version every morning, in WHM go under Server Configuration >> Update Config and make sure you have Automatic dotted in for the tree you are using.

Can you easily change the A records to point to an IIS server through cPanel & WHM?

There are two ways you can change the A records in the WHM interface.

First, you could edit the DNS zone manually and change the A records for the domain. To do this in WHM, you would scroll down on the left side of the screen to DNS Functions. Under DNS Functions, click Edit DNS Zone. From here, you can follow the directions on the right side of the screen.

OR:

You could change the way DNS zones are created so they use A records pointed to another server. To do this in WHM, you would scroll down on the left side of the screen to DNS Functions. Under DNS Functions click Edit Zone Templates. On the right side of the screen click the link that says Standard.

Here, you can change any of the following lines as needed for A entries:

        %nameserverentry%. IN A %nameservera%
        %nameserverentry2%. IN A %nameservera2%
        %nameserverentry3%. IN A %nameservera3%
        %nameserverentry4%. IN A %nameservera4%
        %domain%. IN A %ip%
        localhost.%domain%. IN A 127.0.0.1

The %domain% tag outputs your domain name.
The %nameserverentry% tags output the names of your nameservers.
The %nameservera% tags output the IP addresses of your nameservers.

Can I install cPanel on Ubuntu?

Please see: http://www.cpanel.net/products/cPanelandWHM/linux/sys_requirements.htm for supported operating systems. We cannot offer technical support for cPanel installations on operating systems not listed on that page. Most likely, an installation on an operating system that is not listed will not function properly.

I am getting the message "unable to add the user" when trying to create an account.

Log into your server with SSH and check /home/username to see if the user has a home directory. Also check the contents of /etc/passwd to see if there is an entry for that user. You may need to use your operating system's user deletion tool to delete that user.

How do I preview a new domain before the DNS switch makes it live?

You can preview the domain using the server's IP address and your cPanel username. For example, if your IP address is 255.255.255.255 and your username is bob, you can use: http://255.255.255.255/~bob

This may be disabled for security reasons by your web host.

How do I disable/enable WHM access from the command line?

If you wish to disable access to WHM for all users, block incoming traffic on port 2086 and 2087 (this will lock you out as well).

You can also use a firewall to allow access to those ports for specific IP addresses only.

You cannot turn an account into a reseller account (grant WHM access) from the command line. However, you can use the XML API to automate this process. See http://www.cpanel.net/plugins/devel/ for more information.

You cannot shut down WHM, as the WHM services are used to ensure the server stays functioning.

How do I delete, on a daily basis, the mail statistics logs?

Mail statistics are stored in a MySQL database located at /var/lib/mysql/eximstats. You'll need to remove the entries from this database to clean it up.

Alternatively, mail logs located in /var/log, exim_mainlog, exim_rejectlog, and exim_paniclog will need to be wiped clean (or /exim/mainlog, /exim/rejectlog, /exim/paniclog for FreeBSD®) daily.

A cronjob can easily execute a script that wipes either of these daily.

Is it possible to create Domain Templates?

Yes, in cPanel we call these "Packages". You can create these configurations ahead of time and then apply them to new domains. Go to Packages >> Add a Package in WebHost Manager to get started.

I am a web hosting provider. Can I create a custom login page for my customers to log into cPanel, WHM or webmail?

Yes, you can! We have some sample source code you can look at to integrate such a customized login to an existing website. This source code is in PHP and is available at http://www.cpanel.net/cpanel-login.phps.

How do I change the version of PHP I have installed on my server?

First, log into the WHM interface. From there, proceed to the Software section by clicking on the Software icon on the main WHM page, or scroll down the left side of the screen to see the Software section. Then click on the link for Apache Update. This will bring you to the process to recompile Apache. It is through this process you can select which version of PHP you want installed on your server. Once Apache has been fully compiled, you will be able to enjoy your new PHP installation.

Does cPanel & WHM include anti-virus protection?

Yes, it comes with ClamAV at no additional charge.

Does cPanel & WHM support multiple levels of permissions?

Yes. cPanel & WHM supports root-level users that can create/modify any domain and have access to all features of the cPanel & WHM interfaces.

We also support resellers, which are intended to be used for web hosting resellers to be able to manage their own customer's accounts. However, reseller access can be easily tweaked so they only have privileges to suspend/unsuspend domains etc. Resellers have access to the cPanel interface and a limited subset of the functionality of the WHM interface.

Lastly there is the hosting account owner, who has an account in the cPanel interface and can manage most aspects of a website by themselves (within boundaries set by the reseller or root-level user).

When I create a domain, are web statistics automatically generated?

Yes. Statistics are updated at an interval you set in the WHM interface for the web statistics software you enable in WHM. Note that statistics will not be available on the newly created domain until after this interval.

cPanel & WHM comes with the following web statistics software: AWStats, Webalizer, and Analog.

Why won't the homepage of a folder automatically default to index.php?

There can be a few lines in /usr/local/apache/conf/httpd.conf that allow for a index.php file to be displayed automatically. They look like:

# DirectoryIndex: Name of the file or files to use as a pre-written HTML # directory 
index.  Separate multiple entries with spaces.
# <IfModule mod_dir.c>    DirectoryIndex index.ppl 
index.pl index.plx index.perl index.html index.wml index.cgi 
index.shtml index.jsp index.js index.jp index.php4 index.php3 
index.php index.phtml index.htm default.htm default.html 
home.htm </IfModule>

If those lines are not present, you'll need to add the following into a .htaccess file:

DirectoryIndex index.php

More information about .htaccess files can be found here: http://httpd.apache.org/docs/1.3/howto/htaccess.html.

Can I disable non-SSL login for cPanel & WHM?

Under Tweak Settings in WHM, make sure the following option is selected: Always redirect users to the ssl/tls ports when visiting /cpanel, /webmail, etc.

This will disable the use of the insecure ports and redirect users to secure ports when using the /cpanel /whm /webmail aliases.

What PHP modules and plugins does cPanel & WHM support?

You can find a list of supported modules and plugins in our EasyApache documentation under the PHP heading.

How can I change the stylesheet for cPanel in WHM?

You can edit a theme's stylesheet in the Universal Theme Manager in WHM. Select the theme, and then choose the edit live option to edit style sheets, images, etc.

How do I delete an account?

You'll need to go to Account Functions >> Terminate an Account in WHM to delete an account. Please note that you cannot reverse this process. Make sure the account is backed up if you need any of the files from that account.

What is the WHM Autofixer?

The Autofixer is a collection of scripts that can be run from WHM to fix some common issues not otherwise fixable or accessible from command line.

Autofixer scripts can always be found at http://httpupdate.cpanel.net/autofixer/:

• test — Test autofixer on your system, nothing gets changed.
• bsdbindfix — Resolve port issue with BIND 9.
• compresszlibfix — Fix for compress zlib error.
• dbdmysql — DBD::mysql fix for older version of Red Hat (i.e. 7.3).
• fpindexfile — Fix for FrontPage index.
• iptablesflush — Flush iptables rules from WHM if you are firewalled from SSH access.
• libxml64fix — Fix for libXML on 64-bit systems.
• resellerresourceacctounts — Fix for reseller resource accounts.
• safesshrestart — Restores SSH Config and restarts SSH, should you be locked out.
• vfilterfix — Restores /etc/vfilters files.
• yumduprpmfix — This script will attempt to locate and resolve any duplicate RPMs.

Run Autofixer from the following URL https://your.server.ip.here:2087/scripts2/autofixer. Consult the list, then enter the Autofixer script name that you want to run.

Why won't my server resolve domains?

This is usually due to an invalid nameserver setting in /etc/resolv.conf.

We recommend contacting your datacenter for suggested nameservers within their network or adding a valid public nameserver to /etc/resolv.conf.

How do I set my cPanel server under a NAT configuration?

We currently do not support NAT configurations because the account creation process would require extensive changes and customization. If you require a NAT configuration, you must modify your DNS Zone Templates. Your DNS Zone Templates must use a public IP address instead of the private IP address assigned to accounts. However, only 1:1 NAT configurations will function properly.

How do I use WHM on a PDA?

Point your PDA's web browser to the address https://server:2087/scripts/command?PFILE=main where "server" is the IP or hostname of your server, or a domain hosted on the server.

I've installed Tomcat. How do I install servlets on an account?

In WHM go to Account Functions -> Install Servlets. Select an account or domain you wish to have servlets installed upon, and apply the settings.

When logging into cPanel, why do I get a 404 error saying it can't find a theme (./frontend/bluelagoon/index.html), and the page cannot be displayed?

This is more than likely because the theme is missing. To get cPanel working again, edit /var/cpanel/users/username, change the theme to the default, and save it.

This should bring up the default theme. If not, look in /usr/local/cpanel/base/frontend/ for available themes and change it to one that is there.

You can also install new themes from WHM.

cPanel won't update.

Please submit a ticket to our Support department.

Whenever I set up a domain it says "ndc can't connect, connection refused." What is this?

ndc is the name daemon control program. If you are getting that error, run the following script as the root user:

• /scripts/fixndc

If the problem persists, fill out a support request to have the named configuration looked at.

Is cPanel continuing to support FrontPage® extensions? How about on Apache 2?

Yes, cPanel will continue to support FrontPage extensions for the foreseeable future. Additionally, FrontPage extensions are supported on Apache 1.3, 2, 2.2, 2.4.

How can I copy files from one domain directory to another?

You'll need root privileges to copy the files using the cp command. For example, you could copy one directory to another place by running: cp -R /home/dave/public_html/photos/ /home/john/public_html/images/.

For more information on the cp command, type man cp from the command line.

Otherwise, you could use the File Manager in cPanel to download the files you wish to copy. Then log into the other domain's account and use the File Manager to upload the files to that account.

Why won't my X server GUI work after installing cPanel?

Due to numerous security problems, cPanel uninstalls X and prevents it from running. You should never run X on a public server.

Quotas are not working. How can I fix them?

Check for quota support on the mounted filesystems:

FreeBSD:
Output of `mount` , look for "with quotas".
/dev/ad0s1h on /home (ufs, local, with quotas, soft-updates)
In /etc/fstab
/dev/ad0s1h /home ufs rw,userquota,groupquota 2 2

Linux:
Output of `mount` , look for "usrquota".
/dev/hda6 on /var type ext3 (rw,usrquota)
In /etc/fstab
LABEL=/var /var ext3 defaults,usrquota 1 2

If the entries are missing from /etc/fstab, add them. If they are present, verify that there is support for quotas in the kernel and that any relevant modules are loaded.

Check that the quota files are present and not zero byte files:
FreeBSD:
-rw-r----- 1 root operator 2097120 Apr 30 16:19 quota.user

Linux :
-rwxr--r-- 1 root root 8192 Dec 26 20:18 aquota.user*
-rwxr--r-- 1 root root 2097120 Apr 30 04:19 quota.user*

If these files do not exists, run /scripts/initquotas. If they do exist, but quotas are not working, you can either delete the quota files and run initquotas or run /scripts/fixquotas.

After this, repquota -a should print out the soft/hard limits with grace periods for all users.

If quotas are still not reporting anything in WHM and/or cPanel, check /var/cpanel/cpanel.config for

• disablequotacache=0

If that is set to 0, try setting it to 1 and see if that fixes it.

How can I find out where all a user's files are?

If there is a discrepancy between quotas and a du -sh /home/username, chances are, some other files on the system are owned by that user's UID. To find these, type:

• find / -user username -ls

Run that and you will get a long list of all files owned by that user. It might be wise to redirect the output to a file to browse through later.

Depending on the files, it's usually better to chown them to the root user rather than delete them.

Is cPanel compatible with mod security (mod_security)?

Yes, you can install mod_security in WHM under Plugins. More information about configuring mod_security can be found at: http://modsecurity.org/

How can I obtain information about developing software that is integrated with WHM?

To create a piece of software that interacts with WHM, to add an icon for your software inside of cPanel, or to get information from cPanel & WHM, you can use our Plugins system along with our XML API.

We offer API documentation here. We recommend using the XML API in conjunction with API2 to make cPanel calls.

You can also create cPAddon scripts which allow customers to download your software to their server and then domain owners can install it from the cPanel interface section Site Software. Documentation for this type of integration is available here.

For more information about interacting with cPanel & WHM as a developer, read through our Developer Resources.

How can I put the _Change Language icon in the Preferences section of cPanel?

You will need to ensure that the Feature List for the account has the Change Language option checked. This Feature List can be found in WHM under Feature Lists. It will be associated with the Package that the account is using.

How do I set up personal nameservers in WHM?

You will need an IP address for each nameserver.

Under Basic cPanel & WHM Setup, scroll down to Primary Nameserver.

Now add your nameservers in the fields available. Click on Assign IP Address next to each nameserver to assign it an IP. Then add an A entry so they will resolve through DNS.

Finally, make sure that you scroll down and click on Nameserver Setup under Service Configuration, and enable the nameserver.

How do I stop users from getting the "There is a problem with this website's security certificate" message when logging into cPanel?

Under Manage Service SSL Certificates in the Service Configuration section of WHM, you can change the certificates for cPanel & WHM, webmail, your mail servers, etc. You'll need to replace the self-signed certificate with one trusted by the common browsers.

To do this, you can purchase a SSL certificate through WHM for your hostname by using Purchase & Install SSL Certificate under SSL/TLS.

How do I call the WHM XML API?

You can find full XML API documentation at: http://www.cpanel.net/plugins/xmlapi/index.html

Why did Munin stop updating?

Munin is a cPanel Plugin that displays information about CPU, Exim, Apache, MySQL usage, and other information, using rrdtool. If it fails to update, there is likely a permissions issue that is causing it.

First, check to make sure that cron is running, and that there is a crontab entry for Munin. Next, check /var/lib/munin and /var/log/munin. The files in both directories must be owned by munin:munin. If the files in /var/log/munin are not owned by munin:munin, the log files will be updated, but the graphs displayed by Munin will not be updated.

This permissions issue can be corrected by running the following commands as root:
chown -R munin:munin /var/log/munin
chown -R munin:munin /var/lib/munin

Now run Munin manually from the command line: sudo -u munin munin-cron

You should see entries added to /var/log/munin/munin-update, and no errors in the log file. Now refresh the Munin display in WHM. The graphs should be updated.

The weekly graphs may not be updated immediately. These will be updated at the appointed time configured in the crontab.

Does cPanel support Resin? Does cPanel support other Java Application Servers?

cPanel currently supports Tomcat as a Java Application Server. To request other servers, please submit a feature request to bugzilla.cpanel.net.

How can I create a demo version of cPanel?

To do this, create a new "dummy" account in WebHost Manager. Feel free to use a fake domain name. Then, you can use branding to modify the account with your company's logo and look if you'd like.

Now, go to Account Functions >> Disable or Enable Demo Mode in WebHost Manager and turn the account into a demo account.

Why does my Ruby on Rails install not work?

On Ruby on Rails with cPanel, we use the standard set of tools that Rails provides, rather than creating our own. This makes troubleshooting relatively easy.

The error_log is always extremely useful with Rails. 90% of the time, a good indication of what is wrong with the Rails installation will be there. Furthermore, if it is an application-specific issue, mongrel maintains its own error log at {appbase}/log/mongrel.log. If an application is starting and failing without anything in the error_log, there will probably be an indication of the problem in here as well.

After that, there need to be a few gems installed. You can check which gems are installed via "gem query":

• mongrel
• rails
• rake

If any of these are missing, you can install them via gem install <name>. If the wrong version is installed, gem uninstall works just fine. There will also be some dependencies that need to be installed as well.

Once you have verified all of this and the application is still not starting correctly, you can start the mongrel server manually with the command mongrel_rails start -p -d -e production -P log/mongrel.pid from the Rails application's base directory as the user who owns the Rails application. The port can be found in ~/.cpanel/ruby-on-rails.db.

If after following these steps you are still not able to fix your Rails installation, please open a ticket with either your data center or us.

I just created a new account, yet it shows that I'm already using disk space?

When a user has been deleted from the system (terminated account), they may still have files owned by that old user's UID. When a new account is created, the system assigns it the next availble UID, usually that of a terminated account. thus the new account assumes ownership of all files owned by that old user, giving the appearance that the user is already over quota without ever having uploaded anything.

Also, tarballs (.tgz, .tar, .tar.gz) may have files owned by the user they were tarred up with on a seperate system, and when untarred on your server, they are assigned ownership of whatever account has that UID.

This is answered here.

How can I set up a default page which is generated when any new domain is created on the server?

You can set up a default site in the directory /root/cpanel3-skel/public_html/, and it will be the default website for all accounts added afterwards.

How does yum need to be configured to work with cPanel?

cPanel & WHM requires that certain packages be excluded due to the fact that cPanel handles its own installations of services that are separate from what the distros provide. If you have modified the yum.conf, you will want to ensure that the follow excludes do exist:

apache* bind-chroot courier* dovecot* exim* httpd* mod_ssl* mysql* nsd* perl* php* proftpd* pure-ftpd* spamassassin* squirrelmail*

We also strongly recommend using only the vendor-provided distributions, as cPanel is tested only using these packages. 3rd-party repositories such as RPMForge can replace vital parts of the system that cPanel relies on, and cause unexpected results.

After Installation I am having problems with X windows / XFree86?

You cannot run cPanel on a server with Xwindows (XFree86, etc.), as it is very insecure and has no place in a server environment. No support will be given in getting back Xwindows once cPanel has been installed.

Is there a way to access webmail, cPanel, and WHM from behind a firewall?

WHM includes a feature that lets your customers access the following from behind a firewall, using port 80:

• cpanel.example.com — The customer's cPanel account.
• whm.example.com — The customer's WHM account.
• webdisk.example.com — The customer's Web Disk account.
• webmail.example.com — The customer's webmail account.

(In these examples, example.com stands for the customer's domain.)

You can enable this feature by selecting On for the follwing Tweak Settings options in WHM:

• Proxy subdomains
• Proxy subdomain creation

You can learn more about these options by viewing our Tweak Settings documentation.

Or, if you prefer, you can use /scripts/proxydomains to reconfigure the DNS entries manually.

Can I run cPanel behind NAT?

Short answer: No, it is not supported.

It was once semi-possible to run cPanel behind a NAT firewall; however, the system has changed somewhat, so that if you use more than one server behind the NAT (more than one appears from behind the same public IP), the license server will lock the public IP out to prevent abuse.

There are other technical problems, such as virtual hosting with Apache and domain->IP mapping, DNS, and so on, that prevent us from supporting this method.

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

Some builds are released quicker than others. For example, CURRENT builds are released quicker than RELEASE builds, and EDGE builds are released quicker than CURRENT Builds.

To find the latest builds, go to http://httpupdate.cpanel.net, and look for your operating system (FreeBSD or Linux).

Thanks for using cPanel!

I use the APF firewall rules on my server; which ports should I allow?

# Common ingress (inbound) TCP ports
IG_TCP_CPORTS=" 20,21,22,25,26,53,80,110,143,443,465,993,995,2077,2078,2082,
2083,2086,2087,2095,2096,3306,6666"
   
# Common ingress (inbound) UDP ports
IG_UDP_CPORTS="21,53,465,873,2077,2078"
   

# Common ICMP (inbound) types
# 'internals/icmp.types' for type definition; 'all' is wildcard for any
IG_ICMP_TYPES="3,5,11,0,30,8"
 
# Common egress (outbound) TCP ports
EG_TCP_CPORTS="21,25,26,37,43,53,80,113,465,873,3306"
 
# Common egress (outbound) UDP ports
EG_UDP_CPORTS="20,21,53,465,873"
 
# Common ICMP (outbound) types
# 'internals/icmp.types' for type definition; 'all' is wildcard for any
     EG_ICMP_TYPES="all"

Thanks to Billy Vierra for the info.

"rndc: connection to remote host closed." What does this mean?

Attempting to restart bind 
Waiting for bind to restart.... . . . . . . . . . . finished. 

rndc: connection to remote host closed 

This may indicate that the remote server is using an older version of the command protocol, this host is not authorized to connect, or the key is invalid.

To fix this issue you may try running /scripts/fixndc.

Which browsers are compatible with cPanel & WHM?

cPanel & WHM 11.34 is compatible with the following browsers:

• Google Chrome 20 and above. Get the latest version.
• Mozilla Firefox 12 and above. Get the latest version.
• Microsoft Internet Explorer 8 and 9. Get the latest version.

cPanel & WHM 11.34 has limited compatibility with the following browsers:

• Safari for iPad
  • Note: New features specifically designed for cPanel & WHM version 11.34 are supported.
• Microsoft Internet Explorer 6 and 7
• Safari 5.1 and above
  • Note: In these browsers, specific features related to email are supported. The pages in cPanel & WHM 11.34 will likely function, but there may be minor defects or inconveniences related to specific functionality.
• Opera 12
  • Note: This is a known problem with the Opera browser. We recommend that Opera users disable browser caching or use a different browser as a workaround.

Why am I receiving emails with the subject “Output from your job” from my server?

cPanel & WHM 11.32 now installs the at daemon (atd) as part of the update process. We use it for launching the update-analysis process to validate the health of the system after updates.

If the update-analysis process encounters any errors, the at daemon will email a report to the system administrator account.

Why can’t I compress or extract .zip files in File Manager?

Zip is not installed on your system. Your system administrator will need to install Zip at the command line with the following command: yum install zip

How do I change the maximum connections for HTTP?

You can change the value of the Max Clients setting in the Global Configuration feature of WHM (Home >> Service Configuration >> Apache Configuration >> Global Configuration).

Note: The value you choose for the Max Clients setting must be equal to or lower than the value of the Server Limit setting.

How do I change the maximum number of IMAP connections per IP?

You can change the value of the Maximum IMAP Connections Per IP setting in the Mailserver Configuration feature of WHM (Home >> Service Configuration >> Mailserver Configuration).

Note: IMAP settings are the same for both Courier and Dovecot.

How do I change the maximum number of POP3 connections per IP?

You can change the value of the Maximum POP3 Connections Per IP setting in the Mailserver Configuration feature in WHM (Home >> Service Configuration >> Mailserver Configuration).

Note: POP3 settings are the same for both Courier and Dovecot.

How do I change the maximum number of simultaneous incoming SMTP calls?

You can change the value of the smtp_accept_max setting in the Exim Advanced Editor feature of WHM (Home >> Service Configuration >> Exim Configuration Manager >> Advanced Editor).