You are viewing a plain text version of this content. The canonical link for it is here.
Posted to server-dev@james.apache.org by ch...@apache.org on 2001/05/21 15:25:15 UTC
cvs commit: jakarta-james/www architecture_v1_2.html configuration_v1_2.html listservs.html usingLDAP_v1_2.html usingTLS_v1_2.html usingTown.html code-standards.html commandsIMAP.html index.html install.html license.html matchers.html todo.html configuration.html developer.html mailets.html usingDatabaseRepository.html usingLDAP.html usingTLS.html
charlesb 01/05/21 06:25:14
Modified: src/xdocs/stylesheets project.xml
www code-standards.html commandsIMAP.html index.html
install.html license.html matchers.html todo.html
Added: www architecture_v1_2.html configuration_v1_2.html
listservs.html usingLDAP_v1_2.html
usingTLS_v1_2.html usingTown.html
Removed: www configuration.html developer.html mailets.html
usingDatabaseRepository.html usingLDAP.html
usingTLS.html
Log:
Updating www docs
Revision Changes Path
1.3 +2 -2 jakarta-james/src/xdocs/stylesheets/project.xml
Index: project.xml
===================================================================
RCS file: /home/cvs/jakarta-james/src/xdocs/stylesheets/project.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- project.xml 2001/05/21 12:13:25 1.2
+++ project.xml 2001/05/21 13:24:41 1.3
@@ -30,11 +30,11 @@
<!-- <item name="Bundled Mailets" href="/mailet_list.html"/> -->
<item name="List Servers" href="/listservs.html"/>
<item name="Bundled Matchers" href="/matchers.html"/>
- <item name="Useful RFCs" href="http://jakarta.apache.org/james/rfclist"/>
+ <item name="Useful RFCs {web}" href="http://jakarta.apache.org/james/rfclist"/>
</menu>
- <menu name="Get Involved">
+ <menu name="Get Involved {web}">
<item name="Overview" href="/site/getinvolved.html"/>
<item name="CVS Repositories" href="/site/cvsindex.html"/>
<item name="Mailing Lists" href="/site/mail.html"/>
1.2 +60 -5 jakarta-james/www/code-standards.html
Index: code-standards.html
===================================================================
RCS file: /home/cvs/jakarta-james/www/code-standards.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- code-standards.html 2001/05/17 16:50:20 1.1
+++ code-standards.html 2001/05/21 13:24:48 1.2
@@ -14,7 +14,7 @@
<meta name="author" value="Serge Knystautas">
<meta name="email" value="sergek@lokitech.com">
- <title>The Jakarta Site - Coding Standards</title>
+ <title>The Jakarta James Site - Coding Standards</title>
</head>
<body bgcolor="#ffffff" text="#000000" link="#525D76">
@@ -37,14 +37,16 @@
<tr>
<!-- LEFT SIDE NAVIGATION -->
<td valign="top" nowrap="true">
- <p><strong>About</strong></p>
+ <p><strong>James</strong></p>
<ul>
<li> <a href="./index.html">Overview</a>
</li>
<li> <a href="./install.html">Install</a>
</li>
- <li> <a href="./mailets.html">Mailets Concept</a>
+ <li> <a href="./configuration_v1_2.html">Configuration</a>
</li>
+ <li> <a href="./architecture_v1_2.html">Architecture</a>
+</li>
<li> <a href="./code-standards.html">Coding Standards</a>
</li>
<li> <a href="./license.html">License</a>
@@ -52,11 +54,61 @@
<li> <a href="./todo.html">TODO</a>
</li>
</ul>
+ <p><strong>Download</strong></p>
+ <ul>
+ <li> <a href="http://jakarta.apache.org/site/binindex.html">Binaries</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/sourceindex.html">Source Code</a>
+</li>
+ </ul>
<p><strong>Guides</strong></p>
+ <ul>
+ <li> <a href="./mailet/index.html">Mailet API</a>
+</li>
+ <li> <a href="./usingLDAP_v1_2.html">Using LDAP</a>
+</li>
+ <li> <a href="./usingTown.html">Using RDBMS</a>
+</li>
+ <li> <a href="./usingTLS_v1_2.html">Using TLS</a>
+</li>
+ <li> <a href="./listservs.html">List Servers</a>
+</li>
+ <li> <a href="./matchers.html">Bundled Matchers</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/james/rfclist">Useful RFCs {web}</a>
+</li>
+ </ul>
+ <p><strong>Get Involved {web}</strong></p>
+ <ul>
+ <li> <a href="http://jakarta.apache.org/site/getinvolved.html">Overview</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/cvsindex.html">CVS Repositories</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/library.html">Reference Library</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/bugs.html">Bug Database</a>
+</li>
+ </ul>
+ <p><strong>Jakarta Essentials {web}</strong></p>
+ <ul>
+ <li> <a href="http://jakarta.apache.org/index.html">Front Page</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/news.html">News & Status</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/mission.html">Mission</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/guidelines.html">Guidelines Notes</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/faqs.html">FAQs</a>
+</li>
+ </ul>
+ <p><strong>Related Projects {web}</strong></p>
<ul>
- <li> <a href="./javadoc/mailet/index.html">Mailet API</a>
+ <li> <a href="http://jakarta.apache.org/ant/index.html">Ant</a>
</li>
- <li> <a href="./usingLDAP.html">Using LDAP</a>
+ <li> <a href="http://jakarta.apache.org/avalon/index.html">Avalon</a>
</li>
</ul>
</td>
@@ -67,6 +119,7 @@
<a name="Coding Standards"><strong>Coding Standards</strong></a>
</font>
</td></tr>
+ <tr><td><br/></td></tr>
<tr><td>
<blockquote>
<p>
@@ -124,7 +177,9 @@
at the top of every file.
</p>
</blockquote>
+ </p>
</td></tr>
+ <tr><td><br/></td></tr>
</table>
</td>
</tr>
1.2 +66 -5 jakarta-james/www/commandsIMAP.html
Index: commandsIMAP.html
===================================================================
RCS file: /home/cvs/jakarta-james/www/commandsIMAP.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- commandsIMAP.html 2001/05/17 16:50:21 1.1
+++ commandsIMAP.html 2001/05/21 13:24:49 1.2
@@ -14,7 +14,7 @@
<meta name="author" value="Charles Benett">
<meta name="email" value="charles@benett1.demon.co.uk">
- <title>The Jakarta Site - Java Apache Mail Enterprise Server</title>
+ <title>The Jakarta James Site - Java Apache Mail Enterprise Server</title>
</head>
<body bgcolor="#ffffff" text="#000000" link="#525D76">
@@ -37,14 +37,16 @@
<tr>
<!-- LEFT SIDE NAVIGATION -->
<td valign="top" nowrap="true">
- <p><strong>About</strong></p>
+ <p><strong>James</strong></p>
<ul>
<li> <a href="./index.html">Overview</a>
</li>
<li> <a href="./install.html">Install</a>
</li>
- <li> <a href="./mailets.html">Mailets Concept</a>
+ <li> <a href="./configuration_v1_2.html">Configuration</a>
</li>
+ <li> <a href="./architecture_v1_2.html">Architecture</a>
+</li>
<li> <a href="./code-standards.html">Coding Standards</a>
</li>
<li> <a href="./license.html">License</a>
@@ -52,11 +54,61 @@
<li> <a href="./todo.html">TODO</a>
</li>
</ul>
+ <p><strong>Download</strong></p>
+ <ul>
+ <li> <a href="http://jakarta.apache.org/site/binindex.html">Binaries</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/sourceindex.html">Source Code</a>
+</li>
+ </ul>
<p><strong>Guides</strong></p>
+ <ul>
+ <li> <a href="./mailet/index.html">Mailet API</a>
+</li>
+ <li> <a href="./usingLDAP_v1_2.html">Using LDAP</a>
+</li>
+ <li> <a href="./usingTown.html">Using RDBMS</a>
+</li>
+ <li> <a href="./usingTLS_v1_2.html">Using TLS</a>
+</li>
+ <li> <a href="./listservs.html">List Servers</a>
+</li>
+ <li> <a href="./matchers.html">Bundled Matchers</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/james/rfclist">Useful RFCs {web}</a>
+</li>
+ </ul>
+ <p><strong>Get Involved {web}</strong></p>
+ <ul>
+ <li> <a href="http://jakarta.apache.org/site/getinvolved.html">Overview</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/cvsindex.html">CVS Repositories</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/library.html">Reference Library</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/bugs.html">Bug Database</a>
+</li>
+ </ul>
+ <p><strong>Jakarta Essentials {web}</strong></p>
+ <ul>
+ <li> <a href="http://jakarta.apache.org/index.html">Front Page</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/news.html">News & Status</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/mission.html">Mission</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/guidelines.html">Guidelines Notes</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/faqs.html">FAQs</a>
+</li>
+ </ul>
+ <p><strong>Related Projects {web}</strong></p>
<ul>
- <li> <a href="./javadoc/mailet/index.html">Mailet API</a>
+ <li> <a href="http://jakarta.apache.org/ant/index.html">Ant</a>
</li>
- <li> <a href="./usingLDAP.html">Using LDAP</a>
+ <li> <a href="http://jakarta.apache.org/avalon/index.html">Avalon</a>
</li>
</ul>
</td>
@@ -67,6 +119,7 @@
<a name="Summary"><strong>Summary</strong></a>
</font>
</td></tr>
+ <tr><td><br/></td></tr>
<tr><td>
<blockquote>
<h3>An overview of IMAP command implementation proposed for JAMES</h3>
@@ -81,7 +134,9 @@
</ul>
</blockquote>
</blockquote>
+ </p>
</td></tr>
+ <tr><td><br/></td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
@@ -89,6 +144,7 @@
<a name="Background - IMAP commands"><strong>Background - IMAP commands</strong></a>
</font>
</td></tr>
+ <tr><td><br/></td></tr>
<tr><td>
<blockquote>
<p>The IMAP protocol is based on single socket connections. Each connection may be in one of four official states: Non-Authenticated, Authenticated, Selected and Logout. In addition, there is an on-connection 'state'. Connections may be pre-authenticated, in which case they transition directly to the Authenticated state. Connections may also be rejected arbitrarily, in which case a response is sent and the connection tranistions directly to Logout. Once a connection enters the Logout state it must terminate and will terminate without further client input.
@@ -96,7 +152,9 @@
<p>A connection can only 'select' one mailbox at a time, although the STATE command allows a limited view of another mailbox. A client may open more than one connection to a single server at once. The client is responsible for any coordination needed. Multiple connections may 'select' a mailbox at the same time. The server must coordinate access.
</p>
</blockquote>
+ </p>
</td></tr>
+ <tr><td><br/></td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
@@ -104,6 +162,7 @@
<a name="Commands by State, Effect and Sensitivity"><strong>Commands by State, Effect and Sensitivity</strong></a>
</font>
</td></tr>
+ <tr><td><br/></td></tr>
<tr><td>
<blockquote>
<p>Clients are, in general, permitted to issue multiple commands in a single connection. That is they can issue a second command without waiting for a response to the first command. Servers may process multiple commands in parallel or in series. However, some combinations of commands cannot be processed in parallel, because they are ambiguous. According to RFC2060,
@@ -2066,7 +2125,9 @@
</tr>
</table>
</blockquote>
+ </p>
</td></tr>
+ <tr><td><br/></td></tr>
</table>
</td>
</tr>
1.2 +89 -6 jakarta-james/www/index.html
Index: index.html
===================================================================
RCS file: /home/cvs/jakarta-james/www/index.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- index.html 2001/05/17 16:50:21 1.1
+++ index.html 2001/05/21 13:24:53 1.2
@@ -14,7 +14,7 @@
<meta name="author" value="Serge Knystautas">
<meta name="email" value="sergek@lokitech.com">
- <title>The Jakarta Site - Java Apache Mail Enterprise Server</title>
+ <title>The Jakarta James Site - Java Apache Mail Enterprise Server</title>
</head>
<body bgcolor="#ffffff" text="#000000" link="#525D76">
@@ -37,14 +37,16 @@
<tr>
<!-- LEFT SIDE NAVIGATION -->
<td valign="top" nowrap="true">
- <p><strong>About</strong></p>
+ <p><strong>James</strong></p>
<ul>
<li> <a href="./index.html">Overview</a>
</li>
<li> <a href="./install.html">Install</a>
</li>
- <li> <a href="./mailets.html">Mailets Concept</a>
+ <li> <a href="./configuration_v1_2.html">Configuration</a>
</li>
+ <li> <a href="./architecture_v1_2.html">Architecture</a>
+</li>
<li> <a href="./code-standards.html">Coding Standards</a>
</li>
<li> <a href="./license.html">License</a>
@@ -52,13 +54,63 @@
<li> <a href="./todo.html">TODO</a>
</li>
</ul>
+ <p><strong>Download</strong></p>
+ <ul>
+ <li> <a href="http://jakarta.apache.org/site/binindex.html">Binaries</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/sourceindex.html">Source Code</a>
+</li>
+ </ul>
<p><strong>Guides</strong></p>
<ul>
- <li> <a href="./javadoc/mailet/index.html">Mailet API</a>
+ <li> <a href="./mailet/index.html">Mailet API</a>
+</li>
+ <li> <a href="./usingLDAP_v1_2.html">Using LDAP</a>
+</li>
+ <li> <a href="./usingTown.html">Using RDBMS</a>
</li>
- <li> <a href="./usingLDAP.html">Using LDAP</a>
+ <li> <a href="./usingTLS_v1_2.html">Using TLS</a>
</li>
+ <li> <a href="./listservs.html">List Servers</a>
+</li>
+ <li> <a href="./matchers.html">Bundled Matchers</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/james/rfclist">Useful RFCs {web}</a>
+</li>
</ul>
+ <p><strong>Get Involved {web}</strong></p>
+ <ul>
+ <li> <a href="http://jakarta.apache.org/site/getinvolved.html">Overview</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/cvsindex.html">CVS Repositories</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/library.html">Reference Library</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/bugs.html">Bug Database</a>
+</li>
+ </ul>
+ <p><strong>Jakarta Essentials {web}</strong></p>
+ <ul>
+ <li> <a href="http://jakarta.apache.org/index.html">Front Page</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/news.html">News & Status</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/mission.html">Mission</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/guidelines.html">Guidelines Notes</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/faqs.html">FAQs</a>
+</li>
+ </ul>
+ <p><strong>Related Projects {web}</strong></p>
+ <ul>
+ <li> <a href="http://jakarta.apache.org/ant/index.html">Ant</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/avalon/index.html">Avalon</a>
+</li>
+ </ul>
</td>
<td align="left" valign="top">
<table border="0" cellspacing="0" cellpadding="2" width="100%">
@@ -67,6 +119,7 @@
<a name="What is it?"><strong>What is it?</strong></a>
</font>
</td></tr>
+ <tr><td><br/></td></tr>
<tr><td>
<blockquote>
<p>
@@ -76,7 +129,9 @@
Java 2 (minimum requirement is the JRE 1.2).
</p>
</blockquote>
+ </p>
</td></tr>
+ <tr><td><br/></td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
@@ -84,6 +139,7 @@
<a name="Design Objectives"><strong>Design Objectives</strong></a>
</font>
</td></tr>
+ <tr><td><br/></td></tr>
<tr><td>
<blockquote>
<p>These are some of the currently implemented features:</p>
@@ -105,7 +161,7 @@
systems. Examples of the services a Mailet might provide include: a
mail-to-fax or mail-to-phone transformer, a filter, a language translator, a mailling
list manager, etc. Several Mailets are included in the JAMES
- distribution (see <a href="configuration.html">Configuration</a>).</p>
+ distribution (see <a href="configuration_v1_2.html">Configuration</a>).</p>
<p><i><b>Resource abstraction</b></i> Like protocols, resources are abstracted and,
accessed through defined interfaces (JavaMail for transport, JDBC for
spool storage or user accounts in RDBMS's, Apache Mailet API). The server is
@@ -116,7 +172,9 @@
scalability and mission-critical use.</p>
<p>Anything else you may want if you help us write it :-)</p>
</blockquote>
+ </p>
</td></tr>
+ <tr><td><br/></td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
@@ -124,6 +182,7 @@
<a name="Feature Status"><strong>Feature Status</strong></a>
</font>
</td></tr>
+ <tr><td><br/></td></tr>
<tr><td>
<blockquote>
<table>
@@ -369,9 +428,33 @@
</font>
</td>
</tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ NNTP server
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Experimental
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ 1.2
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ 1.2
+ </font>
+</td>
+ </tr>
</table>
</blockquote>
+ </p>
</td></tr>
+ <tr><td><br/></td></tr>
</table>
</td>
</tr>
1.2 +69 -5 jakarta-james/www/install.html
Index: install.html
===================================================================
RCS file: /home/cvs/jakarta-james/www/install.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- install.html 2001/05/17 16:50:21 1.1
+++ install.html 2001/05/21 13:24:53 1.2
@@ -14,7 +14,7 @@
<meta name="author" value="Serge Knystautas">
<meta name="email" value="sergek@lokitech.com">
- <title>The Jakarta Site - Installation</title>
+ <title>The Jakarta James Site - Installation</title>
</head>
<body bgcolor="#ffffff" text="#000000" link="#525D76">
@@ -37,14 +37,16 @@
<tr>
<!-- LEFT SIDE NAVIGATION -->
<td valign="top" nowrap="true">
- <p><strong>About</strong></p>
+ <p><strong>James</strong></p>
<ul>
<li> <a href="./index.html">Overview</a>
</li>
<li> <a href="./install.html">Install</a>
</li>
- <li> <a href="./mailets.html">Mailets Concept</a>
+ <li> <a href="./configuration_v1_2.html">Configuration</a>
</li>
+ <li> <a href="./architecture_v1_2.html">Architecture</a>
+</li>
<li> <a href="./code-standards.html">Coding Standards</a>
</li>
<li> <a href="./license.html">License</a>
@@ -52,11 +54,61 @@
<li> <a href="./todo.html">TODO</a>
</li>
</ul>
+ <p><strong>Download</strong></p>
+ <ul>
+ <li> <a href="http://jakarta.apache.org/site/binindex.html">Binaries</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/sourceindex.html">Source Code</a>
+</li>
+ </ul>
<p><strong>Guides</strong></p>
+ <ul>
+ <li> <a href="./mailet/index.html">Mailet API</a>
+</li>
+ <li> <a href="./usingLDAP_v1_2.html">Using LDAP</a>
+</li>
+ <li> <a href="./usingTown.html">Using RDBMS</a>
+</li>
+ <li> <a href="./usingTLS_v1_2.html">Using TLS</a>
+</li>
+ <li> <a href="./listservs.html">List Servers</a>
+</li>
+ <li> <a href="./matchers.html">Bundled Matchers</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/james/rfclist">Useful RFCs {web}</a>
+</li>
+ </ul>
+ <p><strong>Get Involved {web}</strong></p>
+ <ul>
+ <li> <a href="http://jakarta.apache.org/site/getinvolved.html">Overview</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/cvsindex.html">CVS Repositories</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/library.html">Reference Library</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/bugs.html">Bug Database</a>
+</li>
+ </ul>
+ <p><strong>Jakarta Essentials {web}</strong></p>
+ <ul>
+ <li> <a href="http://jakarta.apache.org/index.html">Front Page</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/news.html">News & Status</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/mission.html">Mission</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/guidelines.html">Guidelines Notes</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/faqs.html">FAQs</a>
+</li>
+ </ul>
+ <p><strong>Related Projects {web}</strong></p>
<ul>
- <li> <a href="./javadoc/mailet/index.html">Mailet API</a>
+ <li> <a href="http://jakarta.apache.org/ant/index.html">Ant</a>
</li>
- <li> <a href="./usingLDAP.html">Using LDAP</a>
+ <li> <a href="http://jakarta.apache.org/avalon/index.html">Avalon</a>
</li>
</ul>
</td>
@@ -67,6 +119,7 @@
<a name="Step 0: Building. (only necessary for daily snapshots)"><strong>Step 0: Building. (only necessary for daily snapshots)</strong></a>
</font>
</td></tr>
+ <tr><td><br/></td></tr>
<tr><td>
<blockquote>
<p>
@@ -90,7 +143,9 @@
you may copy and rename the dist folder to your new favorite folder.
</p>
</blockquote>
+ </p>
</td></tr>
+ <tr><td><br/></td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
@@ -98,13 +153,16 @@
<a name="Step 1: Installation."><strong>Step 1: Installation.</strong></a>
</font>
</td></tr>
+ <tr><td><br/></td></tr>
<tr><td>
<blockquote>
<p>
Download distibution. Extract all files in your favorite folder.
</p>
</blockquote>
+ </p>
</td></tr>
+ <tr><td><br/></td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
@@ -112,6 +170,7 @@
<a name="Step 2: Configuration."><strong>Step 2: Configuration.</strong></a>
</font>
</td></tr>
+ <tr><td><br/></td></tr>
<tr><td>
<blockquote>
<p>
@@ -141,7 +200,9 @@
configuration files, press 'Enter' on the terminal where Avalon is waiting.
</p>
</blockquote>
+ </p>
</td></tr>
+ <tr><td><br/></td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
@@ -149,6 +210,7 @@
<a name="Step 4: Kickstart."><strong>Step 4: Kickstart.</strong></a>
</font>
</td></tr>
+ <tr><td><br/></td></tr>
<tr><td>
<blockquote>
<p>
@@ -178,7 +240,9 @@
Good luck :)
</p>
</blockquote>
+ </p>
</td></tr>
+ <tr><td><br/></td></tr>
</table>
</td>
</tr>
1.2 +60 -5 jakarta-james/www/license.html
Index: license.html
===================================================================
RCS file: /home/cvs/jakarta-james/www/license.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- license.html 2001/05/17 16:50:21 1.1
+++ license.html 2001/05/21 13:24:54 1.2
@@ -14,7 +14,7 @@
<meta name="author" value="Serge Knystautas">
<meta name="email" value="sergek@lokitech.com">
- <title>The Jakarta Site - Apache Software License</title>
+ <title>The Jakarta James Site - Apache Software License</title>
</head>
<body bgcolor="#ffffff" text="#000000" link="#525D76">
@@ -37,14 +37,16 @@
<tr>
<!-- LEFT SIDE NAVIGATION -->
<td valign="top" nowrap="true">
- <p><strong>About</strong></p>
+ <p><strong>James</strong></p>
<ul>
<li> <a href="./index.html">Overview</a>
</li>
<li> <a href="./install.html">Install</a>
</li>
- <li> <a href="./mailets.html">Mailets Concept</a>
+ <li> <a href="./configuration_v1_2.html">Configuration</a>
</li>
+ <li> <a href="./architecture_v1_2.html">Architecture</a>
+</li>
<li> <a href="./code-standards.html">Coding Standards</a>
</li>
<li> <a href="./license.html">License</a>
@@ -52,11 +54,61 @@
<li> <a href="./todo.html">TODO</a>
</li>
</ul>
+ <p><strong>Download</strong></p>
+ <ul>
+ <li> <a href="http://jakarta.apache.org/site/binindex.html">Binaries</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/sourceindex.html">Source Code</a>
+</li>
+ </ul>
<p><strong>Guides</strong></p>
+ <ul>
+ <li> <a href="./mailet/index.html">Mailet API</a>
+</li>
+ <li> <a href="./usingLDAP_v1_2.html">Using LDAP</a>
+</li>
+ <li> <a href="./usingTown.html">Using RDBMS</a>
+</li>
+ <li> <a href="./usingTLS_v1_2.html">Using TLS</a>
+</li>
+ <li> <a href="./listservs.html">List Servers</a>
+</li>
+ <li> <a href="./matchers.html">Bundled Matchers</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/james/rfclist">Useful RFCs {web}</a>
+</li>
+ </ul>
+ <p><strong>Get Involved {web}</strong></p>
+ <ul>
+ <li> <a href="http://jakarta.apache.org/site/getinvolved.html">Overview</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/cvsindex.html">CVS Repositories</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/library.html">Reference Library</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/bugs.html">Bug Database</a>
+</li>
+ </ul>
+ <p><strong>Jakarta Essentials {web}</strong></p>
+ <ul>
+ <li> <a href="http://jakarta.apache.org/index.html">Front Page</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/news.html">News & Status</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/mission.html">Mission</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/guidelines.html">Guidelines Notes</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/faqs.html">FAQs</a>
+</li>
+ </ul>
+ <p><strong>Related Projects {web}</strong></p>
<ul>
- <li> <a href="./javadoc/mailet/index.html">Mailet API</a>
+ <li> <a href="http://jakarta.apache.org/ant/index.html">Ant</a>
</li>
- <li> <a href="./usingLDAP.html">Using LDAP</a>
+ <li> <a href="http://jakarta.apache.org/avalon/index.html">Avalon</a>
</li>
</ul>
</td>
@@ -67,6 +119,7 @@
<a name="Apache Software License"><strong>Apache Software License</strong></a>
</font>
</td></tr>
+ <tr><td><br/></td></tr>
<tr><td>
<blockquote>
<p>
@@ -146,7 +199,9 @@
</table>
</div>
</blockquote>
+ </p>
</td></tr>
+ <tr><td><br/></td></tr>
</table>
</td>
</tr>
1.2 +517 -269 jakarta-james/www/matchers.html
Index: matchers.html
===================================================================
RCS file: /home/cvs/jakarta-james/www/matchers.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- matchers.html 2001/05/17 16:50:21 1.1
+++ matchers.html 2001/05/21 13:24:57 1.2
@@ -1,285 +1,533 @@
-<html xmlns:o="urn:schemas-microsoft-com:office:office"
-xmlns:w="urn:schemas-microsoft-com:office:word"
-xmlns="http://www.w3.org/TR/REC-html40">
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
-<head>
-<meta http-equiv=Content-Type content="text/html; charset=windows-1252">
-<meta name=ProgId content=Word.Document>
-<meta name=Generator content="Microsoft Word 9">
-<meta name=Originator content="Microsoft Word 9">
-<link rel=File-List href="./matchers_files/filelist.xml">
-<title>Matchers</title>
-<!--[if gte mso 9]><xml>
- <o:DocumentProperties>
- <o:Author>Serge Knystautas</o:Author>
- <o:LastAuthor>Serge Knystautas</o:LastAuthor>
- <o:Revision>3</o:Revision>
- <o:TotalTime>27</o:TotalTime>
- <o:Created>2000-10-14T14:03:00Z</o:Created>
- <o:LastSaved>2000-10-14T14:31:00Z</o:LastSaved>
- <o:Pages>2</o:Pages>
- <o:Words>443</o:Words>
- <o:Characters>2529</o:Characters>
- <o:Company>Loki Technologies</o:Company>
- <o:Lines>21</o:Lines>
- <o:Paragraphs>5</o:Paragraphs>
- <o:CharactersWithSpaces>3105</o:CharactersWithSpaces>
- <o:Version>9.2720</o:Version>
- </o:DocumentProperties>
- <o:OfficeDocumentSettings>
- <o:AllowPNG/>
- </o:OfficeDocumentSettings>
-</xml><![endif]--><!--[if gte mso 9]><xml>
- <w:WordDocument>
- <w:DisplayHorizontalDrawingGridEvery>0</w:DisplayHorizontalDrawingGridEvery>
- <w:DisplayVerticalDrawingGridEvery>0</w:DisplayVerticalDrawingGridEvery>
- <w:UseMarginsForDrawingGridOrigin/>
- <w:Compatibility>
- <w:FootnoteLayoutLikeWW8/>
- <w:ShapeLayoutLikeWW8/>
- <w:AlignTablesRowByRow/>
- <w:ForgetLastTabAlignment/>
- <w:LayoutRawTableWidth/>
- <w:LayoutTableRowsApart/>
- </w:Compatibility>
- <w:BrowserLevel>MicrosoftInternetExplorer4</w:BrowserLevel>
- </w:WordDocument>
-</xml><![endif]-->
-<style>
-<!--
- /* Style Definitions */
-p.MsoNormal, li.MsoNormal, div.MsoNormal
- {mso-style-parent:"";
- margin:0in;
- margin-bottom:.0001pt;
- mso-pagination:widow-orphan;
- font-size:10.0pt;
- font-family:"Times New Roman";
- mso-fareast-font-family:"Times New Roman";}
-h1
- {mso-style-next:Normal;
- margin:0in;
- margin-bottom:.0001pt;
- mso-pagination:widow-orphan;
- page-break-after:avoid;
- mso-outline-level:1;
- font-size:16.0pt;
- mso-bidi-font-size:10.0pt;
- font-family:"Times New Roman";
- mso-font-kerning:0pt;}
-h2
- {mso-style-next:Normal;
- margin:0in;
- margin-bottom:.0001pt;
- mso-pagination:widow-orphan;
- page-break-after:avoid;
- mso-outline-level:2;
- font-size:12.0pt;
- mso-bidi-font-size:10.0pt;
- font-family:"Times New Roman";}
-a:link, span.MsoHyperlink
- {color:blue;
- text-decoration:underline;
- text-underline:single;}
-a:visited, span.MsoHyperlinkFollowed
- {color:purple;
- text-decoration:underline;
- text-underline:single;}
-@page Section1
- {size:8.5in 11.0in;
- margin:1.0in 1.25in 1.0in 1.25in;
- mso-header-margin:.5in;
- mso-footer-margin:.5in;
- mso-paper-source:0;}
-div.Section1
- {page:Section1;}
--->
-</style>
-</head>
+<!-- Content Stylesheet for Site -->
-<body lang=EN-US link=blue vlink=purple style='tab-interval:.5in'>
+
+<!-- start the processing -->
+ <!-- ====================================================================== -->
+ <!-- Main Page Section -->
+ <!-- ====================================================================== -->
+ <html>
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
+
+ <meta name="author" value="Serge Knystautas">
+ <meta name="email" value="sergek@lokitech.com">
+
+ <title>The Jakarta James Site - James 1.2.1 - Matchers</title>
+ </head>
+
+ <body bgcolor="#ffffff" text="#000000" link="#525D76">
+ <table border="0" width="100%" cellspacing="0">
+ <!-- TOP IMAGE -->
+ <tr>
+ <td align="left">
+<a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" border="0"/></a>
+</td>
+<td align="right">
+<a href="http://jakarta.apache.org/james/"><img src="./images/james-logo.jpg" alt="JAMES - Java Apache Mail Enterprise Server" border="0"/></a>
+</td>
+ </tr>
+ </table>
+ <table border="0" width="100%" cellspacing="4">
+ <tr><td colspan="2">
+ <hr noshade="" size="1"/>
+ </td></tr>
+
+ <tr>
+ <!-- LEFT SIDE NAVIGATION -->
+ <td valign="top" nowrap="true">
+ <p><strong>James</strong></p>
+ <ul>
+ <li> <a href="./index.html">Overview</a>
+</li>
+ <li> <a href="./install.html">Install</a>
+</li>
+ <li> <a href="./configuration_v1_2.html">Configuration</a>
+</li>
+ <li> <a href="./architecture_v1_2.html">Architecture</a>
+</li>
+ <li> <a href="./code-standards.html">Coding Standards</a>
+</li>
+ <li> <a href="./license.html">License</a>
+</li>
+ <li> <a href="./todo.html">TODO</a>
+</li>
+ </ul>
+ <p><strong>Download</strong></p>
+ <ul>
+ <li> <a href="http://jakarta.apache.org/site/binindex.html">Binaries</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/sourceindex.html">Source Code</a>
+</li>
+ </ul>
+ <p><strong>Guides</strong></p>
+ <ul>
+ <li> <a href="./mailet/index.html">Mailet API</a>
+</li>
+ <li> <a href="./usingLDAP_v1_2.html">Using LDAP</a>
+</li>
+ <li> <a href="./usingTown.html">Using RDBMS</a>
+</li>
+ <li> <a href="./usingTLS_v1_2.html">Using TLS</a>
+</li>
+ <li> <a href="./listservs.html">List Servers</a>
+</li>
+ <li> <a href="./matchers.html">Bundled Matchers</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/james/rfclist">Useful RFCs {web}</a>
+</li>
+ </ul>
+ <p><strong>Get Involved {web}</strong></p>
+ <ul>
+ <li> <a href="http://jakarta.apache.org/site/getinvolved.html">Overview</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/cvsindex.html">CVS Repositories</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/library.html">Reference Library</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/bugs.html">Bug Database</a>
+</li>
+ </ul>
+ <p><strong>Jakarta Essentials {web}</strong></p>
+ <ul>
+ <li> <a href="http://jakarta.apache.org/index.html">Front Page</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/news.html">News & Status</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/mission.html">Mission</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/guidelines.html">Guidelines Notes</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/faqs.html">FAQs</a>
+</li>
+ </ul>
+ <p><strong>Related Projects {web}</strong></p>
+ <ul>
+ <li> <a href="http://jakarta.apache.org/ant/index.html">Ant</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/avalon/index.html">Avalon</a>
+</li>
+ </ul>
+ </td>
+ <td align="left" valign="top">
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="Matchers"><strong>Matchers</strong></a>
+ </font>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ <tr><td>
+ <blockquote>
+ <p>
+ Several matchers are included with James 1.2.1, they are described below.
+ </p>
+ </blockquote>
+ </p>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="All"><strong>All</strong></a>
+ </font>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ <tr><td>
+ <blockquote>
+ <p>
+ <b>Universal match</b>
+ Matches all recipients of all mails reaching it.
+ </p>
+ <p>
+ Condition:
+ <br>
+ none
+ </br>
+ </p>
+ </blockquote>
+ </p>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="CommandForListserv"><strong>CommandForListserv</strong></a>
+ </font>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ <tr><td>
+ <blockquote>
+ <p>
+ <b>Intercept commands for Listserv Manager</b>
+ Matches the on and off version of the address specified.
+ <br>
+ For instance, if the match was specified as
+ CommandForListserv=james@list.working-dogs.com, then this match would
+ match james-on@list.working-dogs.com and james-off@list.working-dogs.com.
+ </br>
+ <br>
+ Useful to channel listserv commands to a different mailet.
+ </br>
+ </p>
+ <p>
+ Condition:
+ <br>
+ listserv address to use as base.
+ </br>
+ </p>
+ </blockquote>
+ </p>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="HostIs"><strong>HostIs</strong></a>
+ </font>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ <tr><td>
+ <blockquote>
+ <p>
+ <b>Match by Recipient Host</b>
+ Matches recipients where the domain of the recipient's email address
+ matches the host specified in the condition.
+ <br>
+ This is a string comparison and does not check DNS information.
+ </br>
+ </p>
+ <p>
+ Condition:
+ <br>
+ the hostname to compare to the recipient's domain name.
+ </br>
+ </p>
+ </blockquote>
+ </p>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="HostIsLocal"><strong>HostIsLocal</strong></a>
+ </font>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ <tr><td>
+ <blockquote>
+ <p>
+ <b>Match by Recipient Host</b>
+ Matches recipients where the domain of the recipient's email
+ address matches one of the hosts handled by this server.
+ </p>
+ <p>
+ Condition:
+ <br>
+ none
+ </br>
+ </p>
+ </blockquote>
+ </p>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="RecipientIs"><strong>RecipientIs</strong></a>
+ </font>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ <tr><td>
+ <blockquote>
+ <p>
+ <b>Match by Recipient</b>
+ Matches recipients where the domain of the recipient's email address
+ matches the host specified in the condition.
+ </p>
+ <p>
+ Condition:
+ <br>
+ a comma or space delimited list of email addresses.
+ </br>
+ </p>
+ </blockquote>
+ </p>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="RecipientIsLocal"><strong>RecipientIsLocal</strong></a>
+ </font>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ <tr><td>
+ <blockquote>
+ <p>
+ <b>Match by Recipient User and Host</b>
+ Matches the recipient's domain against the hosts handled by this server
+ and the recipient's user against the user accounts of this server.
+ </p>
+ <p>
+ Condition:
+ <br>
+ none
+ </br>
+ </p>
+ </blockquote>
+ </p>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="RelayLimit"><strong>RelayLimit</strong></a>
+ </font>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ <tr><td>
+ <blockquote>
+ <p>
+ <b>Match by Hops</b>
+ Matches mail is it has been relayed more than the number
+ specified in the condition.
+ <br>
+ Determines number of hops by counting the number of Received
+ headers in the message.
+ </br>
+ </p>
+ <p>
+ Condition:
+ <br>
+ the number of hops at which this message should start matching.
+ </br>
+ </p>
+ </blockquote>
+ </p>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="RemoteInNetwork"><strong>RemoteInNetwork</strong></a>
+ </font>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ <tr><td>
+ <blockquote>
+ <p>
+ <b>Match by SMTP Sender</b>
+ Matches mail if the IP address of the sending machine
+ is in one of the networks specified in the condition.
+ </p>
+ <p>
+ Condition:
+ <br>
+ a comma or space delimited list of IP addresses and networks.
+ Networks are specified by leaving off the appropriate subnet mask as is
+ done in /etc/hosts.allow and /etc/hosts.deny in unix,
+ e.g., 38.177.223.
+ </br>
+ </p>
+ </blockquote>
+ </p>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="RemoteNotInNetwork"><strong>RemoteNotInNetwork</strong></a>
+ </font>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ <tr><td>
+ <blockquote>
+ <p>
+ <b>Match by SMTP Sender</b>
+ Matches mail if the IP address of the sending machine
+ is not in one of the networks specified in the condition.
+ </p>
+ <p>
+ Condition:
+ <br>
+ a comma or space delimited list of IP addresses and networks.
+ Networks are specified by leaving off the appropriate subnet mask as is
+ done in /etc/hosts.allow and /etc/hosts.deny in unix,
+ e.g., 38.177.223.
+ </br>
+ </p>
+ </blockquote>
+ </p>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="SenderInFakeDomain"><strong>SenderInFakeDomain</strong></a>
+ </font>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ <tr><td>
+ <blockquote>
+ <p>
+ <b>Verify Sender's Domain</b>
+ Does a DNS lookup for MX, A or CNAME record on the sending email
+ address's domain part. If no DNS records are found, the mail is matche d.
+ (useful for blocking mail with forged email addresses.)
+ </p>
+ <p>
+ Condition:
+ <br>
+ none
+ </br>
+ </p>
+ </blockquote>
+ </p>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="SenderIs"><strong>SenderIs</strong></a>
+ </font>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ <tr><td>
+ <blockquote>
+ <p>
+ <b>Match by Sender</b>
+ Matches mail if sender is one of the email addresses
+ specified in the condition.
+ </p>
+ <p>
+ Condition:
+ <br>
+ a comma or space delimited list of email addresses.
+ </br>
+ </p>
+ </blockquote>
+ </p>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="SubjectIs"><strong>SubjectIs</strong></a>
+ </font>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ <tr><td>
+ <blockquote>
+ <p>
+ <b>Match by Subject</b>
+ Matches mail if the subject is the same as the one specified
+ in the condition.
+ </p>
+ <p>
+ Condition:
+ <br>
+ a subject to match.
+ </br>
+ </p>
+ </blockquote>
+ </p>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="SubjectStartsWith"><strong>SubjectStartsWith</strong></a>
+ </font>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ <tr><td>
+ <blockquote>
+ <p>
+ <b>Match by Subject</b>
+ Matches mail if the subject starts with the one specified
+ in the condition.
+ </p>
+ <p>
+ Condition:
+ <br>
+ a subject fragment to match.
+ </br>
+ </p>
+ </blockquote>
+ </p>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="UserIs"><strong>UserIs</strong></a>
+ </font>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ <tr><td>
+ <blockquote>
+ <p>
+ <b>Match by Recipient</b>
+ Matches mail if the user part of a recipient's email address matches one
+ of the users specified in the condition. The user portion of an email
+ address is the part before the @ symbol.
+ </p>
+ <p>
+ Condition:
+ <br>
+ a comma or space delimited list of users.
+ </br>
+ </p>
+ </blockquote>
+ </p>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ </td>
+ </tr>
+
+ <!-- FOOTER -->
+ <tr><td colspan="2">
+ <hr noshade="" size="1"/>
+ </td></tr>
+ <tr><td colspan="2">
+ <div align="center"><font color="#525D76" size="-1"><em>
+ Copyright © 1999-2001, Apache Software Foundation
+ </em></font></div>
+ </td></tr>
+ </table>
+ </body>
+ </html>
+<!-- end the processing -->
-<div class=Section1>
-<h1>Matchers</h1>
-<p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
-<h2>All</h2>
-<p class=MsoNormal>Every mail with all recipients is always matched.</p>
-<p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
-<p class=MsoNormal>No condition.</p>
-<p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
-<h2>CommandForListserv</h2>
-<p class=MsoNormal>Matches the �on and �off version of the address
-specified.<span style="mso-spacerun: yes">� </span>For instance, if the match
-was specified as CommandForListserv=james@list.working-dogs.com, then this
-match would match james-on@list.working-dogs.com and james-off@list.working-dogs.com.
-<span style="mso-spacerun: yes">�</span>Useful to channel listserv commands to
-a different mailet.</p>
-<p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
-<p class=MsoNormal>Condition: listserv address to use as base.</p>
-<p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
-<h2>HostIs</h2>
-
-<p class=MsoNormal>Matches recipients where the domain of the recipient�s email
-address matches the host specified in the condition.<span style="mso-spacerun:
-yes">� </span>This is a string comparison and does not check DNS information.</p>
-
-<p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
-
-<p class=MsoNormal>Condition: the hostname to compare to the recipient�s domain
-name.</p>
-
-<p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
-
-<h2>HostIsLocal</h2>
-
-<p class=MsoNormal>Matches recipients where the domain of the recipient�s email
-address matches one of the hosts handled by this server.</p>
-
-<p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
-
-<p class=MsoNormal>No condition.</p>
-
-<p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
-
-<h2>RecipientIs</h2>
-
-<p class=MsoNormal>Matches recipients against a comma or space delimited list
-of recipient email addresses (exactly).</p>
-
-<p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
-
-<p class=MsoNormal>Condition: a comma or space delimited list of email addresses.</p>
-
-<p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
-
-<h2>RecipientIsLocal</h2>
-
-<p class=MsoNormal>Matches the recipient�s domain against the hosts handled by
-this server and the recipient�s user against the user accounts of this server.</p>
-
-<p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
-
-<p class=MsoNormal>No condition.</p>
-
-<p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
-
-<h2>RelayLimit</h2>
-
-<p class=MsoNormal>Matches mail is it has been relayed more than the number
-specified in the condition.<span style="mso-spacerun: yes">� </span>Determines number
-of hops by counting the number of �Received� headers in the message.</p>
-
-<p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
-
-<p class=MsoNormal>Condition: the number of hops at which this message should
-start matching.</p>
-
-<p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
-
-<h2>RemoteInNetwork</h2>
-
-<p class=MsoNormal>Matches mail if the remote IP address of the sending machine
-is in one of the networks specified in the condition.</p>
-
-<p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
-
-<p class=MsoNormal>Condition: a comma or space delimited list of IP addresses
-and networks.<span style="mso-spacerun: yes">� </span>Networks are specified by
-leaving off the appropriate subnet mask as is done in /etc/hosts.allow and /etc/hosts.deny
-in unix, e.g., �38.177.223.�</p>
-
-<p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
-
-<h2>RemoteNotInNetwork</h2>
-
-<p class=MsoNormal>Matches mail if the remote IP address of the sending machine
-is not in one of the networks specified in the condition.</p>
-
-<p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
-
-<p class=MsoNormal>Condition: a comma or space delimited list IP addresses and
-networks.<span style="mso-spacerun: yes">� </span>Networks are specified by
-leaving off the appropriate subnet mask as is done in /etc/hosts.allow and /etc/hosts.deny
-in unix, e.g., �38.177.223.�</p>
-
-<p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
-
-<h2>SenderInFakeDomain</h2>
-
-<p class=MsoNormal>Does a DNS lookup for MX, A or CNAME record on the sending email
-address�s domain part.<span style="mso-spacerun: yes">� </span>If no DNS
-records are found, the mail is matched.<span style="mso-spacerun: yes">�
-</span>(useful for blocking mail with forged email addresses.)</p>
-
-<p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
-
-<p class=MsoNormal>No condition.</p>
-
-<p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
-
-<h2>SenderIs</h2>
-
-<p class=MsoNormal>Matches mail if sender is one of the email addresses
-specified in the condition.</p>
-
-<p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
-
-<p class=MsoNormal>Condition: a comma or space delimited list of email addresses.</p>
-
-<p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
-
-<h2>SubjectIs</h2>
-
-<p class=MsoNormal>Matches mail if the subject is the same as the one specified
-in the condition.</p>
-
-<p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
-
-<p class=MsoNormal>Condition: a subject to match.</p>
-
-<p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
-
-<h2>SubjectStartsWith</h2>
-
-<p class=MsoNormal>Matches mail if the subjects starts with the one specified
-in the condition.</p>
-
-<p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
-
-<p class=MsoNormal>Condition: a subject fragment to compare.</p>
-
-<p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
-
-<h2>UserIs</h2>
-
-<p class=MsoNormal>Matches mail if the user part of a recipient�s email address
-matches one of the users specified in the condition.<span style="mso-spacerun:
-yes">� </span>The user portion of an email address is the part before the @
-symbol.</p>
-
-<p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
-
-<p class=MsoNormal>Condition: a comma or space delimited list of users.</p>
-
-<p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
-
-<p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
-
-</div>
-
-</body>
-
-</html>
1.2 +77 -11 jakarta-james/www/todo.html
Index: todo.html
===================================================================
RCS file: /home/cvs/jakarta-james/www/todo.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- todo.html 2001/05/17 16:50:22 1.1
+++ todo.html 2001/05/21 13:24:58 1.2
@@ -16,7 +16,7 @@
<meta name="author" value="Charles Benett">
<meta name="email" value="charles@benett1.co.uk">
- <title>The Jakarta Site - TODO</title>
+ <title>The Jakarta James Site - TODO</title>
</head>
<body bgcolor="#ffffff" text="#000000" link="#525D76">
@@ -39,14 +39,16 @@
<tr>
<!-- LEFT SIDE NAVIGATION -->
<td valign="top" nowrap="true">
- <p><strong>About</strong></p>
+ <p><strong>James</strong></p>
<ul>
<li> <a href="./index.html">Overview</a>
</li>
<li> <a href="./install.html">Install</a>
</li>
- <li> <a href="./mailets.html">Mailets Concept</a>
+ <li> <a href="./configuration_v1_2.html">Configuration</a>
</li>
+ <li> <a href="./architecture_v1_2.html">Architecture</a>
+</li>
<li> <a href="./code-standards.html">Coding Standards</a>
</li>
<li> <a href="./license.html">License</a>
@@ -54,11 +56,61 @@
<li> <a href="./todo.html">TODO</a>
</li>
</ul>
+ <p><strong>Download</strong></p>
+ <ul>
+ <li> <a href="http://jakarta.apache.org/site/binindex.html">Binaries</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/sourceindex.html">Source Code</a>
+</li>
+ </ul>
<p><strong>Guides</strong></p>
+ <ul>
+ <li> <a href="./mailet/index.html">Mailet API</a>
+</li>
+ <li> <a href="./usingLDAP_v1_2.html">Using LDAP</a>
+</li>
+ <li> <a href="./usingTown.html">Using RDBMS</a>
+</li>
+ <li> <a href="./usingTLS_v1_2.html">Using TLS</a>
+</li>
+ <li> <a href="./listservs.html">List Servers</a>
+</li>
+ <li> <a href="./matchers.html">Bundled Matchers</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/james/rfclist">Useful RFCs {web}</a>
+</li>
+ </ul>
+ <p><strong>Get Involved {web}</strong></p>
+ <ul>
+ <li> <a href="http://jakarta.apache.org/site/getinvolved.html">Overview</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/cvsindex.html">CVS Repositories</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/library.html">Reference Library</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/bugs.html">Bug Database</a>
+</li>
+ </ul>
+ <p><strong>Jakarta Essentials {web}</strong></p>
+ <ul>
+ <li> <a href="http://jakarta.apache.org/index.html">Front Page</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/news.html">News & Status</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/mission.html">Mission</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/guidelines.html">Guidelines Notes</a>
+</li>
+ <li> <a href="http://jakarta.apache.org/site/faqs.html">FAQs</a>
+</li>
+ </ul>
+ <p><strong>Related Projects {web}</strong></p>
<ul>
- <li> <a href="./javadoc/mailet/index.html">Mailet API</a>
+ <li> <a href="http://jakarta.apache.org/ant/index.html">Ant</a>
</li>
- <li> <a href="./usingLDAP.html">Using LDAP</a>
+ <li> <a href="http://jakarta.apache.org/avalon/index.html">Avalon</a>
</li>
</ul>
</td>
@@ -69,12 +121,15 @@
<a name="TODO"><strong>TODO</strong></a>
</font>
</td></tr>
+ <tr><td><br/></td></tr>
<tr><td>
<blockquote>
<p>This is a living document that will give new and existing volunteers some areas where we need help. As always, any help is appreciated, be it documentation, code, suggestions, or feedback.
-Last Updated 26 April 2001.</p>
+Last Updated 17 May 2001.</p>
</blockquote>
+ </p>
</td></tr>
+ <tr><td><br/></td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
@@ -82,15 +137,17 @@
<a name="High Priority"><strong>High Priority</strong></a>
</font>
</td></tr>
+ <tr><td><br/></td></tr>
<tr><td>
<blockquote>
<p>Port existing documentation to xdocs format</p>
<p>Bundle docs in dist</p>
- <p>Allow RemoteManager to change passwords of users (change attribute) </p>
+ <p>Allow RemoteManager to change passwords of users (change attribute)<b> In proposals dir </b> </p>
<p>Revive RDBMS support for messages and users. Possibly move from town to straight jdbc, or jakarta-turbine.</p>
- <p>Enable multiple domains</p>
</blockquote>
+ </p>
</td></tr>
+ <tr><td><br/></td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
@@ -98,9 +155,12 @@
<a name="Medium Priority"><strong>Medium Priority</strong></a>
</font>
</td></tr>
+ <tr><td><br/></td></tr>
<tr><td>
<blockquote>
- <p>Let RemoteDelivery send all messages to a single remote server (acting like a gateway or a relay host) </p>
+ <p>Enable multiple domains/ virtual hosting</p>
+ <p>Rewrite SMTP and POP3 handlers to use streams not MimeMessage objects</p>
+ <p>Let RemoteDelivery send all messages to a single remote server (acting like a gateway, relay or 'smart' host) </p>
<p>Improve exception management in RemoteDelivery mailet and general notices of why delivery failures occur.</p>
<p>Add support for regex inside most matchers and thereby consolidate a few of them.</p>
<p>Write more documentation. </p>
@@ -115,8 +175,11 @@
<p>Add support for deployable message processing apps using Camelot pattern</p>
<p>Give admins option to enforce one access at a time to a POP3 mailbox.</p>
<p>Simplify email aliasing</p>
+ <p>Tie in the NNTP Repository with POP/SMTP/IMAP repository structure.</p>
</blockquote>
+ </p>
</td></tr>
+ <tr><td><br/></td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
@@ -124,13 +187,16 @@
<a name="Low Priority"><strong>Low Priority</strong></a>
</font>
</td></tr>
+ <tr><td><br/></td></tr>
<tr><td>
<blockquote>
- <p>Tie in the NNTP Repository with POP/SMTP/IMAP repository structure.</p>
- <p>Add support for DRAC login/relay allowing</p>
+ <p>Add support for DRAC login/relay allowing</p>
<p>Review threadpooling - is it dynamic?</p>
+ <p>Enable read receipts to be handled properly</p>
</blockquote>
+ </p>
</td></tr>
+ <tr><td><br/></td></tr>
</table>
</td>
</tr>
1.1 jakarta-james/www/architecture_v1_2.html
Index: architecture_v1_2.html
===================================================================
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!-- Content Stylesheet for Site -->
<!-- start the processing -->
<!-- ====================================================================== -->
<!-- Main Page Section -->
<!-- ====================================================================== -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
<meta name="author" value="Charles Benett">
<meta name="email" value="charles@benett1.demon.co.uk">
<title>The Jakarta James Site - James 1.2 - Notes for developers</title>
</head>
<body bgcolor="#ffffff" text="#000000" link="#525D76">
<table border="0" width="100%" cellspacing="0">
<!-- TOP IMAGE -->
<tr>
<td align="left">
<a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" border="0"/></a>
</td>
<td align="right">
<a href="http://jakarta.apache.org/james/"><img src="./images/james-logo.jpg" alt="JAMES - Java Apache Mail Enterprise Server" border="0"/></a>
</td>
</tr>
</table>
<table border="0" width="100%" cellspacing="4">
<tr><td colspan="2">
<hr noshade="" size="1"/>
</td></tr>
<tr>
<!-- LEFT SIDE NAVIGATION -->
<td valign="top" nowrap="true">
<p><strong>James</strong></p>
<ul>
<li> <a href="./index.html">Overview</a>
</li>
<li> <a href="./install.html">Install</a>
</li>
<li> <a href="./configuration_v1_2.html">Configuration</a>
</li>
<li> <a href="./architecture_v1_2.html">Architecture</a>
</li>
<li> <a href="./code-standards.html">Coding Standards</a>
</li>
<li> <a href="./license.html">License</a>
</li>
<li> <a href="./todo.html">TODO</a>
</li>
</ul>
<p><strong>Download</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/site/binindex.html">Binaries</a>
</li>
<li> <a href="http://jakarta.apache.org/site/sourceindex.html">Source Code</a>
</li>
</ul>
<p><strong>Guides</strong></p>
<ul>
<li> <a href="./mailet/index.html">Mailet API</a>
</li>
<li> <a href="./usingLDAP_v1_2.html">Using LDAP</a>
</li>
<li> <a href="./usingTown.html">Using RDBMS</a>
</li>
<li> <a href="./usingTLS_v1_2.html">Using TLS</a>
</li>
<li> <a href="./listservs.html">List Servers</a>
</li>
<li> <a href="./matchers.html">Bundled Matchers</a>
</li>
<li> <a href="http://jakarta.apache.org/james/rfclist">Useful RFCs {web}</a>
</li>
</ul>
<p><strong>Get Involved {web}</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/site/getinvolved.html">Overview</a>
</li>
<li> <a href="http://jakarta.apache.org/site/cvsindex.html">CVS Repositories</a>
</li>
<li> <a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a>
</li>
<li> <a href="http://jakarta.apache.org/site/library.html">Reference Library</a>
</li>
<li> <a href="http://jakarta.apache.org/site/bugs.html">Bug Database</a>
</li>
</ul>
<p><strong>Jakarta Essentials {web}</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/index.html">Front Page</a>
</li>
<li> <a href="http://jakarta.apache.org/site/news.html">News & Status</a>
</li>
<li> <a href="http://jakarta.apache.org/site/mission.html">Mission</a>
</li>
<li> <a href="http://jakarta.apache.org/site/guidelines.html">Guidelines Notes</a>
</li>
<li> <a href="http://jakarta.apache.org/site/faqs.html">FAQs</a>
</li>
</ul>
<p><strong>Related Projects {web}</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/ant/index.html">Ant</a>
</li>
<li> <a href="http://jakarta.apache.org/avalon/index.html">Avalon</a>
</li>
</ul>
</td>
<td align="left" valign="top">
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="Architecture"><strong>Architecture</strong></a>
</font>
</td></tr>
<tr><td><br/></td></tr>
<tr><td>
<blockquote>
<p>
JAMES is a multi-protocol message processing and storage engine. JAMES
currently consists of:
<ul>
<li> two mail prototcol servers (SMTP and POP3),</li>
<li> a remote administration server,</li>
<li> a mail processing engine that supports the Mailet API</li>
<li> file-system message storage and a message storage interface
to RDBMS's</li>
<li> file-system user record storage and an experimental interface
to LDAP directories</li>
<li> beta support for TLS (SSL) for POP3 and remote administration</li>
</ul>
</p>
<p>
JAMES is built on top of Avalon, the Java Apache Server Framework.
Versions 1.1 and 1.2 of James use a slightly older version of Avalon,
specifically the <code>avalon-james-1-1b1</code> branch. We intend to
migrate to the new Avalon in the near future.</p>
</blockquote>
</p>
</td></tr>
<tr><td><br/></td></tr>
</table>
</td>
</tr>
<!-- FOOTER -->
<tr><td colspan="2">
<hr noshade="" size="1"/>
</td></tr>
<tr><td colspan="2">
<div align="center"><font color="#525D76" size="-1"><em>
Copyright © 1999-2001, Apache Software Foundation
</em></font></div>
</td></tr>
</table>
</body>
</html>
<!-- end the processing -->
1.1 jakarta-james/www/configuration_v1_2.html
Index: configuration_v1_2.html
===================================================================
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!-- Content Stylesheet for Site -->
<!-- start the processing -->
<!-- ====================================================================== -->
<!-- Main Page Section -->
<!-- ====================================================================== -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
<meta name="author" value="Serge Knystautas">
<meta name="email" value="sergek@lokitech.com">
<title>The Jakarta James Site - Configuration for James 1.2.1</title>
</head>
<body bgcolor="#ffffff" text="#000000" link="#525D76">
<table border="0" width="100%" cellspacing="0">
<!-- TOP IMAGE -->
<tr>
<td align="left">
<a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" border="0"/></a>
</td>
<td align="right">
<a href="http://jakarta.apache.org/james/"><img src="./images/james-logo.jpg" alt="JAMES - Java Apache Mail Enterprise Server" border="0"/></a>
</td>
</tr>
</table>
<table border="0" width="100%" cellspacing="4">
<tr><td colspan="2">
<hr noshade="" size="1"/>
</td></tr>
<tr>
<!-- LEFT SIDE NAVIGATION -->
<td valign="top" nowrap="true">
<p><strong>James</strong></p>
<ul>
<li> <a href="./index.html">Overview</a>
</li>
<li> <a href="./install.html">Install</a>
</li>
<li> <a href="./configuration_v1_2.html">Configuration</a>
</li>
<li> <a href="./architecture_v1_2.html">Architecture</a>
</li>
<li> <a href="./code-standards.html">Coding Standards</a>
</li>
<li> <a href="./license.html">License</a>
</li>
<li> <a href="./todo.html">TODO</a>
</li>
</ul>
<p><strong>Download</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/site/binindex.html">Binaries</a>
</li>
<li> <a href="http://jakarta.apache.org/site/sourceindex.html">Source Code</a>
</li>
</ul>
<p><strong>Guides</strong></p>
<ul>
<li> <a href="./mailet/index.html">Mailet API</a>
</li>
<li> <a href="./usingLDAP_v1_2.html">Using LDAP</a>
</li>
<li> <a href="./usingTown.html">Using RDBMS</a>
</li>
<li> <a href="./usingTLS_v1_2.html">Using TLS</a>
</li>
<li> <a href="./listservs.html">List Servers</a>
</li>
<li> <a href="./matchers.html">Bundled Matchers</a>
</li>
<li> <a href="http://jakarta.apache.org/james/rfclist">Useful RFCs {web}</a>
</li>
</ul>
<p><strong>Get Involved {web}</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/site/getinvolved.html">Overview</a>
</li>
<li> <a href="http://jakarta.apache.org/site/cvsindex.html">CVS Repositories</a>
</li>
<li> <a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a>
</li>
<li> <a href="http://jakarta.apache.org/site/library.html">Reference Library</a>
</li>
<li> <a href="http://jakarta.apache.org/site/bugs.html">Bug Database</a>
</li>
</ul>
<p><strong>Jakarta Essentials {web}</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/index.html">Front Page</a>
</li>
<li> <a href="http://jakarta.apache.org/site/news.html">News & Status</a>
</li>
<li> <a href="http://jakarta.apache.org/site/mission.html">Mission</a>
</li>
<li> <a href="http://jakarta.apache.org/site/guidelines.html">Guidelines Notes</a>
</li>
<li> <a href="http://jakarta.apache.org/site/faqs.html">FAQs</a>
</li>
</ul>
<p><strong>Related Projects {web}</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/ant/index.html">Ant</a>
</li>
<li> <a href="http://jakarta.apache.org/avalon/index.html">Avalon</a>
</li>
</ul>
</td>
<td align="left" valign="top">
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="Configuration"><strong>Configuration</strong></a>
</font>
</td></tr>
<tr><td><br/></td></tr>
<tr><td>
<blockquote>
<p>
<blockquote>
<p>This document explains the JAMES.conf.xml file for James 1.2.1
<br>JAMES 1.2.1 is currently based on an older version of Avalon,
specifically the <code>avalon-james-1-1b1</code> branch in CVS.
</br>
</p>
</blockquote>
</p>
</blockquote>
</p>
</td></tr>
<tr><td><br/></td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="James Server Configuration"><strong>James Server Configuration</strong></a>
</font>
</td></tr>
<tr><td><br/></td></tr>
<tr><td>
<blockquote>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#828DA6">
<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="James Configuration"><strong>James Configuration</strong></a>
</font>
</td></tr>
<tr><td><br/></td></tr>
<tr><td>
<blockquote>
<p>
These tag elements control the JAMES spooling and identification
settings.
</p>
<table>
<tr>
<td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
<name>
</font>
</td>
<td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
default value
</font>
</td>
<td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
meaning
</font>
</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
postmaster
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
Postmaster@localhost
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
Is the source of error replies and the email users will mail to for any problem. You
should change this to an address that can receive incoming messages.
</font>
</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
helloName
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
attribute autodetect=TRUE and value of 'myMailServer'
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
The name by which James will identify itself in SMTP and POP3
greetings. If autodetect is TRUE James will attempt to detect
automatically the name, failing which it will use 'localhost'. If
autodetect is not TRUE, James will use the specified name or
'localhost' if none is specified. Look in jamesinfo.log for
lines like "[...] Local host is: [servername] and [...] Hello Name is: [machine name]"
</font>
</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
servernames/servername
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
attribute autodetect=TRUE and last value of 'localhost'
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
A list of host names James will consider as local. Any user [user]@[servername]
will be considered to be local. If autodetect is TRUE James will attempt to detect
automatically the name and use any names specified. Look in jamesinfo.log for a line like "[...] Handling mail for:: [domain/host]"
</font>
</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
spoolRepository
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
file://../var/mail/spool/
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
This is the path where incoming messages are stored before beeing processed.
</font>
</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
inboxRepository
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
file://../var/mail/localinbox/
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
This is the root for local users inbox. Each user will have a personal folder
[inboxRepository]/[user]
</font>
</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
spoolmanagerthreads
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
1
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
This is the number of thread that work polling mails from the spool and take care
of processing them.
</font>
</td>
</tr>
</table>
</blockquote>
</td></tr>
<tr><td><br/></td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#828DA6">
<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="SMTP Server Configuration"><strong>SMTP Server Configuration</strong></a>
</font>
</td></tr>
<tr><td><br/></td></tr>
<tr><td>
<blockquote>
<p>
These tag elements affect the SMTP listener (for incoming messages).
</p>
<table>
<tr>
<td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
<name>
</font>
</td>
<td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
default value
</font>
</td>
<td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
meaning
</font>
</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
port
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
25
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
The port we are listening to.
</font>
</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
bind
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
N.A.
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
Specific IP addresses that you wish to bind this service to.
</font>
</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
smtphandler
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
N.A.
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
Parent for all SMTPHandler configuations.
</font>
</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
connectiontimeout
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
120000
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
If nothing is received from an open connection for more than {timeout] mills
the connection is closed.
</font>
</td>
</tr>
</table>
</blockquote>
</td></tr>
<tr><td><br/></td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#828DA6">
<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="POP3 Server Configuration"><strong>POP3 Server Configuration</strong></a>
</font>
</td></tr>
<tr><td><br/></td></tr>
<tr><td>
<blockquote>
<p>
These tag elements affect the POP3 server (for message retrieval)
</p>
<table>
<tr>
<td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
<name>
</font>
</td>
<td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
default value
</font>
</td>
<td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
meaning
</font>
</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
port
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
110
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
The port we are listening to.
</font>
</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
bind
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
N.A.
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
Specific IP addresses that you wish to bind this service to.
</font>
</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
useTLS
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
false
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
Whether you wish to require/use TLS (SSL) on this port.
</font>
</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
pop3handler
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
N.A.
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
Parent for all POP3Handler configuations.
</font>
</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
connectiontimeout
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
120000
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
If nothing is received from an open connection for more than {timeout] mills
the connection is closed.
</font>
</td>
</tr>
</table>
</blockquote>
</td></tr>
<tr><td><br/></td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#828DA6">
<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="Users Manager Configuration"><strong>Users Manager Configuration</strong></a>
</font>
</td></tr>
<tr><td><br/></td></tr>
<tr><td>
<blockquote>
<p>
These tag elements affect the configuration of the list of local users.
</p>
<table>
<tr>
<td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
<name>
</font>
</td>
<td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
default value
</font>
</td>
<td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
meaning
</font>
</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
repository
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
file://../var/users/
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
The path where local mail account informations are stored.
</font>
</td>
</tr>
</table>
</blockquote>
</td></tr>
<tr><td><br/></td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#828DA6">
<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="Remote Manager Configuration"><strong>Remote Manager Configuration</strong></a>
</font>
</td></tr>
<tr><td><br/></td></tr>
<tr><td>
<blockquote>
<p>
These tag elements affect the remote manager, a telnet based utility
to manage the User Manager.
</p>
<table>
<tr>
<td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
<name>
</font>
</td>
<td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
default value
</font>
</td>
<td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
meaning
</font>
</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
port
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
4555
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
The port we are listening to.
</font>
</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
bind
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
N.A.
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
Specific IP addresses that you wish to bind this service to.
</font>
</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
useTLS
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
false
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
Whether you wish to require/use TLS (SSL) on this port.
</font>
</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
administrator_accounts
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
N.A.
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
The parent of <account>
</font>
</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
account
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
login="root" password="root"
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
A list of root account to administer JAMES.
</font>
</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
connectiontimeout
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
120000
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
If nothing is received from an open connection for more than {timeout] mills
</font>
</td>
</tr>
</table>
</blockquote>
</td></tr>
<tr><td><br/></td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#828DA6">
<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="Transport Configuration"><strong>Transport Configuration</strong></a>
</font>
</td></tr>
<tr><td><br/></td></tr>
<tr><td>
<blockquote>
<p>
These tag elements affect SMTP remote delivery, specifically, DNS
lookup functionality.
</p>
<table>
<tr>
<td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
<name>
</font>
</td>
<td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
default value
</font>
</td>
<td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
meaning
</font>
</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
dnsServer/servers/server
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
N.A.
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
This is a list of DNS to resolve external address.
</font>
</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
authoritative
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
false
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
Whether to require authoritative (non-cached) DNS records. Should always be false
unless you understand the implications.
</font>
</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
repository
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
file://../var/mail/delayed/
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
This is a temp repository path shared with the name of "TMP_REPOSITORY".
It is used by the RemoteDelivery Mailet to store mail for futher delivery.
(Note: this is not very elegant and will probally change soon)
</font>
</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
mailets
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
rootpath="org.apache.james.transport.mailets."
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
This is the parent node for all mailet configurations. The rootpath specify
where mailet repository is. (Note: need to plug more than one repository)
</font>
</td>
</tr>
</table>
</blockquote>
</td></tr>
<tr><td><br/></td></tr>
</table>
</blockquote>
</p>
</td></tr>
<tr><td><br/></td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="The Mailet processor pipeline"><strong>The Mailet processor pipeline</strong></a>
</font>
</td></tr>
<tr><td><br/></td></tr>
<tr><td>
<blockquote>
<p>
This is James sitemap. It defines how each incoming mail will be
processed. Incoming mails begins their process at the first mailet in the
pipe. Each step is described by a <servet> tag with some attributes:
<mailet match="[matchClass]=[matchParameters]"
class="[mailetClass]">.
The Match class split the mail into two: one with all recipients matching
conditions and the other with all recipient not matching. All information
in the mail except recipients cloned so bot matching and not matching are
identical (again except recipients). The matching mail will be passed to
the specified mailet for processing. After processing both mails, the
untoched not matching and the processed matching, goes to next step in
pipe. Some mailet will not return anything after process. The Null mailet
for example will simply destroy any incoming mail or the RemoteDelivery
since after delivery the mail needs no more processing.
</p>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#828DA6">
<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="Matches"><strong>Matches</strong></a>
</font>
</td></tr>
<tr><td><br/></td></tr>
<tr><td>
<blockquote>
<p>
The Match interface defines how match class should work. Their work is
to split a Vector of recipients into two: the ones matching a specified
condition and all others. Condition may or may not be present. You can
make one simple boolean operation merging two matches into one or you
can write your own class implementing the Match interface.
Currently implemented match:
</p>
<table>
<tr>
<td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
class name
</font>
</td>
<td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
parameter
</font>
</td>
<td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
action
</font>
</td>
<td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
example
</font>
</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
All
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
none
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
match all recipients.
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
match="All"
</font>
</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
HostIs
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
comma separated list of hosts names
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
match all recipient belonging to one of the specified hosts
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
match="HostIs=myHost.mydom.org,yourHost"
</font>
</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
RecipientIs
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
comma separated list of recipients
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
match all recipients defined in condition.
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
match="RecipientIs=root@localhost,admin@localhost"
</font>
</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
UserIs
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
comma separated list of accounts
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
match all recipients defined in condition regardless of host.
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
match="UserIs=root,admin"
</font>
</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
HostIsLocal
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
none
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
check recipients's hosts against the list of host names set in configuration for localhost
(see <servername>).
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
match="HostIsLocal"
</font>
</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
RecipientIsLocal
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
none
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
match recipient which host is local (see HostIsLocal) and that are recognized by the
Users Manager to be local accounts.
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
match="RecipientIsLocal"
</font>
</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
SenderIs
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
comma separated list of address.
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
match all recipients if sender is in the condition string, else match none.
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
match="SenderIs=badBay@badhost"
</font>
</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
RelayLimit
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
Maximum number of hops.
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
match all recipients if the message has more than the specified number of SMTP hops.
Important to prevent race conditions in SMTP delivery.
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
match="RelayLimit=30"
</font>
</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
SubjectIs
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
comma separated list of address.
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
match all recipients if the subject is equal to the condition string, else match none.
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
match="SubjectIs=REMOVE"
</font>
</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
SubjectStartsWith
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
comma separated list of address.
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
match all recipients if the subject starts with the condition string, else match none.
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
match="SubjectStartsWith: [ADV]"
</font>
</td>
</tr>
</table>
<p>
Some examples:
<br>
- <mailet match="RecipientIsLocal"
class="LocalDelivery">
</br>
<br>
- <mailet match="UserIs=root & HostIsLocal"
class="Forward">
</br>
<br>
- <mailet match="SenderIs=badBoy@myhost,badGirl@yourhost"
class="Null">
</br>
</p>
</blockquote>
</td></tr>
<tr><td><br/></td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#828DA6">
<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="Mailet"><strong>Mailet</strong></a>
</font>
</td></tr>
<tr><td><br/></td></tr>
<tr><td>
<blockquote>
<p>
Mailet are the ones performing a process on a message. They are
provided with a Mail object on which thy can perform any kind of task
and they reply with another Mail object containing the response. Wise
use of mailet allow to write any mail based application as http
application using mailet. Simple mailet provides basic mail
functionality like mail forwarding, mailing list, "I'm on vacation"
message, mail logging etc. As simply as these mailet, you can write
and deploy your own mailet to perform any kind of task.
<br>
Here you are some mailet samples with their configuration:
</br>
</p>
<b>Null</b>
<blockquote>
Destroy any incoming mail. No configuration needed.
<br>
<mailet match="SenderIs=badBoy@badhost" class="Null">
</mailet>
</br>
</blockquote>
<b>Identity</b>
<blockquote>
Leave any incoming mail untoched.Sort of debug mailet
(not really useful).
No configuration needed.
<br>
<mailet match="All" class="Identity">
</mailet></br>
</blockquote>
<b>Forward</b>
<blockquote>
Replace the recipient list with recipient specified in
configurations.<br>
<mailet match="RecipientIs=root@localhost"
class="Forward"></br>
<blockquote>
<br>
<forwardto> green@blue.org </forwardto>
</br>
<br>
<forwardto> red@yellow.com </forwardto>
</br>
</blockquote>
</mailet>
</blockquote>
<b>ToProcessor</b>
<blockquote>
Sends the incoming mail object to a new processor pipeline.
<code>root</code> and <code>error</code> are special processors that
should always be defined.
<br>
<mailet match="RecipientIsLocal" class="ToProcessor">
</br>
<blockquote>
<processor> localdelivery </processor>
</blockquote>
</mailet>
</blockquote>
<b>ServerTime</b>
<blockquote>
Replies to the sender with a short message with the current time.
No configuration needed.
<br>
<mailet match="RecipientIs=time@localhost" class="ServerTime">
</br>
</mailet>
</blockquote>
<b>ToRepository</b>
<blockquote>
Stores mails in the specified MailRepository. Useful for mail logging
etc. If the passThrough is false the mail will be destroyed, if true
it will be returned untouched to the pipe.
<br>
<mailet match="RecipientIs=root@localhost"
class="ToRepository">
</br>
<blockquote>
<br>
<repositoryPath> file://../var/mail/logAdmin
</repositoryPath>
</br>
<br>
<passThrough> true </passThrough> (default false)
</br>
</blockquote>
</mailet>
</blockquote>
<b>LocalDelivery</b>
<blockquote>
Store mail in the local inbox, one folder for each user.
<br>
<mailet match="RecipientIsLocal" class="LocalDelivery">
</br>
</mailet>
</blockquote>
<b>RemoteDelivery</b>
<blockquote>
Realy mails to remote hosts. "delayTime" is the time in mills the
mailet will wait
before retrying sending a mail which fail at first time.
"maxRetries" is the number of
retries before sending back to sender the mail.
<br>
<mailet match="!RecipientIsLocal" class="RemoteDelivery">
</br>
<blockquote>
<br>
<delayTime> 21600000 </delayTime>
</br>
<br>
<maxRetries> 5 </maxRetries>
</br>
</blockquote>
</mailet>
</blockquote>
</blockquote>
</td></tr>
<tr><td><br/></td></tr>
</table>
</blockquote>
</p>
</td></tr>
<tr><td><br/></td></tr>
</table>
</td>
</tr>
<!-- FOOTER -->
<tr><td colspan="2">
<hr noshade="" size="1"/>
</td></tr>
<tr><td colspan="2">
<div align="center"><font color="#525D76" size="-1"><em>
Copyright © 1999-2001, Apache Software Foundation
</em></font></div>
</td></tr>
</table>
</body>
</html>
<!-- end the processing -->
1.1 jakarta-james/www/listservs.html
Index: listservs.html
===================================================================
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!-- Content Stylesheet for Site -->
<!-- start the processing -->
<!-- ====================================================================== -->
<!-- Main Page Section -->
<!-- ====================================================================== -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
<meta name="author" value="Serge Knystautas">
<meta name="email" value="sergek@lokitech.com">
<title>The Jakarta James Site - James 1.2.1 - Mailets</title>
</head>
<body bgcolor="#ffffff" text="#000000" link="#525D76">
<table border="0" width="100%" cellspacing="0">
<!-- TOP IMAGE -->
<tr>
<td align="left">
<a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" border="0"/></a>
</td>
<td align="right">
<a href="http://jakarta.apache.org/james/"><img src="./images/james-logo.jpg" alt="JAMES - Java Apache Mail Enterprise Server" border="0"/></a>
</td>
</tr>
</table>
<table border="0" width="100%" cellspacing="4">
<tr><td colspan="2">
<hr noshade="" size="1"/>
</td></tr>
<tr>
<!-- LEFT SIDE NAVIGATION -->
<td valign="top" nowrap="true">
<p><strong>James</strong></p>
<ul>
<li> <a href="./index.html">Overview</a>
</li>
<li> <a href="./install.html">Install</a>
</li>
<li> <a href="./configuration_v1_2.html">Configuration</a>
</li>
<li> <a href="./architecture_v1_2.html">Architecture</a>
</li>
<li> <a href="./code-standards.html">Coding Standards</a>
</li>
<li> <a href="./license.html">License</a>
</li>
<li> <a href="./todo.html">TODO</a>
</li>
</ul>
<p><strong>Download</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/site/binindex.html">Binaries</a>
</li>
<li> <a href="http://jakarta.apache.org/site/sourceindex.html">Source Code</a>
</li>
</ul>
<p><strong>Guides</strong></p>
<ul>
<li> <a href="./mailet/index.html">Mailet API</a>
</li>
<li> <a href="./usingLDAP_v1_2.html">Using LDAP</a>
</li>
<li> <a href="./usingTown.html">Using RDBMS</a>
</li>
<li> <a href="./usingTLS_v1_2.html">Using TLS</a>
</li>
<li> <a href="./listservs.html">List Servers</a>
</li>
<li> <a href="./matchers.html">Bundled Matchers</a>
</li>
<li> <a href="http://jakarta.apache.org/james/rfclist">Useful RFCs {web}</a>
</li>
</ul>
<p><strong>Get Involved {web}</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/site/getinvolved.html">Overview</a>
</li>
<li> <a href="http://jakarta.apache.org/site/cvsindex.html">CVS Repositories</a>
</li>
<li> <a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a>
</li>
<li> <a href="http://jakarta.apache.org/site/library.html">Reference Library</a>
</li>
<li> <a href="http://jakarta.apache.org/site/bugs.html">Bug Database</a>
</li>
</ul>
<p><strong>Jakarta Essentials {web}</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/index.html">Front Page</a>
</li>
<li> <a href="http://jakarta.apache.org/site/news.html">News & Status</a>
</li>
<li> <a href="http://jakarta.apache.org/site/mission.html">Mission</a>
</li>
<li> <a href="http://jakarta.apache.org/site/guidelines.html">Guidelines Notes</a>
</li>
<li> <a href="http://jakarta.apache.org/site/faqs.html">FAQs</a>
</li>
</ul>
<p><strong>Related Projects {web}</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/ant/index.html">Ant</a>
</li>
<li> <a href="http://jakarta.apache.org/avalon/index.html">Avalon</a>
</li>
</ul>
</td>
<td align="left" valign="top">
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="Mailets"><strong>Mailets</strong></a>
</font>
</td></tr>
<tr><td><br/></td></tr>
<tr><td>
<blockquote>
<p>
Several mailets are included with James 1.2.1, they are described below.
</p>
</blockquote>
</p>
</td></tr>
<tr><td><br/></td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="Avalon Listserv"><strong>Avalon Listserv</strong></a>
</font>
</td></tr>
<tr><td><br/></td></tr>
<tr><td>
<blockquote>
<p>
<b>An Avalon-based listserv.</b>
This uses settings specified in the JAMES.conf.xml file, and uses an
Avalon UserRepository manager as the listserv members.
</p>
<p>
Required parameters:
<br>
<members> The URL to the Avalon UserRepository.
</br>
<br>
<membersonly> Either true or false. Indicates whether only
members of this listserv can send messages to it.
</br>
<br>
<attachmentsallowed> Either true or false. Indicates whether
you can send attachments to this listserv.
</br>
<br>
<replytolist> Either true or false. Indicates whether the Reply-To
header is set, which will direct replies to the list itself.
</br>
Optional parameters:
<br>
<subjectprefix> This text will be put in brackets at the beginning
of the subject of the message if specified.
</br>
</p>
</blockquote>
</p>
</td></tr>
<tr><td><br/></td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="Avalon Listserv Manager"><strong>Avalon Listserv Manager</strong></a>
</font>
</td></tr>
<tr><td><br/></td></tr>
<tr><td>
<blockquote>
<p>
<b>An Avalon-based listserv manager.</b>
Handles adding a removing members to the specified UserRepository.
</p>
<p>
Required parameters:
<br>
<members>
</br>
</p>
</blockquote>
</p>
</td></tr>
<tr><td><br/></td></tr>
</table>
</td>
</tr>
<!-- FOOTER -->
<tr><td colspan="2">
<hr noshade="" size="1"/>
</td></tr>
<tr><td colspan="2">
<div align="center"><font color="#525D76" size="-1"><em>
Copyright © 1999-2001, Apache Software Foundation
</em></font></div>
</td></tr>
</table>
</body>
</html>
<!-- end the processing -->
1.1 jakarta-james/www/usingLDAP_v1_2.html
Index: usingLDAP_v1_2.html
===================================================================
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!-- Content Stylesheet for Site -->
<!-- start the processing -->
<!-- ====================================================================== -->
<!-- Main Page Section -->
<!-- ====================================================================== -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
<meta name="author" value="Charles Benett">
<meta name="email" value="charles@benett1.demon.co.uk">
<title>The Jakarta James Site - James 1.2.1 - Using LDAP</title>
</head>
<body bgcolor="#ffffff" text="#000000" link="#525D76">
<table border="0" width="100%" cellspacing="0">
<!-- TOP IMAGE -->
<tr>
<td align="left">
<a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" border="0"/></a>
</td>
<td align="right">
<a href="http://jakarta.apache.org/james/"><img src="./images/james-logo.jpg" alt="JAMES - Java Apache Mail Enterprise Server" border="0"/></a>
</td>
</tr>
</table>
<table border="0" width="100%" cellspacing="4">
<tr><td colspan="2">
<hr noshade="" size="1"/>
</td></tr>
<tr>
<!-- LEFT SIDE NAVIGATION -->
<td valign="top" nowrap="true">
<p><strong>James</strong></p>
<ul>
<li> <a href="./index.html">Overview</a>
</li>
<li> <a href="./install.html">Install</a>
</li>
<li> <a href="./configuration_v1_2.html">Configuration</a>
</li>
<li> <a href="./architecture_v1_2.html">Architecture</a>
</li>
<li> <a href="./code-standards.html">Coding Standards</a>
</li>
<li> <a href="./license.html">License</a>
</li>
<li> <a href="./todo.html">TODO</a>
</li>
</ul>
<p><strong>Download</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/site/binindex.html">Binaries</a>
</li>
<li> <a href="http://jakarta.apache.org/site/sourceindex.html">Source Code</a>
</li>
</ul>
<p><strong>Guides</strong></p>
<ul>
<li> <a href="./mailet/index.html">Mailet API</a>
</li>
<li> <a href="./usingLDAP_v1_2.html">Using LDAP</a>
</li>
<li> <a href="./usingTown.html">Using RDBMS</a>
</li>
<li> <a href="./usingTLS_v1_2.html">Using TLS</a>
</li>
<li> <a href="./listservs.html">List Servers</a>
</li>
<li> <a href="./matchers.html">Bundled Matchers</a>
</li>
<li> <a href="http://jakarta.apache.org/james/rfclist">Useful RFCs {web}</a>
</li>
</ul>
<p><strong>Get Involved {web}</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/site/getinvolved.html">Overview</a>
</li>
<li> <a href="http://jakarta.apache.org/site/cvsindex.html">CVS Repositories</a>
</li>
<li> <a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a>
</li>
<li> <a href="http://jakarta.apache.org/site/library.html">Reference Library</a>
</li>
<li> <a href="http://jakarta.apache.org/site/bugs.html">Bug Database</a>
</li>
</ul>
<p><strong>Jakarta Essentials {web}</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/index.html">Front Page</a>
</li>
<li> <a href="http://jakarta.apache.org/site/news.html">News & Status</a>
</li>
<li> <a href="http://jakarta.apache.org/site/mission.html">Mission</a>
</li>
<li> <a href="http://jakarta.apache.org/site/guidelines.html">Guidelines Notes</a>
</li>
<li> <a href="http://jakarta.apache.org/site/faqs.html">FAQs</a>
</li>
</ul>
<p><strong>Related Projects {web}</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/ant/index.html">Ant</a>
</li>
<li> <a href="http://jakarta.apache.org/avalon/index.html">Avalon</a>
</li>
</ul>
</td>
<td align="left" valign="top">
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="James 1.2 - Using an LDAP Directory as a Users Repository"><strong>James 1.2 - Using an LDAP Directory as a Users Repository</strong></a>
</font>
</td></tr>
<tr><td><br/></td></tr>
<tr><td>
<blockquote>
<p>
This document explains how to enable JAMES to use an LDAP directory as a
Users Repository.
</p>
</blockquote>
</p>
</td></tr>
<tr><td><br/></td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="Summary"><strong>Summary</strong></a>
</font>
</td></tr>
<tr><td><br/></td></tr>
<tr><td>
<blockquote>
<p>
We have tried to make the LDAP implementation of UsersRepository as
flexible a possible, recognising that each installation will have a unique
directory schema.
<br>We assume that all users that a James Mailserver will handle fall
within one single-rooted tree. The root of this tree, ie the lowest node
in the directory which is an ancestor for all users served by this
mailserver and the mailserver, is called the LDAPRoot. (See diagram)
</br>
<br>It is entirely possible that an organization may have more than one
mail server. Consequently, the fact that a user is in the Directory does
not imply that this mailserver should handle mail for them.
</br>
<br>This implementation of UsersRepository creates one node (object) for
each set of mail users. The set called 'LocalUsers' is the set of users
whose mail is handled by this server. Other sets include any mail-lists
handled by the server. Each member of a set is recorded as an attribute
of these objects. These nodes are child nodes of the mailserver.
</br>
<br>The mailserver will accept mail for local delivery if the user part of
the email address matches a member of LocalUsers and if the domain/host
part of the email address matches the first servername .
(Set servernames autodetect to false and enter the domain served as the
first servername, e.g. apache.org).
</br>
<br>For POP3 authentication, the mailserver first finds the user entry in
the directory, underLDAPRoot, whose attribute, specified as
MailAttribute in conf, matches user@domain. The mailserver authenticates
the POP3 user if it can bind to the directory as that user entry with
the offered password.
</br>
<br>
This implementation does not set passwords in the directory. Use a dummy
password when invoking adduser in RemoteManger.
</br>
<br>
If ManageGroupAttribute is set to TRUE (as it is by default), then the
RemoteManger will add/remove the full DN of the email group to/from the
user entry. This facilty allows users to ask the directory what is my
mailserver and what email lists am I subscribed to?
</br>
</p>
<table>
<tr>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
Root of Directory
<br>Example: dc=org</br>
<br>May not be referenced in conf.xml</br>
<br>|</br>
<br>|</br>
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
</font>
</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="3" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
-------------------------------------------------------------------------------------------------
</font>
</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="3" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
<br>Subtree not served by James</br>
<br> e.g.: dc=w3c, dc=org</br>
</font>
</td>
<td bgcolor="#a0ddf0" colspan="3" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
<br>Subtree served by James</br>
<br> e.g.: dc=apache, dc=org </br>
<br>"LDAPRoot"</br>
<br>|</br>
</font>
</td>
<td bgcolor="#a0ddf0" colspan="3" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
<br>Subtree not served by James</br>
<br> e.g.: dc=xml, dc=org</br>
</font>
</td>
</tr>
<tr>
<td bgcolor="#a0ddf0" colspan="3" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
</font>
</td>
<td bgcolor="#a0ddf0" colspan="3" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
<table cellspace="0">
<tr>
<td colspan="4" align="center">----------------------------------------------------</td>
</tr>
<tr>
<td align="center" valign="top">|
<br>This mailserver </br>
<br>cn=mailserver.apache.org</br>
<br>|</br>
<br>---------------</br>
</td>
<td align="center" valign="top">|
<br>A user </br>
<br>cn=King Arthur</br>
<br> memberOfGroup=</br>
<br>cn=LocalUsers etc</br>
</td>
<td align="center" valign="top">|
<br>A user </br>
<br>cn=Morgan LeFay </br>
</td>
<td align="center" valign="top">|
<br>Another mailserver </br>
<br>cn=oldmail.apache.org</br>
</td>
</tr>
<tr>
<td>
<table cellspace="0">
<tr>
<td align="center" valign="top"> |
<br>LocalUsers</br>
<br>member=Arthur</br>
</td>
<td align="center" valign="top"> |
<br>list-james</br>
<br>member=Arthur</br>
</td>
</tr>
</table>
</td>
<td> </td>
<td> </td>
<td> </td>
</tr>
</table>
</font>
</td>
<td bgcolor="#a0ddf0" colspan="3" rowspan="" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
</font>
</td>
</tr>
</table>
</blockquote>
</p>
</td></tr>
<tr><td><br/></td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="Installation"><strong>Installation</strong></a>
</font>
</td></tr>
<tr><td><br/></td></tr>
<tr><td>
<blockquote>
<p>
Six entries in JAMES.conf.xml must be set for this to work:
<ul>
<li>change usersManager - type to ldap.</li>
<li>Set the ldapServer element to point to the correct host and port</li>
<li>Set LDAPRoot and ThsServerRDN.</li>
<li>Set the direcory FDN and password that should be used to write to the directory.</li>
<li>Unless all your users have email addresses of the form, name@the-machine-running-James, set servernames-autodetect to false and apecify the your email domain as the first servername.</li>
</ul>
</p>
</blockquote>
</p>
</td></tr>
<tr><td><br/></td></tr>
</table>
</td>
</tr>
<!-- FOOTER -->
<tr><td colspan="2">
<hr noshade="" size="1"/>
</td></tr>
<tr><td colspan="2">
<div align="center"><font color="#525D76" size="-1"><em>
Copyright © 1999-2001, Apache Software Foundation
</em></font></div>
</td></tr>
</table>
</body>
</html>
<!-- end the processing -->
1.1 jakarta-james/www/usingTLS_v1_2.html
Index: usingTLS_v1_2.html
===================================================================
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!-- Content Stylesheet for Site -->
<!-- start the processing -->
<!-- ====================================================================== -->
<!-- Main Page Section -->
<!-- ====================================================================== -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
<meta name="author" value="Charles Benett">
<meta name="email" value="charles@benett1.demon.co.uk">
<title>The Jakarta James Site - James 1.2.1 - Using TLS</title>
</head>
<body bgcolor="#ffffff" text="#000000" link="#525D76">
<table border="0" width="100%" cellspacing="0">
<!-- TOP IMAGE -->
<tr>
<td align="left">
<a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" border="0"/></a>
</td>
<td align="right">
<a href="http://jakarta.apache.org/james/"><img src="./images/james-logo.jpg" alt="JAMES - Java Apache Mail Enterprise Server" border="0"/></a>
</td>
</tr>
</table>
<table border="0" width="100%" cellspacing="4">
<tr><td colspan="2">
<hr noshade="" size="1"/>
</td></tr>
<tr>
<!-- LEFT SIDE NAVIGATION -->
<td valign="top" nowrap="true">
<p><strong>James</strong></p>
<ul>
<li> <a href="./index.html">Overview</a>
</li>
<li> <a href="./install.html">Install</a>
</li>
<li> <a href="./configuration_v1_2.html">Configuration</a>
</li>
<li> <a href="./architecture_v1_2.html">Architecture</a>
</li>
<li> <a href="./code-standards.html">Coding Standards</a>
</li>
<li> <a href="./license.html">License</a>
</li>
<li> <a href="./todo.html">TODO</a>
</li>
</ul>
<p><strong>Download</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/site/binindex.html">Binaries</a>
</li>
<li> <a href="http://jakarta.apache.org/site/sourceindex.html">Source Code</a>
</li>
</ul>
<p><strong>Guides</strong></p>
<ul>
<li> <a href="./mailet/index.html">Mailet API</a>
</li>
<li> <a href="./usingLDAP_v1_2.html">Using LDAP</a>
</li>
<li> <a href="./usingTown.html">Using RDBMS</a>
</li>
<li> <a href="./usingTLS_v1_2.html">Using TLS</a>
</li>
<li> <a href="./listservs.html">List Servers</a>
</li>
<li> <a href="./matchers.html">Bundled Matchers</a>
</li>
<li> <a href="http://jakarta.apache.org/james/rfclist">Useful RFCs {web}</a>
</li>
</ul>
<p><strong>Get Involved {web}</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/site/getinvolved.html">Overview</a>
</li>
<li> <a href="http://jakarta.apache.org/site/cvsindex.html">CVS Repositories</a>
</li>
<li> <a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a>
</li>
<li> <a href="http://jakarta.apache.org/site/library.html">Reference Library</a>
</li>
<li> <a href="http://jakarta.apache.org/site/bugs.html">Bug Database</a>
</li>
</ul>
<p><strong>Jakarta Essentials {web}</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/index.html">Front Page</a>
</li>
<li> <a href="http://jakarta.apache.org/site/news.html">News & Status</a>
</li>
<li> <a href="http://jakarta.apache.org/site/mission.html">Mission</a>
</li>
<li> <a href="http://jakarta.apache.org/site/guidelines.html">Guidelines Notes</a>
</li>
<li> <a href="http://jakarta.apache.org/site/faqs.html">FAQs</a>
</li>
</ul>
<p><strong>Related Projects {web}</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/ant/index.html">Ant</a>
</li>
<li> <a href="http://jakarta.apache.org/avalon/index.html">Avalon</a>
</li>
</ul>
</td>
<td align="left" valign="top">
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="James 1.2.1 - Using TLS"><strong>James 1.2.1 - Using TLS</strong></a>
</font>
</td></tr>
<tr><td><br/></td></tr>
<tr><td>
<blockquote>
<p>
This document explains how to enable JAMES 1.2.1 to use Transport Layer
Security (TLS) (ie SSL).
</p>
</blockquote>
</p>
</td></tr>
<tr><td><br/></td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="Obtain JSSE"><strong>Obtain JSSE</strong></a>
</font>
</td></tr>
<tr><td><br/></td></tr>
<tr><td>
<blockquote>
<p>
Obtain JSSE source from java.sun.com. Follow their installation directions.
We assume that you install JSSE as a standard extension, with a static
provider definition. (See notes with JSSE distribution)
</p>
<p>
Note that the US export restrictions still apply to JSSE
(at version 1.0.2), so while both the international and domestic versions
offer the same level of crypto, the international version does not take
alternative providers.
</p>
</blockquote>
</p>
</td></tr>
<tr><td><br/></td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="Enable TLS"><strong>Enable TLS</strong></a>
</font>
</td></tr>
<tr><td><br/></td></tr>
<tr><td>
<blockquote>
<p>
Using JAMES with TLS. You need to do three things over and above the
normal operation of James:
<ul>
<li>In Avalon.conf.xml, uncomment the TLS listener defintion.</li>
<li>In JAMES.conf.xml, uncomment the <useTLS>TRUE</useTLS> element
for the service you want to use TLS. It is currently available for
remote manager and POP3. (If using POP3 over TLS, it is probably best
to change port to 995, which is the IANA designated POP3S port).</li>
<li> Ensure that avalonTestKeys is in the conf directory. You may need
to manually extract this from the Avalon.jar (with: jar xvf Avalon.jar
conf/avalonTestKeys). Note that this is a self-signed certificate for
test purposes only. You can specify a different server certificate in
the Avalon.conf.xml file.</li>
</ul>
</p>
<p>
Start James
</p>
</blockquote>
</p>
</td></tr>
<tr><td><br/></td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="Verify TLS-enabled JAMES"><strong>Verify TLS-enabled JAMES</strong></a>
</font>
</td></tr>
<tr><td><br/></td></tr>
<tr><td>
<blockquote>
<p>
(Positive Test) Use an SSL client to open a socket to the appropriate port.
I used openssl from www.openssl.org to test this.
E.g. openssl s_client -connect localhost:4555. You should see the normal
remote manager or POP3 server greeting and have normal operation.
<br>
- If, using openssl s_client, you get a connection refused/ error no
111, just try again. This probably means you got to the port before it
was ready.
</br>
</p>
<p>
(Negative Test) telnet to port 4555 (ie without SSL). This should hang the
telnet client. It should also lock port 4555 until the connection timesout,
I think.
</p>
</blockquote>
</p>
</td></tr>
<tr><td><br/></td></tr>
</table>
</td>
</tr>
<!-- FOOTER -->
<tr><td colspan="2">
<hr noshade="" size="1"/>
</td></tr>
<tr><td colspan="2">
<div align="center"><font color="#525D76" size="-1"><em>
Copyright © 1999-2001, Apache Software Foundation
</em></font></div>
</td></tr>
</table>
</body>
</html>
<!-- end the processing -->
1.1 jakarta-james/www/usingTown.html
Index: usingTown.html
===================================================================
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!-- Content Stylesheet for Site -->
<!-- start the processing -->
<!-- ====================================================================== -->
<!-- Main Page Section -->
<!-- ====================================================================== -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
<meta name="author" value="Serge Knystautas">
<meta name="email" value="sergek@lokitech.com">
<title>The Jakarta James Site - James 1.2.1 - RDBMS support via Town</title>
</head>
<body bgcolor="#ffffff" text="#000000" link="#525D76">
<table border="0" width="100%" cellspacing="0">
<!-- TOP IMAGE -->
<tr>
<td align="left">
<a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" border="0"/></a>
</td>
<td align="right">
<a href="http://jakarta.apache.org/james/"><img src="./images/james-logo.jpg" alt="JAMES - Java Apache Mail Enterprise Server" border="0"/></a>
</td>
</tr>
</table>
<table border="0" width="100%" cellspacing="4">
<tr><td colspan="2">
<hr noshade="" size="1"/>
</td></tr>
<tr>
<!-- LEFT SIDE NAVIGATION -->
<td valign="top" nowrap="true">
<p><strong>James</strong></p>
<ul>
<li> <a href="./index.html">Overview</a>
</li>
<li> <a href="./install.html">Install</a>
</li>
<li> <a href="./configuration_v1_2.html">Configuration</a>
</li>
<li> <a href="./architecture_v1_2.html">Architecture</a>
</li>
<li> <a href="./code-standards.html">Coding Standards</a>
</li>
<li> <a href="./license.html">License</a>
</li>
<li> <a href="./todo.html">TODO</a>
</li>
</ul>
<p><strong>Download</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/site/binindex.html">Binaries</a>
</li>
<li> <a href="http://jakarta.apache.org/site/sourceindex.html">Source Code</a>
</li>
</ul>
<p><strong>Guides</strong></p>
<ul>
<li> <a href="./mailet/index.html">Mailet API</a>
</li>
<li> <a href="./usingLDAP_v1_2.html">Using LDAP</a>
</li>
<li> <a href="./usingTown.html">Using RDBMS</a>
</li>
<li> <a href="./usingTLS_v1_2.html">Using TLS</a>
</li>
<li> <a href="./listservs.html">List Servers</a>
</li>
<li> <a href="./matchers.html">Bundled Matchers</a>
</li>
<li> <a href="http://jakarta.apache.org/james/rfclist">Useful RFCs {web}</a>
</li>
</ul>
<p><strong>Get Involved {web}</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/site/getinvolved.html">Overview</a>
</li>
<li> <a href="http://jakarta.apache.org/site/cvsindex.html">CVS Repositories</a>
</li>
<li> <a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a>
</li>
<li> <a href="http://jakarta.apache.org/site/library.html">Reference Library</a>
</li>
<li> <a href="http://jakarta.apache.org/site/bugs.html">Bug Database</a>
</li>
</ul>
<p><strong>Jakarta Essentials {web}</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/index.html">Front Page</a>
</li>
<li> <a href="http://jakarta.apache.org/site/news.html">News & Status</a>
</li>
<li> <a href="http://jakarta.apache.org/site/mission.html">Mission</a>
</li>
<li> <a href="http://jakarta.apache.org/site/guidelines.html">Guidelines Notes</a>
</li>
<li> <a href="http://jakarta.apache.org/site/faqs.html">FAQs</a>
</li>
</ul>
<p><strong>Related Projects {web}</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/ant/index.html">Ant</a>
</li>
<li> <a href="http://jakarta.apache.org/avalon/index.html">Avalon</a>
</li>
</ul>
</td>
<td align="left" valign="top">
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="James 1.2.1 - RDBMS support via Town"><strong>James 1.2.1 - RDBMS support via Town</strong></a>
</font>
</td></tr>
<tr><td><br/></td></tr>
<tr><td>
<blockquote>
<p>
This document explains how to enable JAMES to use a database to store mail
messages for spools, user accounts, and other usages.
</p>
</blockquote>
</p>
</td></tr>
<tr><td><br/></td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="Obtain a JDBC driver"><strong>Obtain a JDBC driver</strong></a>
</font>
</td></tr>
<tr><td><br/></td></tr>
<tr><td>
<blockquote>
<p>
Obtain a suitable JDBC driver for a suitable vendor. A non-production
grade JDBC-ODBC is included in the JDK, and many commercial and free
drivers are available. See
<a href="http://java.sun.com/products/jdbc/drivers/">http://java.sun.com/products/jdbc/drivers/</a>
for a list of suitable drivers. JAMES uses the Town library
(<a href="http://www.working-dogs.com/town/">http://www.working-dogs.com/town/</a>)
to access a database, and you can use any JDBC 1.X or greater compliant
database driver. Town also handles connection pooling.
</p>
<p>
Note that as JAMES will repeatedly send large amounts of text and binary
across this driver, we recommend production grade drivers whenever
possible.
</p>
</blockquote>
</p>
</td></tr>
<tr><td><br/></td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="Define a database connection"><strong>Define a database connection</strong></a>
</font>
</td></tr>
<tr><td><br/></td></tr>
<tr><td>
<blockquote>
<p>
In the <i>var</i> directory of the JAMES distribution, you will find
several sample database connection definition files. These are sample
Properties files that define the necessary information to connect to a
database. You may either rename one of these to <i>maildatabase</i>, or
you may create your own database connection definition file. Important
properties to set are the driver classname, the JDBC URL, and the username
and password.
</p>
</blockquote>
</p>
</td></tr>
<tr><td><br/></td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="Create a table in your database"><strong>Create a table in your database</strong></a>
</font>
</td></tr>
<tr><td><br/></td></tr>
<tr><td>
<blockquote>
<p>
JAMES expects to use a table named "Message" in whatever database you've
specified. Sample SQL scripts to create this table in SQL Server and
MySQL are available in this docs directory. If you are using another
database, you can hopefully see the necessary structure and can create it
for your database. Please submit these to us! (we'll include them in
future distributions)
</p>
</blockquote>
</p>
</td></tr>
<tr><td><br/></td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="Enable a Database Mail Repository"><strong>Enable a Database Mail Repository</strong></a>
</font>
</td></tr>
<tr><td><br/></td></tr>
<tr><td>
<blockquote>
<p>
After the bootstrap startup, when you edit the JAMES.conf.xml file, you
will see several places that specify a mail or spool repository.
Commented out next to several of these entries are alternate settings to
use the database connection definition defined above.
</p>
<p>
The format of the URL to use the database mail or spool repository is
town://<repositoryname>@<conndef-filename> The alternate
settings for the database repository expect the filename to be
<i>maildatabase</i>, which is why above we recommended you rename it.
</p>
</blockquote>
</p>
</td></tr>
<tr><td><br/></td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="Verify JAMES establishes a database connection"><strong>Verify JAMES establishes a database connection</strong></a>
</font>
</td></tr>
<tr><td><br/></td></tr>
<tr><td>
<blockquote>
<p>
In the bin directory where run.bat and run.sh (or whatever directory you
were in when you started JAMES), you should see a file named something
like DCB_970616938320.log. If this file does not exist, JAMES was unable
to find the connection definition file or it was unable to find the
database driver.
</p>
<p>
Open this file, and you will see the server's attempt to connect to the
server. If successful, you will see the log shows one or two open
connections were established. If you are seeing repeated attempts to
reconnect to the database, either the JDBC URL is incorrect, or the
username and password are incorrect.
</p>
</blockquote>
</p>
</td></tr>
<tr><td><br/></td></tr>
</table>
</td>
</tr>
<!-- FOOTER -->
<tr><td colspan="2">
<hr noshade="" size="1"/>
</td></tr>
<tr><td colspan="2">
<div align="center"><font color="#525D76" size="-1"><em>
Copyright © 1999-2001, Apache Software Foundation
</em></font></div>
</td></tr>
</table>
</body>
</html>
<!-- end the processing -->
---------------------------------------------------------------------
To unsubscribe, e-mail: james-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: james-dev-help@jakarta.apache.org