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.