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

Resolving Attention Items on the System Health Status Page

Use the steps below to resolve some of the Needing Attention warnings in Configuration > System Health (Help > System Health Status in WHMCS 7.10 and earlier).

Permissions Check

This check ensures that important WHMCS files and directories have the appropriate permissions.

We recommend specific permissions for files and directories on most WHMCS installations.

  • Work with your hosting provider or system administrator to adjust the file permissions and resolve the message.
  • For a list of the recommended directories, see our System Health Status documentation.

Error Reporting

This check warns you if Display Errors is enabled in the Other tab at Configuration > System Settings > General Settings (Setup > General Settings prior to WHMCS 8.0). For security reasons, we strongly recommend that you only enable this option while you are actively troubleshooting an issue.

We also recommend that you add 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

For help with making this PHP configuration change, contact your hosting provider or system administrator.

Required PHP Extensions

WHMCS requires several PHP extensions for its basic functionality. This check displays any missing extensions.

For help with adding the missing extensions to your PHP configuration and recompiling PHP, contact your hosting provider or system administrator.

System Cron Tasks

This check displays any daily automation tasks did not complete in the past 24 hours. Several different cron issues can cause this.

For help to troubleshoot this issue, see Verify the System Cron is Completing.

POP Cron Ticket Import

This check displays whether you have an issue in which POP3 mail server details exist in your support department configuration but the system has not run the /crons/pop.php script in the past hour.

Due to this issue, the system will not import email from the POP3 mail server into the WHMCS support ticket system.

To resolve this issue, configure a cron job to run the /crons/pop.php script at five-minute intervals. You can find a sample cron command at Configuration > System Settings > Support Departments (Setup > Support > Support Departments in WHMCS 7.10 and earlier).

PHP Session Support

This check displays common issues with your PHP environment's session configuration. PHP sessions are a vital part of WHMCS and allow admins and users to stay logged in.

Session autostart is enabled

WHMCS requires that you disable session.auto_start in order to keep admins and users logged in. You may see this error if your php.ini configuration includes session.auto_start=On.

For help with resolving this issue, contact your hosting provider or system administrator.

PHP session support is disabled

You may see this error if your php.ini configuration includes --disable-session. It may also indicate other technical problems.

For help with resolving this issue, contact your hosting provider or system administrator.

The PHP Session save path is not writeable

This check tests whether the session.save_path value in your php.ini configuration is writeable. To do this, it uses the PHP is_writable function.

If you see this warning, the is_writable function cannot write to the specified session.save_path location. Causes for this include invalid paths, a full destination, or other issues.

For help with resolving this issue, contact your hosting provider or system administrator.

Support Ticket Mask Check

WHMCS assigns a unique, customizable reference number to each support ticket. Depending on how you customize this reference number, you may inadvertently limit the possible number of ticket numbers.

This check estimates the total number of possible ticket number combinations according to your Support Ticket Mask Format setting in the Support tab at Configuration > System Settings > General Settings.

  • A warning displays when your installation has used 51% to 85% of possible ticket number combinations.
  • A Needing Attention item displays when your installation has used 85% or more of possible ticket number combinations.

We recommend adjusting Support Ticket Mask Format to increase the number of possible ticket number combinations.