Guides & TutorialsTroubleshooting SimpleResolving Attention Items on the System Health Status Page

Resolving Attention Items on the System Health Status Page

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

Permissions Check

As a general rule, we suggest the following permissions:

  • Files have a CHMOD value of 644
  • Folders have a CHMOD value of 755

With the following exceptions

  • configuration.php CHMOD 400 Readable
  • /attachments CHMOD 777 Writeable
  • /downloads CHMOD 777 Writeable
  • /templates_c CHMOD 777 Writeable

The above applies unless your php is suPHP or PHPSuExec. If using DSO as your php handler, you must use 644 permissions.

Please work with your server admin/hosting provider to adjust the file permissions accordingly to resolve the message.

Display Errors

We recommend keeping the Display Errors option disabled during production use. It should only be enabled for the duration of troubleshooting. Please refer to this guide to switch it off.

We also recommend the following error_reporting setting in your server's PHP configuration:

E_ALL & ~E_WARNING & ~E_USER_WARNING & ~E_NOTICE & ~E_USER_NOTICE & ~E_STRICT & ~E_DEPRECATED & ~E_USER_DEPRECATED

You may need to contact your server admin/hosting provider to make this PHP configuration change.

Required PHP Extensions

WHMCS requires several PHP extensions to operate fully. Any required extensions for basic functionality which are detected to be missing are listed here.

We recommend recompiling PHP with the missing extensions added. You may need to contact your server admin/hosting provider to make these changes.

System Cron Tasks

This message indicates that the daily automation tasks have not completed in the past 24 hours. These automation tasks perform actions such as generating renewal invoices, sending payment reminders and suspending overdue services.

Refer to the following guide for assistance troubleshooting this message: Troubleshooting the cron not completing.

Pop Cron Ticket Import

This message indicates that you have entered POP3 mail server details into your support department configuration, but the /crons/pop.php script has not been triggered in the past hour.

As a result emails will not be imported from the mail boxes into the WHMCS support ticket system.

Ensure that a cron job is configured to trigger the pop.php file at 5 minute intervals. A sample cron command is located at Configuration > System Settings > Support Departments (Setup > Support > Support Departments in WHMCS 7.10 and earlier).

PHP Session Support

WHMCS examines common PHP settings which may affect the correct operation of session data. An error here may cause clients and admins to be logged out frequently.

PHP session support is disabled

PHP Sessions are a key part of WHMCS and is required to keep staff  and customers logged in. Seeing this error could be caused by a php .ini  configuration loaded with --disable-session specified, or some other technical problem.

Please work with your server admin/hosting provider to ensure that PHP Session support is enabled

Session autostart is enabled

WHMCS requires PHP session.auto_start to be disabled  in order to keep staff and customers logged in. Seeing this error could  be caused by a php .ini configuration loaded with  session.auto_start=On.

Please work with your server admin/hosting provider to ensure that PHP Session Auto Start is disabled.

The PHP Session save path is not writeable

To test the PHP session.save_path specified in your php.ini configuration is writable, WHMCS performs a simple check using the PHP is_writable function.

Encountering this error indicates that the is_writable function  cannot write to the specified session.save_path location. The path could  be invalid, the destination full, or myriad other causes.

Please work with your server admin/hosting provider to make the path  writable by PHP, or change the path to one which is writable.

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