Troubleshooting

If you run into troubles with DF/Manager, there are a number of things to do.

Version checks

Check to verify you have the latest version of DF/Manager installed. Also check the version of CakePHP, PHP and MySQL. You can find the versions in the admin Server status page. 

Check your server meets the system requirements.

Debug mode

In normal production mode, DF/Manager hides many warning and error messages from the visitors. For security and performance reason, this is a good thing. But when trying to solve problems, more information might be needed. For this, debug mode is available. In debug mode, all warnings and error messages get printed to the screen.

Turn ON

To enable debug mode, do the following:

  • Open /app/config/core.php
  • Change the line 
  • Configure::write('debug', 0); 
  • to 
  • Configure::write('debug', 1);
  • Save and upload the file.

Turn OFF

To disable debug mode, open /app/config/core.php again and set Configure::write('debug', 0);

It is highly recommended to turn debug mode OFF in production environments!

PHP 5.3

When using PHP version 5.3 or higher, you need to make a small change to /app/config/core.php. The line

//date_default_timezone_set('UTC');

needs to be uncommented, the 2 slashes (//) need to be removed.

Database errors

SQL Error: 2006: MySQL server has gone away

When importing very large feeds, or when importing a large number of feeds in a cron job, a SQL Error: 2006: MySQL server has gone away error can sometimes occur.The error is caused by imports taking too much time. This time varies from server to server, but it is a clear indication that you have reached the limits of your hosting environment. If you have access to your server you can try to increase the execute time for MySQL queries. If you don't have this option, you need to make sure the imports run as fast as possible.

Performance tips

Some tips to help you get maximum performance from your DF/Manager installation:

  • Limit the number of filters per feed to the bare minimum
  • Set the Max insert grouping (feed page) to something between 10 and 100. Experiment to find which value works best for you.
  • Set the Import download method in your Configuration page to WGET. Usually you want to set this to CURL, which is more versatile, but slightly slower. WGET does require more user privileges and may not be available on all hosting environments.
  • Limit the number of feeds to what you really need