Guides & TutorialsTroubleshooting SimpleResolving 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).

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.

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.