Difference between revisions of "Provisioning Issues"

From WHMCS Documentation

(Product Provisioning Problems)
 
(8 intermediate revisions by the same user not shown)
Line 1: Line 1:
This page provides the explanations and solutions to general errors which 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>
 
  
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, the most common errors are explained further down this page and on the corresponding module's documentation page:
+
== Product Provisioning Problems ==
  
*[[Server Modules]]
+
WHMCS can automatically provision services either before or after payment or can wait until a staff member manually approves it or disables it entirely.
*[[Domain Registrars]]
 
  
===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 message indicates that you don't have a server selected for the account to be setup on. There are a few points you should check:
 
  
* Ensure you have a default server set in '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Products/Services > Servers''' (denoted by an asterisk *) and that a server is selected on the account that you are trying to setup.
+
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 a server group has been configured ensure at-least one server has been added to the group.
+
* <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>
  
* The module selected under '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Products/Services > Servers''' is the same as the module selected under '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Products/Services > Products/Services > Edit > Module Settings'''.
+
== Domain Provisioning Problems ==
  
===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'''.
Getting this error means that you have a firewall on your server blocking the connection. The port being used depends upon the module in use (for cPanel it would be 2086/2087, Plesk 8443, and DirectAdmin 2222). Leave these open for inbound and outbound connections on both the server WHMCS is installed on and the remote server being connected to. Please contact your server administrator or hosting provider to open those ports.
 
  
===Other Module Command/Registrar Error===
+
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:
Steps for identifying the cause of other Module Command or Registrar Command errors can be found in our [[Troubleshooting Guide]].
 
  
===Required Product Module <nowiki>''</nowiki> Missing===
+
*[[Troubleshooting Guide]].
This error message indicates that a module command was performed for a product to which no module is assigned. Navigate to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Products/Services > Products/Services > Edit > Module Settings''' and ensure the appropriate module is selected.
+
*[[Common Troubleshooting Tips]].
 +
*[[Domain Registrars]].
  
If the module selection has intentionally been left at None, then you may wish to consider using the [[Auto Release]] module instead. With the [[Auto Release]] module, WHMCS can 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.
+
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]].
  
===Allowed memory size of xxxxx bytes exhausted===
+
==Welcome Email Sending Problems==
An error message like "''Allowed memory size of xxxxx bytes exhausted (tried to allocate xxxx bytes)''" means that WHMCS has reached maximum amount of memory available per the <tt>memory_limit</tt> setting in your server's PHP configuration. You should increase this setting until the error is resolved; contact your server admin/hosting provider for assistance making this change.
 
  
Take this opportunity to ensure all the other [[System Requirements]] are met.
+
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.
  
===Server Command Error - Curl Error - 28 connect() timed out===
+
For steps to troubleshoot this, see [[Email Sending Issues]].
This error message means that the operation you were attempting to perform timed out. Some common causes of timeouts in WHMCS are:
 
  
* Server too busy dealing with other requests
+
==Other Module Command/Registrar Error==
* Server taking more than 150 seconds to provision the account
 
* Server site IP address does not match the server details entered into WHMCS
 
* Server doesn't exist
 
  
In order to resolve this you must ensure:
+
For steps to identify other module command or registrar command errors, see [[Troubleshooting Guide]].
 
 
* There is no firewall on your server blocking the requests from WHMCS
 
* Enable or disable SSL mode on your servers by going to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Products/Services > Servers > Edit'''.
 
 
 
===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 being executed.
 
 
 
To resolve this, check the <tt>mod_security</tt> logs to see which rule is being triggered 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 <tt>mod_security</tt> logs or to change the rule configuration, contact your server administrator or hosting provider.
 
 
 
===Server load, uptime and phpinfo always say Unavailable or 00:00:00===
 
In order for these values to be obtained, the <tt>/status/index.php</tt> file that you upload to every server has to be able to execute the PHP functions exec and shell_exec on that server.  These are often disabled by default for security reasons.  To enable them, you need to login to your server by SSH and then locate the php.ini file and open it for editing.  Search down for the line that says disabled_functions and then remove exec and shell_exec from the list of functions following that.
 
 
 
For security, by default the phpinfo is disabled, you would need to edit the index.php file of the status directory and uncomment the phpinfo(); line,
 
  
 
{{troubleshooting}}
 
{{troubleshooting}}

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.