cpanel on

Troubleshooting Server Issues

Mon, 01 Jan 0001 00:00:00 +0000

Index page covering general provisioning troubleshooting steps using the Module Queue, Module Log, and cron status, and linking to cPanel & WHM, Plesk, and WP Squared server module issue articles.

Overage Billing

Mon, 01 Jan 0001 00:00:00 +0000

Steps through enabling Overages Billing on a product, setting Soft Disk Limit, Soft Bandwidth Limit, and per-unit overage costs, enabling Overage Billing Charges and Include on Next Invoice in Automation Settings, and explains usage calculation timing, invoice line item formatting, and overriding limits with custom fields or configurable options.

Sitejet Builder

Mon, 01 Jan 0001 00:00:00 +0000

States the server version requirements for Sitejet Builder (cPanel & WHM 116+ or Plesk 18.0.57+), the two offering methods (bundled into hosting products or as a predefined product addon), and describes client access via the Edit with Sitejet Builder link in the Client Area and admin single sign-on access via Log in to Sitejet Builder in the client’s Products/Services tab.

Single Sign-On

Mon, 01 Jan 0001 00:00:00 +0000

Details the View Products & Services and Perform Single Sign-On permissions required by users, per-server per-admin-role-group access controls configurable under a server’s SSO Access Control setting, and the Client Area Quick Shortcuts section for direct control panel authentication.

Application Links

Mon, 01 Jan 0001 00:00:00 +0000

Covers activating and configuring Application Links for cPanel, the supported Ordering, Support, and Account links table, the Application Link Activity Log levels (Debug, Information, Notice, Warning), and where users and admins can revoke single sign-on permissions.

Migrate Data to WHMCS

Mon, 01 Jan 0001 00:00:00 +0000

Compares the ImportAssist addon, the Sync Accounts feature for cPanel, Plesk, and DirectAdmin servers, and manual entry as methods for migrating clients, hosting accounts, and domains into WHMCS from another billing system or CSV file.

Usage Billing

Mon, 01 Jan 0001 00:00:00 +0000

Covers usage billing for cPanel, DirectAdmin, and Plesk products, the Snapshot and Time Based usage formats, enabling metrics in the Module Settings tab, the Per Unit, Total Volume, and Graduated metric pricing types with worked pricing examples, viewing Metric Statistics and Unbilled Usage in the client profile, the Enable Metric Usage Invoicing setting, and the twice-daily TenantUsageMetrics cron task.

Access Denied Errors

Mon, 01 Jan 0001 00:00:00 +0000

Covers “Access Denied/Permission Denied” errors on cPanel & WHM or WP Squared servers caused by the server denying WHMCS the requested action, with steps to verify server credentials, API token permissions, and the Module Log.

Action Failed Errors

Mon, 01 Jan 0001 00:00:00 +0000

Documents the “Action Failed Unable to auto-login” error on cPanel & WHM or WP Squared servers, caused by an empty username on the client’s Products/Services tab, with the fix of entering a username and re-running Create.

Configurable Package Addon

Mon, 01 Jan 0001 00:00:00 +0000

Lists activation steps and the required configurable option names, types, and examples (Disk Space, Bandwidth, Email Accounts, Dedicated IP, and similar) for cPanel, DirectAdmin, and WP Squared packages, plus notes on WHM feature lists and IP address limitations.

cPanel

Mon, 01 Jan 0001 00:00:00 +0000

Covers adding a cPanel & WHM server with API token or WHM credentials, required outbound ports 2086/2087, creating products via existing WHM package, custom package options in Advanced Mode, or reseller packages with per-account billing, required API token permissions, WHMCS Connect support, Keep DNS Zone on termination, disabling Two-Factor Authentication for API requests, and Add-On Features like WP Toolkit.

Create a cPanel Server

Mon, 01 Jan 0001 00:00:00 +0000

Walks through adding a cPanel & WHM server to WHMCS: creating an API token in WHM, adding a new server and selecting the cPanel module, entering the hostname, username, and API token, testing the connection, and saving the server.

Customize Quick Shortcuts

Mon, 01 Jan 0001 00:00:00 +0000

Identifies the overview.tpl template files for the cPanel and Plesk server modules that control the Quick Shortcuts icons shown in the Client Area product details page, and warns that WHMCS updates may overwrite direct edits to these files.

Group Already Exists Errors

Mon, 01 Jan 0001 00:00:00 +0000

Covers the “Sorry, a group for that username already exists” cPanel error caused by a duplicate username on a shared server, with the fix of changing the account’s username.

Invalid cpmod Errors

Mon, 01 Jan 0001 00:00:00 +0000

Documents the “Invalid value paper_lantern for the cpmod setting” provisioning error caused by a nonexistent cPanel theme in the product configuration, with the fix of updating the cPanel Theme module setting.

Invalid Numeric Value Errors

Mon, 01 Jan 0001 00:00:00 +0000

Covers “Invalid numeric value” provisioning errors on cPanel & WHM or WP Squared servers caused by an invalid product configuration value, with steps to correct the flagged setting in the product’s Module Settings.

Key Generation Failed Errors

Mon, 01 Jan 0001 00:00:00 +0000

Covers the Key Generation Failed: You do not have the feature sslmanager error during MarketConnect SSL installation on cPanel, caused by the package missing SSL/TLS permissions, with the fix of enabling SSL/TLS in WHM and retrying via Resend Configuration Data.

License Profile Errors

Mon, 01 Jan 0001 00:00:00 +0000

Documents server profile mismatch errors requiring a valid cPanel & WHM or WP Squared license and profile, caused by using the wrong module for the server’s control panel, with steps to verify the license and server profile in WHM.

Login Failed Errors

Mon, 01 Jan 0001 00:00:00 +0000

Covers the cPanel & WHM or WP Squared “Login Failed” provisioning error, caused by incorrect server credentials or brute force protection blocking the API, with fixes for both causes.

Migrate cPanel Services

Mon, 01 Jan 0001 00:00:00 +0000

Covers three migration methods after moving cPanel accounts server-side: manually reassigning each service’s Server field, running a bulk UPDATE tblhosting MySQL query using old and new server IDs, or editing the existing server record’s hostname, IP, and API Token in place, plus verifying migration success with Sync Accounts.

Missing Username Errors

Mon, 01 Jan 0001 00:00:00 +0000

Documents the “No user name supplied” provisioning error caused by an empty username on the client’s Products/Services tab, with the fix of entering a username and re-running Create.

Missing WHM Packages

Mon, 01 Jan 0001 00:00:00 +0000

Explains why the Package menu in Module Settings omits some WHM packages, caused by the reseller’s WHM quotas excluding them, with steps to confirm via WHM’s Create a New Account screen and fixes of increasing resources or enabling overselling.

Missing WHM Username Errors

Mon, 01 Jan 0001 00:00:00 +0000

Covers the “WHM Username is missing for the selected server” error caused by a server load-balancing misconfiguration, with the fix of checking the product configuration’s server selection.

MX and SPF Record Errors

Mon, 01 Jan 0001 00:00:00 +0000

Documents the Activity Log error that occurs when WHMCS cannot find a domain’s account or subscription on its cPanel, DirectAdmin, or Plesk server while updating MX and SPF records during MarketConnect OX App Suite provisioning, with steps to confirm the account or subscription exists on the correct server.

Nova Experience on cPanel

Mon, 01 Jan 0001 00:00:00 +0000

The Nova Experience on cPanel WHMCS module installs into modules/servers/nova/, optionally adds a Nova landing page via nova.php and nova.tpl, and handles suspend, unsuspend, terminate, and upgrade actions from WHMCS. Selling Nova requires a Nova server, a product group, and products for the Free, Nova Start, Nova Build, Nova Grow, and Nova Scale plans, with reCAPTCHA or hCaptcha enabled. nova_config.json sets the required freeProductId and groupId keys, and the Nova Partner Dashboard’s upgrade URL must point to the store’s nova.php endpoint. Documentation is available at https://docs.nova.webpros.com/en/partners/offer-nova-experience-on-cpanel/

OpenSSL Registrar Errors

Mon, 01 Jan 0001 00:00:00 +0000

Fixes Registrar Error and CURL Error 56 OpenSSL SSL_read messages caused by EasyApache 4 updates (2019-11-20 and 2020-4-1) on cPanel servers, via the workaround yum downgrade ea-libcurl ea-libcurl-devel plus an Apache restart, or by updating cURL and EasyApache 4 to a fixed version.

Package Not Allowed Errors

Mon, 01 Jan 0001 00:00:00 +0000

Documents “Package Not Allowed or Exceeded Resource/Account Allocation” caused by reseller-only access combined with an invalid package name, with the fix of matching WHM package names exactly.

Package Permission Errors

Mon, 01 Jan 0001 00:00:00 +0000

Covers “You do not have permission to use Selected Package” caused by a package name mismatch between WHMCS and WHM, with the fix of correcting the package name using the username_packagename format.

Product Attribute Errors

Mon, 01 Jan 0001 00:00:00 +0000

Documents “Product attribute Package Name XXX not found on server” caused by insufficient WHM resources, an incorrect package name, or insufficient API token permissions, with separate troubleshooting and fix steps for each cause.

Reseller Subdomain Errors

Mon, 01 Jan 0001 00:00:00 +0000

Covers “Resellers are not permitted to create subdomains of the server’s main domain” caused by a missing domain in the service configuration, with the fix of entering a domain and re-running Create.

Set Up Email Piping - cPanel

Mon, 01 Jan 0001 00:00:00 +0000

Steps through copying the pipe.php file path from WHMCS Support Departments settings, creating a cPanel email forwarder for the department’s address, and selecting Pipe to a Program under Advanced Options to route replies into the ticket system.

Username Reserved Errors

Mon, 01 Jan 0001 00:00:00 +0000

Documents “Sorry, that username is reserved” caused by a prohibited word, such as test, in the new account’s username, with the fix of changing the username.

wptoolkitcli Errors

Mon, 01 Jan 0001 00:00:00 +0000

Covers “Failed to load module WpToolkitCli” during WordPress hosting provisioning, caused by a missing WP Toolkit module on the cPanel & WHM server, with the fix of installing WP Toolkit.

Single Sign-On into WHMCS

Mon, 01 Jan 0001 00:00:00 +0000

Covers three single sign-on methods into WHMCS: supported applications like cPanel & WHM using application links, the CreateSsoToken API function for admin-level scripted token generation, and the OAuth Token API Endpoint flow requiring an OAuth Credential Set with the single sign-on grant type, plus a reference table of supported destination scopes such as clientarea:profile, clientarea:invoices, and clientarea:product_details with their variable inputs.

Add Sitejet Builder to cPanel Products

Mon, 01 Jan 0001 00:00:00 +0000

Gives step-by-step instructions in WHM’s Feature Manager for creating a new feature list that includes Sitejet Builder, assigning that feature list to a hosting package via Edit a Package, and verifying availability in WHMCS by checking for the Sitejet Included label in the Products/Services Features column or clicking Refresh Feature Status.

Bill Resellers Per Account

Mon, 01 Jan 0001 00:00:00 +0000

Walks through creating a Reseller Hosting product, selecting the cPanel module and WHM package, enabling the Sub-Accounts metric, and configuring Per Unit, Total Volume, or Quantity Included pricing for per-account reseller billing.

Configure the System Cron Job

Mon, 01 Jan 0001 00:00:00 +0000

Gives copy-paste cron command setup steps for cPanel Cron Jobs, Plesk Scheduled Tasks, DirectAdmin Cron Jobs, and manual crontab entries, including the */5 * * * * schedule and PHP binary paths for each control panel.

Configure Usage Billing

Mon, 01 Jan 0001 00:00:00 +0000

Walks through selecting the cPanel, DirectAdmin, or Plesk module on a product’s Module Settings tab, toggling a usage metric like bandwidth on, and configuring Per Unit, Total Volume, or Quantity Included pricing for that metric.

Create a Sitejet Builder Addon

Mon, 01 Jan 0001 00:00:00 +0000

States the required cPanel & WHM 116+ or Plesk 18.0.57+ server versions and gives the steps to add the predefined Sitejet Builder addon under Product Addons, select applicable products, and save.