Difference between revisions of "Provisioning Issues"

Latest revision as of 20:03, 23 November 2022

This page provides information about general errors that may occur with multiple modules.

For specific errors relating to individual modules, see the Troubleshooting section of the corresponding module's documentation page.

Product Provisioning Problems

WHMCS can automatically provision services either before or after payment or can wait until a staff member manually approves it or disables it entirely.

To set this on a per-product basis, use the Module Settings tab when editing a product at Configuration () > System Settings > Products/Services or, prior to WHMCS 8.0, Setup > Products/Services > Products/Services.

If setup does not occur automatically, see Troubleshooting Product Provisioning Problems. This includes help with the following errors:

Server Command Error - Curl Error - Couldn't resolve host (6)
Server Command Error - Curl Error - Couldn't connect to host (7)
Required Product Module '' Missing
Allowed memory size of xxxxx bytes exhausted
Server Command Error - Curl Error - 28 connect() timed out
406 Not Acceptable

Domain Provisioning Problems

WHMCS can automatically register or transfer domains after the client has paid the invoice. You can either specify the registrar to use for this automation or disable the automation entirely per-domain at Configuration () > System Settings > Domain Pricing or, prior to WHMCS 8.0, Setup > Products/Services > Domain Pricing.

If you have selected a registrar in the steps above but the system didn't send the domain to the registrar upon payment, an error has occurred. Review Configuration () > System Logs or, prior to WHMCS 8.0, Utilities > Logs at the time of ordering for any error messages, which will explain what the problem is. You can find an explanation of common error messages at:

To submit the domain registration or transfer request to your registrar again, see Handling a Failed Domain Registration.

Welcome Email Sending Problems

Problems sending welcome emails typically relate to the account creation issue above. The system sends the welcome email when the module's Create command completes successfully and automatically, creating the account on the server. Unsent welcome emails indicate a problem with the automated setup not occurring.

For steps to troubleshoot this, see Email Sending Issues.

Other Module Command/Registrar Error

For steps to identify other module command or registrar command errors, see Troubleshooting Guide.

@@ Line 1: / Line 1: @@
-This page provides information about general errors that may occur with multiple modules. For troubleshooting and debugging instructions, see [[Auto Setup Issues]]. For specific errors relating to individual modules, see the Troubleshooting section of the corresponding [[Server_Modules|module's documentation page]].
+This page provides information about general errors that may occur with multiple modules.
-===Hosting accounts aren't provisioned automatically===
+For specific errors relating to individual modules, see the Troubleshooting section of the corresponding [[Server_Modules|module's documentation page]].
-<html><a href="http://www.youtube.com/watch?v=Ug3wbYRpUgI" class="docs-video-tutorial"><em>Watch the video tutorial for this feature.</em><span> <img src="https://assets.whmcs.com/icons/youtube.png"> </span></a></html>
+== Product Provisioning Problems ==
-Review '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Logs''' ('''Utilities > Logs > Activity Log''' in WHMCS 7.x and earlier) at the time of account creation for any error messages.
+WHMCS can automatically provision services either before or after payment or can wait until a staff member manually approves it or disables it entirely.
-===Server Command Error - Curl Error - Couldn't resolve host (6)===
+To set this on a per-product basis, use the '''Module Settings''' tab when editing a product at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Products and Services|Products/Services]]''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Products/Services'''.
-This error indicates that the account doesn't have an associated server.
+If setup does not occur automatically, see [https://help.whmcs.com/m/troubleshooting/l/679718-troubleshooting-product-provisioning-problems Troubleshooting Product Provisioning Problems]. This includes help with the following errors:
-Check for the following issues at the '''Servers''' tab while editing a product group at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Products/Services''':
+* <tt>Server Command Error - Curl Error - Couldn't resolve host (6)</tt>
+* <tt>Server Command Error - Curl Error - Couldn't connect to host (7)</tt>
+* <tt>Required Product Module <nowiki>''</nowiki> Missing</tt>
+* <tt>Allowed memory size of xxxxx bytes exhausted</tt>
+* <tt>Server Command Error - Curl Error - 28 connect() timed out</tt>
+* <tt>406 Not Acceptable</tt>
-** You have set the correct servers and that, if using a server group, '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Servers''' lists at least one server for that server group.
+== Domain Provisioning Problems ==
-** The module is the same module that you selected in the '''Module Settings''' tab for the individual products.
-===Server Command Error - Curl Error - Couldn't connect to host (7)===
+WHMCS can automatically register or transfer domains after the client has paid the invoice. You can either specify the registrar to use for this automation or disable the automation entirely per-domain at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Domain Pricing]]''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Domain Pricing'''.
-This error indicates that a firewall on your server is blocking the connection. The port depends on the module in use:
+If you have selected a registrar in the steps above but the system didn't send the domain to the registrar upon payment, an error has occurred. Review '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > [[System Logs]]''' or, prior to WHMCS 8.0, '''Utilities > Logs''' at the time of ordering for any error messages, which will explain what the problem is. You can find an explanation of common error messages at:
-* cPanel — <tt>2086</tt> and <tt>2087</tt>
+*[[Troubleshooting Guide]].
-* Plesk — <tt>8443</tt>
+*[[Common Troubleshooting Tips]].
-* DirectAdmin — <tt>2222</tt>
+*[[Domain Registrars]].
-Leave these ports open for inbound and outbound connections on the WHMCS server and the remote server. For assistance, contact your hosting provider or system administrator.
+To submit the domain registration or transfer request to your registrar again, see [[Domains_Management#Handling_a_Failed_Domain_Registration|Handling a Failed Domain Registration]].
-===Other Module Command/Registrar Error===
+==Welcome Email Sending Problems==
-For steps to identify other module command or registrar command errors, see [[Troubleshooting Guide]].
+Problems sending welcome emails typically relate to the account creation issue above. The system sends the welcome email when the module's '''Create''' command completes successfully and automatically, creating the account on the server. Unsent welcome emails indicate a problem with the automated setup not occurring.
-===Required Product Module <nowiki>''</nowiki> Missing===
+For steps to troubleshoot this, see [[Email Sending Issues]].
-This error message indicates that a module command was performed for a product without an assigned module. Go to the '''Module Settings''' tab for a product at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Products/Services''' to check the module setting.
+==Other Module Command/Registrar Error==
-If the module selection has intentionally been left at ''None'', consider using the [[Auto Release]] module. This module lets WHMCS open a support ticket or create a to-do list entry when a module command is performed to notify you that manual action is required.
+For steps to identify other module command or registrar command errors, see [[Troubleshooting Guide]].
-===Allowed memory size of xxxxx bytes exhausted===
-An error message like "''Allowed memory size of xxxxx bytes exhausted (tried to allocate xxxx bytes)''" indicates that WHMCS has reached the maximum amount of memory in the <tt>memory_limit</tt> setting in your server's PHP configuration. Adjust this setting until the error is resolved. For assistance, contact your hosting provider or system administrator.
-===Server Command Error - Curl Error - 28 connect() timed out===
-This error indicates that the attempted operation timed out. There are several common causes of this issue:
-* The server is too busy dealing with other requests.
-* The server required more than 150 seconds to provision the account.
-* The server's site IP address does not match the server details in WHMCS.
-* The server doesn't exist.
-In order to resolve this, make certain that:
-* Your firewalls aren't blocking requests from WHMCS.
-* You have correctly configured SSL mode for the server at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Servers'''.
-===406 Not Acceptable===
-A ''406 - Not Acceptable'' error usually is due to the server's <tt>mod_security</tt> rules blocking the query from WHMCS.
-To resolve this, check the <tt>mod_security</tt> log for the triggered rule and [https://github.com/SpiderLabs/ModSecurity/wiki/ModSecurity-Frequently-Asked-Questions-%28FAQ%29#how-do-i-whitelist-an-ip-address-so-it-can-pass-through-modsecurity|whitelist that rule]. If you do not have access to the server's <tt>mod_security</tt> log or to change the rule configuration, contact your server administrator or hosting provider.
+{{troubleshooting}}

Documentation