Sugar Community Edition Installation and ... - SugarForge

SystemTroubleshooting TipsLinux1. The Sugar Scheduler fails to run even though the cron.log file shows that thecrontab is triggering the new job. The Apache user's PATH does not include the location of the PHP binary.• Change the crontab entry to include the FULL path to the PHP binary asshown below:* * * * * /usr/local/bin/php -f cron.php > /dev/null 2>&1 The Apache user's PATH does not include the location of the php.ini file, andthus the external libraries (such as mod_mysql and mod_imap) are unavailableat run time.• Change the crontab entry to include a PHP switch to explicitly define aphp.ini to use as shown below.* * * * * php -c /path/to/your/php.ini -f cron.php> /dev/null 2>&1"2. No PHP binary found or it is broken. Change the mechanism by which your cronjob calls Sugar's cron.php.• Determine if this is an option at this time by finding either “curl” or“wget” on your system. This is done with the commands “which curl” and“which wget”.If you use cURL, your crontab entry should look as follows:* * * * * curl --silent http://yourdomain/yoursugarcrminstance/cron.phpIf you use wget, your crontab entry should look like:* * * * * wget -q http://yourdomain/yoursugarcrminstance/cron.phpNote:Both curl and wget have numerous switches that do not always map todifferent versions on different platforms. Experiment in the terminal untilyou find the “perfect” line, and add it as the line for your crontab entry.Windows.1. The most common problem is that the PHP binary does not have the properlibraries available at run time. As a result, it cannot make calls to your database orto your Email server. To force PHP to be aware of these libraries, it needs toaccess the php.ini file, which in turn tells it where to find everything that isavailable.a. Locate the php.ini file: if you are unsure, run the following command:phpinfo();The system identifies the php.ini file and its location.2. The second most common breakage is incorrect paths to the extensions that PHPneeds; a map is useless if the information is bad.Sugar Community Edition Installation and Administration Guide35