How to Troubleshoot Provisioning Issues Using WHMCS

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

Module Create Failed - Service ID: 4 - Error: Access denied
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.
Server Command Error - Curl Error - Couldn't connect to host (7)
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 resolve host (6)
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.
Allowed memory size of xxxxx bytes exhausted
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.
406 Not Acceptable
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.
JB
John-Paul Briones Content Writer II

John-Paul is an Electronics Engineer that spent most of his career in IT. He has been a Technical Writer for InMotion since 2013.

More Articles by John-Paul

2 thoughts on “How to Troubleshoot Provisioning Issues Using WHMCS

  1. Check the server settings configured by navigating to: Setup > Products/Services > Servers is not a resolution – DO BETTER!!

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

Was this article helpful? Join the conversation!