davmail/src/site/xdoc/gettingstarted.xml

207 lines
8.8 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/Carddav/LDAP Exchange Gateway - Getting started</title>
<author email="mguessan@free.fr">Mickael Guessant</author>
</properties>
<body>
<section name="DavMail configuration">
<p>In order to change DavMail settings, double click on the tray icon or
right click on it and choose
<code>Settings...</code>
</p>
<div style="width: 100%;text-align: center">
<img src="images/davmailSettings.png" alt=""/>
</div>
<p>The following table describes the main and advanced options :</p>
<table>
<tr>
<th>Parameter</th>
<th>Description</th>
<th>Sample value</th>
</tr>
<tr>
<td>OWA url</td>
<td>Outlook Web Access URL to access the exchange server, i.e. the base webmail URL
<br/>
Note: use /owa/ path for Exchange 2007, /exchange/ for older versions
</td>
<td>http://exchangeServer/owa/</td>
</tr>
<tr>
<td>Local POP port</td>
<td>Local POP server port to configure in POP client</td>
<td>110</td>
</tr>
<tr>
<td>Local IMAP port</td>
<td>Local IMAP server port to configure in IMAP client</td>
<td>143</td>
</tr>
<tr>
<td>Local SMTP port</td>
<td>Local SMTP server port to configure in POP client</td>
<td>25</td>
</tr>
<tr>
<td>Local Caldav HTTP port</td>
<td>Local Caldav server port to configure in Caldav (calendar) client</td>
<td>80</td>
</tr>
<tr>
<td>Local LDAP port</td>
<td>Local LDAP server port to configure in directory (addresse book) client</td>
<td>389</td>
</tr>
<tr>
<td>Keep Delay (POP)</td>
<td>Number of days to keep messages in Exchange trash folder before actual deletion,
only for POP service
</td>
<td>30</td>
</tr>
<tr>
<td>Sent Keep Delay (POP)</td>
<td>Number of days to keep sent messages in Exchange sent folder,
only for POP service</td>
<td>90</td>
</tr>
<tr>
<td>Calendar past events (Caldav)</td>
<td>Get events in the past not older than specified days count, leave empty for no limits</td>
<td>90</td>
</tr>
<tr>
<td>IDLE folder monitor delay (IMAP):</td>
<td>IMAP folder idle monitor delay in minutes, leave empty to disable IDLE support</td>
<td>1</td>
</tr>
<tr>
<td>Allow remote connections</td>
<td>Allow remote connections to the gateway (server mode)</td>
<td>false</td>
</tr>
<tr>
<td>Force Active Sync update</td>
<td>Use double event update to trigger ActiveSync mobile phones sync</td>
<td>false</td>
</tr>
<tr>
<td>IMAP auto expunge</td>
<td>Delete messages immediately on the server over IMAP</td>
<td>true</td>
</tr>
<tr>
<td>Display startup banner</td>
<td>Whether to show the initial startup notification window or not</td>
<td>true</td>
</tr>
<tr>
<td>Caldav alarm sound</td>
<td>Convert Caldav alarm to sound alarm supported by iCal, e.g. Basso. Leave empty for no
conversion
</td>
<td>Basso</td>
</tr>
<tr>
<td>Default domain</td>
<td>Default windows domain name</td>
<td>DOMAIN</td>
</tr>
<tr>
<td>Key store type</td>
<td>To encrypt communication between client and DavMail, create a server certificate,
choose key store type and set key store path
</td>
<td>JKS</td>
</tr>
<tr>
<td>Key store</td>
<td>SSL certificate key store file path</td>
<td>path/to/keystore</td>
</tr>
<tr>
<td>Key store password</td>
<td>Key store password</td>
<td>password</td>
</tr>
<tr>
<td>Key password</td>
<td>SSL key password inside key store</td>
<td>password</td>
</tr>
<tr>
<td>Client key store type</td>
<td>When the Exchange server requires mutual authentication,
choose client certificate key store type, PKCS11 for smartcard,
PKCS12 or JKS for certificate file
</td>
<td>PKCS11</td>
</tr>
<tr>
<td>Client key store</td>
<td>SSL client certificate key store file path</td>
<td>path/to/keystore</td>
</tr>
<tr>
<td>Client key store password</td>
<td>Client key store password, leave empty for runtime prompt</td>
<td>password</td>
</tr>
<tr>
<td>PKCS11 library</td>
<td>PKCS11 (smartcard) library path (.so or .dll)</td>
<td>softokn3.dll</td>
</tr>
<tr>
<td>PKCS11 config</td>
<td>Optional additional PKCS11 settings (slot, nssArgs, ...)</td>
<td>slot=2</td>
</tr>
<tr>
<td>Bind Address</td>
<td>Bind only to the specified network address</td>
<td>10.0.1.2</td>
</tr>
<tr>
<td>Server certificate hash</td>
<td>Manually accepted server certificate hash, contains the SHA1 hash of
a manually accepted certificate (invalid or self signed)
</td>
<td>9F:CC:59:82:1F:C:CD:29:7C:70:F0:D8:37:B1:77:3F:48:84:AE:C4</td>
</tr>
<tr>
<td>Disable update check</td>
<td>Disable DavMail check for new version</td>
<td>false</td>
</tr>
<tr>
<td>Logging levels</td>
<td>Default, DavMail and HttpClient logging levels, see Log4J documentation for more details
</td>
<td>WARN</td>
</tr>
<tr>
<td>Log file Path</td>
<td>DavMail log file path (default is davmail.log in working directory on Unix and Windows,
~/Library/Logs/DavMail/davmail.log on OSX)
</td>
<td>davmail.log</td>
</tr>
</table>
<p>Uncheck a port to disable matching service.</p>
<p>Activate panel under Proxy tab to set an HTTP proxy and associated credentials if needed</p>
<p>Proceed to
<a href="thunderbirdmailsetup.html">Thunderbird mail setup</a>
or
<a href="osxicalsetup.html">OSX iCal setup</a>
</p>
</section>
</body>
</document>