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 5: / Line 5: @@
 == Product Provisioning Problems ==
-WHMCS can automatically provision services, you can specify whether this happens before or after payment, wait until a staff member manually approves it or disables it entirely.
+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 (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Products and Services|Products/Services]]'''.
+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'''.
-* If the auto-setup is not occurring, begin your troubleshooting by watching [http://youtu.be/Ug3wbYRpUgI this video tutorial].
+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:
-* If that doesn't help, review '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Logs''', or, prior to WHMCS 8.0, '''Utilities > Activity Log''' 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:
+* <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>
-*[[Troubleshooting Guide]]
+* <tt>Required Product Module <nowiki>''</nowiki> Missing</tt>
-*[[Common Troubleshooting Tips]]
+* <tt>Allowed memory size of xxxxx bytes exhausted</tt>
-*[[Server Modules]]
+* <tt>Server Command Error - Curl Error - 28 connect() timed out</tt>
+* <tt>406 Not Acceptable</tt>
-===Hosting accounts aren't provisioned automatically===
-<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>
-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.
-===Server Command Error - Curl Error - Couldn't resolve host (6)===
-This error indicates that the account doesn't have an associated server.
-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''':
-** 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.
-** 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)===
-This error indicates that a firewall on your server is blocking the connection. The port depends on the module in use:
-* cPanel — <tt>2086</tt> and <tt>2087</tt>
-* Plesk — <tt>8443</tt>
-* DirectAdmin — <tt>2222</tt>
-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.
-===Required Product Module <nowiki>''</nowiki> Missing===
-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.
-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.
-===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.
 == Domain Provisioning Problems ==
@@ Line 77: / Line 22: @@
 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'''.
-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 > Activity Log''' 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:
+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:
 *[[Troubleshooting Guide]].
@@ Line 89: / Line 34: @@
 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.
-You can troubleshoot this using the steps above. If those steps do not resolve the issue, see the additional steps in [[Email Sending Issues]].
+For steps to troubleshoot this, see [[Email Sending Issues]].
 ==Other Module Command/Registrar Error==

Documentation