Revision as of 15:13, 2 August 2011

Adding a cPanel Server

We have prepared a video tutorial for this section @ http://whmcs.com/tutorials.php?i=5

The following steps guide you through the process of setting up a server in WHMCS for cPanel Hosting Accounts.

1. You need to begin by creating a Server for your cPanel products to be assigned to in WHMCS
2. To do this navigate to Setup > Servers and click on Add New Server
   

   WHM Access Hash Setup
3. Enter the server name, IP address, select the server type "cpanel" from the dropdown menu and enter the username and password for cPanel/WHM
4. Alternatively you can use the username + access hash combination. This is the more secure option and can be obtained via Cluster/Remote Access > Setup Remote Access Key in WHM. NB. The "WHM" login button will not function.
5. Ticking the SSL Mode checkbox is also recommended, but all other fields are optional
6. Click Create Server to complete the process and add your new cPanel Server

Setting Up a cPanel Package

We have prepared a video tutorial for this section @ http://whmcs.com/tutorials.php?i=4

cPanel Module Settings

Adding a Package in WHM

To setup a cPanel package, go to Setup > Products & Services. From there, you can create the product and configure the general settings and pricing info as normal. When it comes to the Module Settings tab, select "cpanel" in the module dropdown field and then for a shared hosting package:

1. In most cases, you should create a package inside WHM itself (in Packages > Add a Package) and then just enter the Package Name into WHMCS exactly as it appears in WHM (leaving all the other fields blank)
2. But there is also the option to define custom packages - you can do that by leaving the Package Name field blank and defining the individual limits into the fields the module settings page (You will need root access for this to work)
3. Max Addon Domains is the last field that applies to shared hosting accounts in the list.
4. And then finally as with all products you have the option of choosing the automatic setup option you want for new orders, be it immediately as soon as the order is placed, as soon as the initial payment has been received (recommended) or waiting until an admin manually reviews & accepts the pending orders

For a reseller package

Creating an ACL List

1. Set the settings for the resellers own hosting account as above
2. The fields from "Limit Reseller by Number" onwards specify reseller settings so from there you can set the resellers limits by number or disk space
3. The Reseller ACL List is required and defines what features inside WHM the reseller is allowed to use. To setup an ACL list, WHM doesn't offer a way without setting up a reseller so inside WHM go to the Reseller Center and activate a domain as a reseller, then proceed to the Edit reseller privileges & nameservers page and enter a name to save the feature selections before saving.

Common Problems

You do not have permission to use Selected Package

If you receive this error when trying to create an account then you need to correct the Packages Name setting. To do this, go to Setup > Products/Services > Edit > Module Settings on the package where you are receiving the error. Where it asks for the WHM Package Name, you must enter this exactly as it appears in WHM - which should be in the format username_packagename.

Package Not Allowed or Exceeded Resource/Account Allocation

This error most likely means you only have reseller access to your server and are trying to create an account without a valid package name. You need to make sure the WHM Package Name in the product configuration of WHMCS matches exactly what is setup in your WHM.

Resellers are not permitted to create subdomains of the server's main domain

This means no domain has been selected and is missing. Ensure the product has a domain name entered. You may need to enable Require Domain in Setup > Product/Services > Edit.

Unable to validate setting for language: english

cPanel/WHM have made a number of changes to their API in the latest versions that are not backwards compatible. Therefore it is no longer possible to use an old version of WHMCS with the latest version of cPanel. You will need to upgrade your WHMCS install to version 4.2.1.

Sorry, that username is reserved.

cPanel/WHM does not allow usernames to contain the phrase "test" amongst others, so when this error occurs, simply change the username under the client's products/services tab and run the Create Module Command again.