WHMCS is a complete solution for resellers. Its features allow you to configure auto-provisioning of a cPanel account, through your WHM reseller account. In this guide, you can learn how to troubleshoot provisioning failures in WHMCS.
Auto Setup Configuration Requirements
In order to take advantage of the auto setup functionality, there are a few options, located in various areas of WHMCS, that need to be configured accordingly. Simply review the list below to ensure you have properly configured the WHMCS Auto Setup feature.
- Add a Server
- The cPanel server information must be provided by navigating to: Setup > Products/Services > Servers > Add New Server.
- Add a Product Group
- A Product Group is necessary to assign to Products to. You can add a Product Group by navigating to: Setup > Products/Services > Products/Services > Create a New Group.
- Add a Product
- Once you have created a Product Group, you can proceed to create a Product by navigating to: Setup > Products/Services > Products/Services > Create a New Product.
- Modify Product/Services Module Settings
- Once you have created a Product or Service to sell to your clients, the Module Settings need to me adjusted to control WHMCS should create the account. This is done by navigating to: Setup > Products/Services > Products/Services > { Product Selection } > Module Settings. Select either “Automatically setup the product as soon as an order is placed” or “Automatically setup the product as soon as the first payment is received”.
Once you have confirmed that you have properly setup the required configuration, you can further troubleshoot by reviewing the errors present in the various WHMCS logs. In the next section, you can learn how to access and review the Activity Log.
Review Activity Logs
WHMCS logs are very useful because they include a variety of details for many processes that occur “behind-the-scenes”.
Once you are logged into the WHMCS administrative back-end, hover over Utilities > Logs, and then click on Activity Log. You will be redirected to a page that allows you to review the entries in the log file.
With the details you find in this log, you can typically determine the reason for the error. In the next section, you can learn some of the common remedies for errors that may be reported in the Activity Log.
Common Auto Setup Failure Errors
- Diagnosis
- This error indicates that the cPanel server denied WHMCS access to create the account.
- Resolution
- Check the server settings configured by navigating to: Setup > Products/Services > Servers. Tip: Use the “Test Connection” button to confirm access granted.
Module Create Failed - Service ID: 4 - Error: Access denied
- Diagnosis
- This error indicates that WHMCS did not receive a response from the request for a connection to create the account on the cPanel server .
- Resolution
- Check the server settings configured by navigating to: Setup > Products/Services > Servers. Tip: Use the “Test Connection” button to confirm access granted.
- Check the cPanel server to ensure that the Port 2087 is available and not restricted.
Server Command Error - Curl Error - Couldn't connect to host (7)
- Diagnosis
- This error indicates that WHMCS was unable to connect to the server configured.
- Resolution
- Check the server settings configured by navigating to: Setup > Products/Services > Servers. Tip: Use the “Test Connection” button to confirm access granted.
- Check the cPanel server to ensure that the Port 2087 is available and not restricted.
Server Command Error - Curl Error - Couldn't resolve host (6)
- Diagnosis
- This error indicates that the amount of memory configured through PHP is insufficient.
- Resolution
- Increase the memory_limit size limit above 128M for WHMCS.
Allowed memory size of xxxxx bytes exhausted
- Diagnosis
- This error indicates that the server rejected the activity by WHMCS due to ModSecurity.
- Resolution
- Check the ModSecurity settings and log(s) to determine the rule in violation and disable it.
406 Not Acceptable
Check the server settings configured by navigating to: Setup > Products/Services > Servers is not a resolution – DO BETTER!!
Hello Dezznutz – Thanks for your comment. I have noted this article for review. In some cases, a reseller may have too high a load with the existing infrastructure, so this may be a step towards resolving a problem with provisioning issues. However, it should be noted as such. An update to this article will be added after review.