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 on the Help > System Health Status page.

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 on the Setup > Support > Support Departments page