This tutorial will walk you through installing cPanel and WHM (WebHost Manager) 11.24 on your CentOS or Red Hat Enterprise Linux Cloud Server. This tutorial is only one example, as there are multiple ways that you can configure cPanel during.
NOTE: cPanel is a 3rd party software provider. Rackspace Cloud does not distribute or support cPanel, WHM, or any related software. You can read more about purchasing a licensed version of cPanel from their website.
Before you begin your cPanel installation you need to make sure you have met the following conditions, or the installation will fail:
You can modify this by changing the 'hostname=' line in /etc/sysconfig/network and then restarting your server. For more information on setting the hostname in CentOS you can check out this article.
sudo iptables -I INPUT -p tcp --dport 2086 -m state --state NEW,ESTABLISHED -j ACCEPT sudo iptables -I INPUT -p tcp --dport 2087 -m state --state NEW,ESTABLISHED -j ACCEPT sudo service iptables save
Some other items to mention before installing:
First we need to install Perl so the cPanel installation can run. We will install the version of Perl that is currently available on the YUM software repositories by using the following command. It is assumed that you are running this command as a non-root user with sudo permissions.
This command downloads and installs Perl from the YUM repository:
# cd ~# sudo yum install perl
Now you need to download the cPanel installation script. This small file will connect to the cPanel site and download the latest version of their software.
Use the following command to download the script:
Now we are ready to install cPanel. Please be prepared to leave your SSH connection open for several hours without interruption. If your connection is interrupted it could cause the installation to fail! This may require that you change the Sleep or Powersave settings on your local machine.
Use this command to install cPanel:
# sudo sh latest
After the install is completed you should see:
cPanel Layer 2 Install Complete
Now we are ready to login for the first time.
Replace 188.8.131.52 with your server's IP address.
This will bring up a login window. Type in root for the user name and enter your root password and click OK.
If you agree to the End User License Agreement, click 'I agree/ Go to Step 2'
On this screen we will not make any changes. Simply click Skip This Step and Use Default Settings at the top.
Now you need to make a couple of decisions. The first decision to make is todetermine if you will run your own nameservers or not.
If you plan on running your own nameservers, please select the type of server you'd like to run. We recommend running BIND as it is most commonly used.
Next, you need to list your nameservers. If you are choosing to run your own nameservers, then you will need to list your server's Fully Qualified Host Name (FQHN) here.
If you are not going to run a nameserver select Disabled.
If you are choosing to use a third-party source for DNS, then you will need to enter their information. This is shown to customers when they are setting up domains in cPanel.
If you are running your own nameserver you might want to create a DNS record in your Cloud Server Control Panel for your server. A suggested name would be 'ns' or 'ns1'. After you have completed these steps, click 'Save & Go to Step 5'.
Next we need to setup the FTP services. We recommend using the default option (Pure-FTPD).
You also need to configure mail services. Use the default option for this selection as well.
Click 'Save & Go to Step 6' to continue.
Leave the default option selected (Use file system quotas) for quotas.
Click 'Finish Setup Wizard' in order to finish the installation.
Congratulations! Your cPanel Installation is now complete!
© 2011-2013 Rackspace US, Inc.
Except where otherwise noted, content on this site is licensed under a Creative Commons Attribution-NonCommercial-NoDerivs 3.0 Unported License