FAQ: Inbound Email - Setup Issues [v1.1] - Moved Scheduler setup to Scheduler FAQ

[sugarchris]

Inbound Email is a complicated piece of work to get setup! This F.A.Q. will serve as a stop-gap measure until our full documentation is rolled out. I will add to this as issues come up. Please feel free to respond to this thread with the issues or solutions you encounter.

Thanks! [v1.0b] non-standard port info

SETUP ISSUES

I setup a mailbox and I don't get any mail!
This could be the result of a number of problems. Please make sure the following are working:

1. crontab or Windows Scheduled Tasks has a job and is running them.
2. if using the PHP CLI/CGI binary, make sure it's in the path of the user it is running as. In Linux, it will be the Apache user (typically "nobody" or "apache").
3. you get a non-error result when clicking "Test Settings" in the Mailbox setup screen
4. Your Sugar instance is running on a port other than 80. - this will be addressed in the next patch!
5. Sugar is running in a secure environment and cron.php is failing!

Gotta love having the source code--problem solved.

In case anyone else has this issue: it had to do with the SSL certificate I use on my server. I use a FreeSSL certificate, which is loaded into nearly all browsers--but not, apparently, into Curl, which the scheduler uses to fire off jobs. Curl was getting an SSL verification error when it tried to fire individual jobs.

I solved it by editing modules/SchedulersJobs/SchedulersJobs.php and adding this line at the end of the list of curl_setopt()s, on line 168:

 curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); 
  

Error Message: Fatal error: Call to undefined function: curl_init() OR some other cURL failure
Linux: Recompile Time!

Windows: Time to edit your php.ini file

If using one the many precompiled Windows stacks (such as WAMP, XAMPP, etc.), all the extensions are compiled and shipped with the core module but disabled in your php.ini file. Installations will almost always differ where that file is kept; to figure out exactly where it is, create a phpinfo.pihp file:

 <?php phpinfo(); ?>  

Save it somewhere in your htdocs folder and use a browser to view the output. Search for php.ini and it will show the path to the file you want to edit.

In any text editor, search for ";extension=php_curl.dll". Remove the semi-colon from the beginning of the string. If not found, add it yourself (minus the semi-colon of course).

Save and close.

RESTART your apache server - it will NOT dynamically load this extension.

Error Message: This system does not have the IMAP c-client libraries enabled/compiled into the PHP module

InboundEmail absolutely requires that the IMAP extension be available to the PHP module. There are no ways around this issue save fulfilling the requirement. If your host does not provide this for you, contact their system administrators and ask that this be done. If you have access to your own server, either recompile PHP with the IMAP extension, or find a stack install (WAMP, XAMPP, etc) that has the IMAP extension available for your platform.

If you need to recompile your apache module, following these directions:

To enable IMAP support on your PHP installation you need to compile PHP with the --with-imap argument. You also need to download the IMAP library here. Once you've downloaded it, copy c-client/c-client.a to /usr/local/lib/libc-client.a. Also copy c-client/rfc822.h, mail.h and linkage.h to /usr/local/include or some other directory in your include path.

The above was taken from a post here: devarticles.com. What the above DOESN'T tell you is which file to download and extract! As of Dec 18, 2005, the file you want is imap-2004c.tar.Z. The c-client folder mentioned in the above quote is in that archive.

One more important point: notice that the name of the first file, c-client.a is being changed to libc-client.a. This last tripped me up a few times in the past .

[itsskin]

Hello, dear ALL!
Just have some problems with getting e-mail. I do setup everything correct, and when I press TEST button, i just have "INBOX" message in the pop-up window. So, no mail is downloaded... Win XP SP2 XAMMP Appache,

[sugarchris]

If the test succeeds, but you don't get any inbounds, it's due to the scheduled jobs not polling. Did you setup a crontab entry? or Scheduled Task in windows?

[itsskin]

I see now, where is the problem, because cron jobs are not running properly on my machine. Even when I create .bat file with cd,,,,,, php,exe -d cron.php I have errors, like "curl_init() call to undefined function" But I`m shure, that curl is enabled in php config, and I can see it in php info. So, i tried to call cron.php from my browser. I that case i do not have errors, but that`s not proper way to run cron jobs I think...

[peterva]

If the test succeeds, but you don't get any inbounds, it's due to the scheduled jobs not polling. Did you setup a crontab entry? or Scheduled Task in windows?

I have the same problem. But what on earth is a crontab entry and how do you set one up?

[itsskin]

Ok, I think we need some pro guide how to create cron jobs with bat files in Win,

[bretvenuso]

I set a .bat to run the cron.php and i am getting this error:

Warning: main(data/SugarBean.php): failed to open stream: No such file or directory in G:\xampp\xampp\htdocs\CRM\modules\Schedulers\Sched ulerDaemon.php on line
30

Fatal error: main(): Failed opening required 'data/SugarBean.php' (include_path='.;g:\xampp\xampp\php\pear\') in G:\xampp\xampp\htdocs\CRM\modules\Schedulers\Sched ulerDaemon.php on line 30

I can only capture this when i run it in a cmd prompt. The directory does exist with the file in place.
I have set up XAMPP with the php switch to php 4x. I enabled imap and curl.
My test on the email works great with imap.

Anyone?
Thanks

[nmpaulcp]

Hi, I am trying to get my incoming email setupand encountered the message described it the first post here.

Error Message: This system does not have the IMAP c-client libraries enabled/compiled into the PHP module
InboundEmail absolutely requires that the IMAP extension be available to the PHP module. There are no ways around this issue save fulfilling the requirement. If your host does not provide this for you, contact their system administrators and ask that this be done. If you have access to your own server, either recompile PHP with the IMAP extension, or find a stack install (WAMP, XAMPP, etc) that has the IMAP extension available for your platform.

I have access to my server and am trying to educate myself on the entire Sugar setup including php MYSQL and Apache Can someone point me to a tutorial or some direction on resolving the issue I quoted above? Or should I look to another solution such as Zuckermail?
Thanks, Paul

[sugarchris]

Updated FAQ to include some basic guidance on setting up a crontab or Windows Schduled Task.

I'll try to scare up some info on how-to compile IMAP into PHP. The issue with cURL libraries is also a recompile issue.

[nmpaulcp]

Updated FAQ to include some basic guidance on setting up a crontab or Windows Schduled Task.

I'll try to scare up some info on how-to compile IMAP into PHP. The issue with cURL libraries is also a recompile issue.

Thanks Chris