Guides & TutorialsTroubleshootingSimpleResolving Warnings on the System Health Status Page

Resolving Warnings on the System Health Status Page

This page explains how to resolve some of the common warnings in Configuration > System Health (Help > System Health Status in WHMCS 7.10 and earlier).

Cron PHP Version Mismatch

Many server configurations utilize a separate php.ini file in the command line or cron engine than the web server uses. This can sometimes cause issues when different configurations are used in two places.

This warning identifies if automation tasks are being executed under different PHP versions to that being used to visit the admin area via a browser.

Please review this guide for step-by-step instructions to resolve this situation on a stock cPanel server:

Otherwise contact your server admin/hosting provider for assistance.

Once the PHP versions have been harmonized, the warning will disappear when the daily automation tasks are next performed (as defined in Configuration > System Settings > Automation Settings > Time of Day, or Setup > Automation Settings > Time of Day in WHMCS 7.10 and earlier).

Cron PHP Timezone

Many server configurations utilize a separate php.ini file in the command line or cron engine than the web server uses. This can sometimes cause issues when different configurations are used in two places.

This warning identifies if automation tasks are being executed under a different timezone to that being used to visit the admin area via a browser.

Please review this guide for step-by-step instructions to resolve this situation on a stock cPanel server:

Otherwise contact your server admin/hosting provider for assistance.

Once the timezones have been harmonized, the warning will disappear when the daily automation tasks are next performed (as defined in Configuration > System Settings > Automation Settings > Time of Day, or Setup > Automation Settings > Time of Day in WHMCS 7.10 and earlier).

Website SSL

WHMCS is not configured with a System URL with the https:// protocol.

Once a certificate has been installed on the website, follow these steps to use it:

  1. Navigate to Configuration > System Settings > General Settings
  2. In the General tab locate the System URL setting
  3. Change the value so that it's prefixed with https://
  4. Click Save Changes

Eg. https://example.com/whmcs/

Certificate Authority Verified SSL Not Detected on this Server

The validity of the SSL certificate installed on the WHMCS domain is checked by way of a cURL call to the WHMCS System URL:

curl -I https://example.com 

Any response code other than 200 will produce this error on the Health Status page.

Please work with your server admin/hosting provider to ensure that a 200 response code is returned.

cURL/TLS/OpenSSL Version Warnings

At the time of writing, the System Health Status page checks for the following minimum versions:

cURL: 7.36.0

TLS: 1.1 and 1.2

OpenSSL: 1.0.1c

We recommend running the latest versions supported by your environment. Please work with your server admin/hosting provider to update them if possible.

PHP Version

Whenever possible, it is usually preferable to utilize a version of PHP that is under active development.

Refer to our System Environment Guide to determine the latest version of PHP compatible with your WHMCS software version.

You may need to contact your hosting provider for assistance upgrading the PHP version for your website.

 

PHP 8.1 Support

We recommend that you use PHP 7.4 with WHMCS 8.0 through WHMCS 8.5. PHP 7.4 receives Security Support from the PHP maintainers until 28th November 2022.

We added support for PHP 8.1 in WHMCS 8.6 and recommend it for WHMCS 8.6 and later.

Due to ionCube Loader's lack of support for PHP 8.0, we do not plan to add PHP 8.0 support to WHMCS.

Automatic Update Requirements

The WHMCS automatic update tool allows you to apply new software updates in just a few clicks. This test makes sure your system meets the requirements to use the auto update tool.

Navigate to Utilities > Update WHMCS and click Configure Update Settings to enter the path of a writeable directory for storing temporary files during the update process. More information.

Custom Templates

This check identifies any stock system theme or order form template names in use. If you have not made any customisations to these then this warning can be safely ignored.

If you have made system theme or order form template customisations, we recommend creating a copy of the stock system theme or order form template and then making your customisations to that copy instead. This way your customisations will remain in place when updating. More information.

To select your system theme, use the System Theme setting. You can find this in the General tab at Configuration > System Settings > General Settings, or Setup > General Settings in WHMCS 7.10 and earlier.

To select your default order form template, use the Order Form Template setting in the Ordering tab at Configuration > System Settings > General Settings, or Setup > General Settings in WHMCS 7.10 and earlier.

CloudLinux MySQL Extension Check

This check provides a warning for CloudLinux™ users who currently use the pdo_mysql PHP extension. This extension can cause display issues and other problems within the WHMCS interface.

To resolve this problem, use the CloudLinux PHP Selector to enable the nd_pdo_mysql PHP extension instead:

  1. Access the CloudLinux PHP Configuration interface on your server.
  2. Deselect the pdo_mysql option.
  3. Select the nd_pdo_mysql option:
Enable nd_pdo_mysql option

The change should be immediately applied and the warning removed upon reloading the System Health Status page. For help, see CloudLinux's PHP Selector documentation or contact your server administrator.

For other server stacks, please consult with your server admin/hosting provider to recompile PHP with the native driver.

MySQL Server Configuration Check

WHMCS requires a connection to the MySQL database to operate fully, and for it to remain open when performing some taxing tasks. This test makes sure your system meets our suggested minimums to operate without encountering issues manipulating the database.

We recommend adjusting your MySQL server's configuration file to increase the values which the test flags as potentially too low. 

How to edit the MySQL/MariaDB configuration (my.cnf) file

Source: cPanel

You may need to contact your server admin/hosting provider to make these changes.

Support Ticket Mask Check

Each support ticket is assigned a unique reference number. The numbering sequence could potentially be customized in such a way that limits the potential combination of unqie ticket numbers. This test will estimate the total number of possible ticket number combinations provided by your Support Ticket Mask Format setting.

  • A Warning is displayed when 51% - 85% of possible ticket number combinations have been used.
  • An Attention Item is displayed when 85% or more of estimated ticket ticket number combinations have been used.

We recommend adjusting your Support Ticket Mask Format setting to increase the number of possible ticket number combinations. For example by adding an extra number mask; %n