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).
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.
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.
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.
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.
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).
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.