MailBee.NET Objects  

Troubleshooting

Enabling Safe Mode

By default, MailBee tries to take advantage of extended capabilities offered by mail servers. However, sometimes these extended features might not work properly despite the fact the mail server claims it supports them. The common reason for this is network antivirus, firewall or mail filter which may intercept the traffic between the mail server and the client. If it does not support any features supported by the mail server itself, this may cause problems.

MailBee allows the developer to disable any advanced features. To disable them all at once, set MailBee.Global.SafeMode property to true before creating any instances or calling any methods of MailBee classes.

Logging the mail session into a file

Log file can be very useful for debugging any errors which occur during the session between the mail server and the client. Also, if you decided to contact our technical support for resolving the issue, you should also attach the log file. You can enable logging using Log property of any mailer component (including Smtp, Pop3 and Imap).

Testing with Microsoft Outlook Express

Often, the issue may be caused by your network configuration, not by the errors in the code. You should also try to do the same with Microsoft Outlook Express (OE). For instance, if you can't send a message, try to do the same with OE. But be sure to send from the same computer where you're using MailBee, using the same protocol and account settings (for instance, if the SMTP authentication is not used in MailBee, disable it in OE as well).

Even if the problem still does not get reproduced with OE, make sure your antivirus or firewall software (if any) does not treat OE in a special way. For instance, many security programs put OE on white list while unknown programs may get blocked.

Also, please note that you should test using Microsoft Outlook Express, not the full version (Microsoft Office Outlook). Microsoft Office Outlook can communicate with mail servers manufactured by Microsoft (such as Exchange) using internal protocols which are not supported by other software. As alternative to OE, you can also use Thunderbird.

Accessing mail on SSL-only servers like Gmail.com or Live.com

Many mail services today support only SSL connections with mail servers. In such cases, you should use SslMode property to enable SSL connections and use the appropriate SSL port number. Some servers allow you to use regular (not SSL) ports but change the regular connection into secure one during the already established connection with the mail server. This is called STARTTLS and such option can be set as one of values of SslMode property. However, neither Live.com nor Gmail.com support STARTTLS at the moment, so you should connect to SSL ports (995 for POP3, 993 for IMAP, 465 for SMTP). See below to read more on SSL issues.

Accessing mail on MS Exchange servers

Administrators often enable only MAPI access and no IMAP/POP3/SMTP as MS Outlook clients typically use MAPI and do not need IMAP or SMTP to connect to MS Exchange. Make sure SMTP, IMAP or POP3 are enabled and their respestive ports are opened if you have connectivity problems. Login errors often occur when the Exchange server expects the full login name ("domain\jdoe") or even "domain\jdoe\alias" to be supplied as a login name while you supplied just an account name ("jdoe"). Another issue with MS Exchange 2007 and above is that plain-text authentication may only work if you're on SSL connection (dedicated port or STARTTLS).

When sending e-mail through Exchange server, it may help to disable CHUNKING extension (especially if Exchange SMTP Tar Pitting is enabled). To disable CHUNKING (so that MailBee won't use BDAT command instead of DATA even if the server states BDAT is supported), use this code:

server.SmtpOptions = ExtendedSmtpOptions.NoChunking (server is SmtpServer object instance).

"Could not load type System.Byte from assembly MailBee.NET" error

You might be using MailBee.NET.dll for .NET 1.1 with a newer .NET framework. Use MailBee.NET.dll version optimized for .NET 2.0 and above.

If the above does not help, this often means .NET Framework installation is damaged. For instance, this occurs when SQL Server 2005 SP1 update gets installed, or on unsuccessful install of Visual Studio beta. The solution is to uninstall SQL Server 2005 SP1 or select Repair option in .NET Framework installer.

Typical problems

More troubleshooting tips

 


Send feedback to AfterLogic

Copyright © 2006-2012 AfterLogic Corporation. All rights reserved.