davmail/src/site/xdoc/faq.xml

135 lines
6.5 KiB
XML

<?xml version="1.0"?>
<document xmlns="http://maven.apache.org/XDOC/2.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd">
<properties>
<title>DavMail POP/IMAP/SMTP/CalDav/LDAP Exchange Gateway - Frequently asked questions</title>
<author email="mguessan@free.fr">Mickael Guessant</author>
</properties>
<body>
<section name="Frequently asked questions">
<p>Frequently asked questions on DavMail forums, mailing list or direct email.
</p>
<subsection name="Feedback">
<p>
<strong>How do I create a WIRE debug log ?</strong>
</p>
<p>In DavMail trackers and forums, I often ask for a WIRE debug log. To create this
log file, you will need to change DavMail settings under the advanced tab.
Set the WIRE logging category to DEBUG level.
</p>
<p>You can then reproduce you issue and send the log file to
<a href="mailto:mguessan@free.fr">mguessan@free.fr</a>
</p>
<p>The davmail.log file is available in DavMail working directory on Unix and Windows,
~/Library/Logs/DavMail/davmail.log on OSX. This default path can be customized with
the
<code>Log File Path</code>
setting.
</p>
</subsection>
<subsection name="General">
<p>
<strong>Authentication fails with invalid user or password message</strong>
</p>
<p>Authentication fails with the following message:
<code>Authentication failed: invalid user or password, retry with domain\user</code>
</p>
<p>Exchange before 2007 expects domain qualified user name, you may not have
to provide the domain name on the logon form if javascript is used to add it,
but DavMail can not execute javascript. Thus you need to prefix your user name
with the Active Directory domain followed by \
</p>
<p>
<strong>Authentication fails with error in parsing the status line</strong>
</p>
<p>Authentication fails with the following message:
<code>error in parsing the status line from the response: unable to find line starting with "HTTP"
</code>
</p>
<p>Your Exchange server expects HTTPS (secured) connections, use https instead of http in
OWA url.
</p>
</subsection>
<subsection name="Caldav (calendar)">
<p>
<strong>How do I detect errors in Thunderbird/Lightning calendar ?</strong>
</p>
<p>Unfortunately, Lightning does not provide much feedback of what is going
on. To detect errors at this level, you may activate calendar log settings
under Tools/Options/Advanced:
</p>
<source>
calendar.debug.log=true
calendar.debug.log.verbose=true</source>
<p>
<strong>Invalid notifications</strong>
</p>
<p>Lightning 0.9 mail notifications are broken, activate
Caldav notifications to outbox instead:
</p>
<p>Check the following parameter in Thunderbird, it should be set
to true
</p>
<source>calendar.caldav.sched.enabled=true</source>
</subsection>
<subsection name="Build">
<p>
<strong>How to build DavMail ?</strong>
</p>
<p>Building DavMail is quite simple:</p>
<ul>
<li>Make sure you have Java 6 installed and set as current version by checking
JAVA_HOME:
<br/>
<ul>
<li>Unix/OSX:
<source>echo $JAVA_HOME</source>
</li>
<li>Windows:
<source>echo %JAVA_HOME%</source>
</li>
</ul>
</li>
<li>Download and unzip ant from<a href="http://ant.apache.org/">ant.apache.org</a>,
add ant/bin full path to the PATH environment variable
</li>
<li>Get DavMail source package from sourceforge and uncompress it:
<source>tar xvzf davmail-src-*.tgz</source>
<br/>
or checkout trunk:
<source>svn co http://davmail.svn.sourceforge.net/svnroot/davmail/trunk</source>
<br/>
or get and uncompress tarball from
<a href="http://davmail.svn.sourceforge.net/viewvc/davmail/trunk">
http://davmail.svn.sourceforge.net/viewvc/davmail/trunk
</a>
</li>
<li>Additional step on Windows: Download and install NSIS from
<a href="http://nsis.sourceforge.net">http://nsis.sourceforge.net</a>.
Then get KillProcess plugin from
<a href="http://www.esanu.name/software/index.php/nsis-kill-process/">
http://www.esanu.name/software/index.php/nsis-kill-process/
</a>
or the nsis directory in DavMail source. Copy the processwork.dll
library to NSIS plugin directory.
</li>
<li>Go into davmail directory root directory (which contains the build.xml file) and
type:
<source>ant</source>
</li>
</ul>
<p>Packages are then available under dist
</p>
</subsection>
</section>
</body>
</document>