noel 2002/11/01 18:55:36
Modified: www FAQ.html
src/xdocs FAQ.xml
Log:
Added FAQ item for MSSQL JDBC driver. Thanks to Serge Sozonoff
Revision Changes Path
1.17 +896 -866 jakarta-james/www/FAQ.html
Index: FAQ.html
===================================================================
RCS file: /home/cvs/jakarta-james/www/FAQ.html,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- FAQ.html 30 Aug 2002 15:22:17 -0000 1.16
+++ FAQ.html 2 Nov 2002 02:55:36 -0000 1.17
@@ -1,866 +1,896 @@
-<html>
-<head>
-<META http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
-<title>Jakarta James - Frequently Asked Questions</title>
-<meta value="Danny Angus" name="author">
-<meta value="[EMAIL PROTECTED]" name="email">
-<LINK TITLE="Style" HREF="stylesheet.css" TYPE="text/css" REL="stylesheet">
-</head>
-<body vlink="#525D76" alink="#525D76" link="#525D76" text="#000000"
bgcolor="#ffffff">
-<table cellspacing="4" width="100%" border="0">
-<!--PAGE HEADER-->
-<tr>
-<td colspan="2">
-<!--JAKARTA LOGO--><a href="http://jakarta.apache.org/";><img border="0" alt="The
Jakarta Project" align="left"
src="http://jakarta.apache.org/images/jakarta-logo.gif";></a>
-<!--PROJECT LOGO--><a href="http://jakarta.apache.org/james/";><img border="0"
alt="JAMES - Java Apache Mail Enterprise Server" align="right"
src="http://jakarta.apache.org/james///images/james-logo.jpg";></a></td>
-</tr>
-<!--HEADER SEPARATOR-->
-<tr>
-<td colspan="2">
-<hr size="1" noshade="">
-</td>
-</tr>
-<tr>
-<!--LEFT SIDE NAVIGATION-->
-<td nowrap="true" valign="top" width="20%">
-<p>
-<strong>James</strong>
-</p>
-<ul>
-<li>
-<a href="./index.html">Overview</a>
-</li>
-<li>
-<a href="./architecture_v2_0.html">Architecture</a>
-</li>
-<li>
-<a href="./FAQ.html">James FAQ</a>
-</li>
-</ul>
-<p>
-<strong>Translated</strong>
-</p>
-<ul>
-<li>
-<a href="http://www.terra-intl.com/jakarta/james/";>Japanese (web)</a>
-</li>
-</ul>
-<p>
-<strong>Downloads</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>Documentation</strong>
-</p>
-<ul>
-<li>
-<a href="./install.html">Install</a>
-</li>
-<li>
-<a href="./configuration_v2_0.html">Configuration</a>
-</li>
-<li>
-<a href="./javadocs/index.html">James API</a>
-</li>
-<li>
-<a href="./mailet/index.html">Mailet API</a>
-</li>
-<li>
-<a href="./usingJDBC_v2.0.html">Using JDBC</a>
-</li>
-<li>
-<a href="./usingLDAP_v1_2.html">Using LDAP</a>
-</li>
-<li>
-<a href="./usingTLS_v1_2.html">Using TLS</a>
-</li>
-<li>
-<a href="./james_and_sendmail.html">James and sendmail</a>
-</li>
-<li>
-<a href="http://jakarta.apache.org/james/rfclist";>Useful RFCs (web)</a>
-</li>
-</ul>
-<p>
-<strong>Project</strong>
-</p>
-<ul>
-<li>
-<a href="http://jakarta.apache.org/site/bugs.html";>Bug Database </a>
-</li>
-<li>
-<a href="./contribute.html">How Can I Contribute?</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>
-<li>
-<a href="./changelog.html">Changelog</a>
-</li>
-<li>
-<a href="./weare.html">Who We Are</a>
-</li>
-</ul>
-<p>
-<strong>Jakarta Information (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/mail.html";>Mailing Lists</a>
-</li>
-<li>
-<a href="http://jakarta.apache.org/site/getinvolved.html";>Get Involved</a>
-</li>
-<li>
-<a href="http://jakarta.apache.org/site/cvsindex.html";>CVS Repositories</a>
-</li>
-<li>
-<a href="http://jakarta.apache.org/site/library.html";>Reference Library</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>
-<!--RIGHT SIDE MAIN BODY--><td align="left" valign="top" width="80%">
-<table width="100%" cellpadding="2" cellspacing="0" border="0">
-<tr>
-<td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a
name="This%20FAQ"><strong>This FAQ</strong></a></font></td>
-</tr>
-<tr>
-<td>
-<blockquote>
-
-<P>This is a living document that provides answers to common questions about James,
installation, configuration, admin and running not already answered in the
documentation. Last Updated August 2002.</P>
-
-</blockquote>
-</td>
-</tr>
-</table>
-<table width="100%" cellpadding="2" cellspacing="0" border="0">
-<tr>
-<td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a
name="Questions"><strong>Questions</strong></a></font></td>
-</tr>
-<tr>
-<td>
-<blockquote>
-
-<p>
-
-<ul>
-
-<li>
-
-<a href="#1">Would you please teach me how to set up a mailing list</a>
-
-</li>
-
-<li>
-
-<a href="#2">Is James an Open Relay for Spam?</a>
-
-</li>
-
-<li>
-
-<a href="#3">I can send messages to James, but nobody is receiving them. What do I
do?</a>
-
-</li>
-
-<li>
-
-<a href="#4">I can send people messages via James, but nobody can send me messages.
What do I do?</a>
-
-</li>
-
-<li>
-
-<a href="#5">I'm trying to debug messages that James is trying to deliver. Where
should I look?</a>
-
-</li>
-
-<li>
-
-<a href="#6">What about IMAP support?</a>
-
-</li>
-
-<li>
-
-<a href="#7">What about support virtual hosting?</a>
-
-</li>
-
-<li>
-
-<a href="#8">Where do I stick classes and jars?</a>
-
-</li>
-
-<li>
-
-<a href="#9">How do I upgrade to a newer version of James?</a>
-
-</li>
-
-<li>
-
-<a href="#10">How do I run James as an NT/2k/XP service?</a>
-
-</li>
-
-<li>
-
-<a href="#11">Why isn't my mailet making changes to a MimeMessage?</a>
-
-</li>
-
-<li>
-
-<a href="#12">How to remove unneeded services like NNTP, POP3?</a>
-
-</li>
-
-<li>
-
-<a href="#13">How can I contribute to James?</a>
-
-</li>
-
-<li>
-
-<a href="#14">How can I make sendmail route local mail (or all mail) through James
on the same machine?</a>
-
-</li>
-
-</ul>
-
-</p>
-
-</blockquote>
-</td>
-</tr>
-</table>
-<table width="100%" cellpadding="2" cellspacing="0" border="0">
-<tr>
-<td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a
name="Answers"><strong>Answers</strong></a></font></td>
-</tr>
-<tr>
-<td>
-<blockquote>
-
-<a name="1"></a>
-
-<table width="100%" cellpadding="2" cellspacing="0" border="0">
-<tr>
-<td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a
name="Would%20you%20please%20teach%20me%20how%20to%20set%20up%20a%20mailing%20list"><strong>Would
you please teach me how to set up a mailing list</strong></a></font></td>
-</tr>
-<tr>
-<td>
-<blockquote>
-
-<p>James currently (v2.0a3) includes only the most basic list functionality, users
can subscribe and unsubscribe, but there is no moderation of messages or
subscriptions</p>
-
-<p>To enable a list you need the following in config.xml in the root processor
block and above the final mailet block -</p>
-
-<div align="left">
-<table border="0" cellpadding="0" cellspacing="4">
-<tr>
-<td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td
height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
-</tr>
-<tr>
-<td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1"
width="1" src="/images/void.gif"></td><td height="1" bgcolor="#ffffff">
-<pre>
-<mailet match="CommandForListserv=james@localhost"
- class="AvalonListservManager">
- <repositoryName>list-james</repositoryName>
-</mailet>
-</pre>
-</td><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
-</tr>
-<tr>
-<td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td
height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
-</tr>
-</table>
-</div>
-
-<p>that will intercept the command emails sent to
-<ul>
-
-<li>james-on@localhost to subscribe the sender</li>
-
-<li>james-off@localhost to unsubscribe the sender</li>
-
-</ul>
-
-</p>
-
-<p>and-</p>
-
-<div align="left">
-<table border="0" cellpadding="0" cellspacing="4">
-<tr>
-<td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td
height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
-</tr>
-<tr>
-<td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1"
width="1" src="/images/void.gif"></td><td height="1" bgcolor="#ffffff">
-<pre>
-<mailet match="RecipientIs=james@localhost" class="AvalonListserv">
- <membersonly> false </membersonly>
- <attachmentsallowed> true </attachmentsallowed>
- <replytolist> true </replytolist>
- <repositoryName>list-james</repositoryName>
- <subjectprefix>JamesList</subjectprefix>
-</mailet>
-</pre>
-</td><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
-</tr>
-<tr>
-<td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td
height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
-</tr>
-</table>
-</div>
-
-<p>Which will distribute the mail to the current subscribers</p>
-
-<p>in addition to the above you need to have a repository configured in the
users-store block(usually near the bottom of config.xml) like so (database)-</p>
-
-<div align="left">
-<table border="0" cellpadding="0" cellspacing="4">
-<tr>
-<td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td
height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
-</tr>
-<tr>
-<td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1"
width="1" src="/images/void.gif"></td><td height="1" bgcolor="#ffffff">
-<pre>
-<repository name="list-james"
- class="org.apache.james.userrepository.ListUsersJdbcRepository"
- destinationURL="db://maildb/lists/list-james">
- <sqlFile>file://conf/sqlResources.xml</sqlFile>
-</repository>
-</pre>
-</td><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
-</tr>
-<tr>
-<td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td
height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
-</tr>
-</table>
-</div>
-
-<p>Database users will also need to ensure that they have configured a data-source
named to match the destination URL</p>
-
-<p>Using the filesystem:-</p>
-
-<div align="left">
-<table border="0" cellpadding="0" cellspacing="4">
-<tr>
-<td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td
height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
-</tr>
-<tr>
-<td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1"
width="1" src="/images/void.gif"></td><td height="1" bgcolor="#ffffff">
-<pre>
-<repository name="list-james"
- class="org.apache.james.userrepository.UsersFileRepository">
- <destination URL="file://var/lists/list-james/"/>
-</repository>
-</pre>
-</td><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
-</tr>
-<tr>
-<td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td
height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
-</tr>
-</table>
-</div>
-
-<p>Restart James, send a mail to james-on@localhost and you should be
subscribed.</p>
-
-<p>The repository, be it a database table or directory in the filesystem will be
created automatically.</p>
-
-<p>Database users can manipulate the users repository using SQL, and hence any
application capable of running SQL queries against it.<br>Danny Angus</p>
-
-</blockquote>
-</td>
-</tr>
-</table>
-
-<a name="2"></a>
-
-<table width="100%" cellpadding="2" cellspacing="0" border="0">
-<tr>
-<td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a
name="James%20seems%20to%20be%20an%20open%20relay%20for%20Spam,%20is%20it?"><strong>James
seems to be an open relay for Spam, is it?</strong></a></font></td>
-</tr>
-<tr>
-<td>
-<blockquote>
-
-<p>In some simple tests of mail relays James appears to be an open relay, properly
configured it is not. </p>
-
-<p>Because James is an email application platform it currently accepts all mail
delivered to it via SMTP for processing. Only after the mail has been recieved does
this processing begin.</p>
-
-<p>This means that James accepts Spam. However the default configuration, and any
sensible re-configuration has a number of anti-spam measures which will prevent the
re-transmisson of spam from James. This makes it a blackhole for spam.</p>
-
-<p>This also means that James will not verify addresses, but of course this means
that valid addresses can't be harvested from James by spammers either.<br>Danny
Angus</p>
-
-</blockquote>
-</td>
-</tr>
-</table>
-
-<a name="3"></a>
-
-<table width="100%" cellpadding="2" cellspacing="0" border="0">
-<tr>
-<td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a
name="I%20can%20send%20messages%20to%20James,%20but%20nobody%20is%20receiving%20them.%20%20What%20do%20I%20do?"><strong>I
can send messages to James, but nobody is receiving them. What do I
do?</strong></a></font></td>
-</tr>
-<tr>
-<td>
-<blockquote>
-
-<p>Check that you've added valid DNS servers to your James installation. Email
delivery requires the use of special mail related DNS information (MX records), so
James needs to explicitly be given DNS servers. Look at your config.xml file for a
<dnsserver> section and add one or more DNS servers. Serge Knystautas</p>
-
-<p>Additionally, check the RemoteAddrNotInNetwork matcher under<processor
name="transport">. By default it looks like this:</p>
-
-<div align="left">
-<table border="0" cellpadding="0" cellspacing="4">
-<tr>
-<td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td
height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
-</tr>
-<tr>
-<td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1"
width="1" src="/images/void.gif"></td><td height="1" bgcolor="#ffffff">
-<pre>
-<mailet match="RemoteAddrNotInNetwork=127.0.0.1" class="ToProcessor">
- <processor> spam </processor>
-</mailet>
-</pre>
-</td><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
-</tr>
-<tr>
-<td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td
height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
-</tr>
-</table>
-</div>
-
-<p>because most mail programs will use the external IP address (as opposed to
127.0.0.1) when processing mail, you need to add your internal network and/or your
static IP address to this list. You may also use a DNS domain name in this list. The
resulting entry would look something like this:</p>
-
-<div align="left">
-<table border="0" cellpadding="0" cellspacing="4">
-<tr>
-<td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td
height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
-</tr>
-<tr>
-<td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1"
width="1" src="/images/void.gif"></td><td height="1" bgcolor="#ffffff">
-<pre>
-<mailet match="RemoteAddrNotInNetwork=127.0.0.1,192.168.1.*"
- class="ToProcessor">
- <processor> spam </processor>
-</mailet>
-</pre>
-</td><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
-</tr>
-<tr>
-<td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td
height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
-</tr>
-</table>
-</div>
-
-<p>This tells the processor that anything not in this address list should go to the
spam processor.</p>
-
-<p>Please note that if you wish to configure James to allow users to send email
from any domain or IP address you will need to disable this matcher. In this
situation you must use SMTP AUTH to ensure that your server does not act as an open
relay. For more on open relays, please see <a href="http://www.ordb.org";>the Open
Relay Database</a>.</p>
-
-</blockquote>
-</td>
-</tr>
-</table>
-
-<a name="4"></a>
-
-<table width="100%" cellpadding="2" cellspacing="0" border="0">
-<tr>
-<td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a
name="I%20can%20send%20people%20messages%20via%20James,%20but%20nobody%20can%20send%20me%20messages.%20%20What%20do%20I%20do?"><strong>I
can send people messages via James, but nobody can send me messages. What do I
do?</strong></a></font></td>
-</tr>
-<tr>
-<td>
-<blockquote>
-
-<p>You need to do one of two things:
- <ol>
-
-<li>Update your domain's DNS entries so there are MX records that point to the
machine that is running James. Note that it is illegal for MX records to point to IP
addresses. You need to point MX records to a valid CNAME or A name entry, and then
map that eventually to an IP address.</li>
-
-<li>You could alternatively give people an email address with IP addresses. Most
people will think it's a very strange email address, but hello@[192.168.0.1] is a
valid email address. Note that you need to wrap the IP address in brackets.</li>
-
-</ol>
- Serge Knystautas</p>
-
-</blockquote>
-</td>
-</tr>
-</table>
-
-<a name="5"></a>
-
-<table width="100%" cellpadding="2" cellspacing="0" border="0">
-<tr>
-<td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a
name="I'm%20trying%20to%20debug%20messages%20that%20James%20is%20trying%20to%20deliver.%20%20Where%20should%20I%20look?"><strong>I'm
trying to debug messages that James is trying to deliver. Where should I
look?</strong></a></font></td>
-</tr>
-<tr>
-<td>
-<blockquote>
-
-<p>First step is to look in the log directory at the James.Mailet.log file. Look
for entries that include the text "RemoteDelivery". This should provide some
high-level debug information of James's attempt to delivery mail remotely.</p>
-
-<p>If you want to delve into the code, look at the RemoteDelivery mailet. You may
also want to review the mail repository source code for the repository type you are
using (file, db, etc...).<br>Serge Knystautas</p>
-
-</blockquote>
-</td>
-</tr>
-</table>
-
-<a name="6"></a>
-
-<table width="100%" cellpadding="2" cellspacing="0" border="0">
-<tr>
-<td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a
name="What%20about%20IMAP%20support?"><strong>What about IMAP
support?</strong></a></font></td>
-</tr>
-<tr>
-<td>
-<blockquote>
-
-<p>Unfortunately IMAP support is currently stalled. There is a proposal in CVS,
but IMAP is a significantly more complex than other mail protocols, both from a
protocol command support and in terms of complexity you need on the server. If you
are interested in taking the proverbial ball and running with it, we would all very
much appreciated. (I personally am incredibly frustrated with an old Netscape Mail
server, but I've sworn myself to upgrade only to James's IMAP once ready as
incentive.)
- <br>Serge Knystautas</p>
-
-<p>An update to Serge's comment: the IMAP server has recently attracted new
interest. We are hopeful that we will be able to provide basic IMAP support in James
2.1<br>Peter M. Goldstein</p>
-
-</blockquote>
-</td>
-</tr>
-</table>
-
-<a name="7"></a>
-
-<table width="100%" cellpadding="2" cellspacing="0" border="0">
-<tr>
-<td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a
name="What%20about%20support%20virtual%20hosting?"><strong>What about support virtual
hosting?</strong></a></font></td>
-</tr>
-<tr>
-<td>
-<blockquote>
-
-<p>Virtual hosting is something the developers are still wrestling with. The
challenge is that POP3 does not support virtual hosting in that it does not have a
command to indicate what domain the user is in. What this means is the mail server
needs to develop a 'mapping' or 'translation', e.g., '[EMAIL PROTECTED]' gets a
username 'domaina.user1'. This allows the mail server to have a single username
namespace. We have seen a few good proposals put forward, but nothing that seemed the
clear solution as ideally we could have this part solve the next issue.</p>
-
-<p>Beyond that, James needs to refine virtual hosting for mailet processing. The
mailet API has a Mail.getUser() method that no longer would be useable as a reliable
indicator of whether they were in the local username namespace. To date we are
unclear of the best way to bring this translation into the mailet processing.
Similarly, it would be nice to support different mailet processing based on the
domain, although this is somewhat feasible using the limited processing flow offered
with a HostIs/ForwardTo combination.</p>
-
-<p>This is one of the most requested feature, so hopefully this will be resolved
soon.
- <br>Serge Knystautas</p>
-
-</blockquote>
-</td>
-</tr>
-</table>
-
-<a name="8"></a>
-
-<table width="100%" cellpadding="2" cellspacing="0" border="0">
-<tr>
-<td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a
name="Where%20do%20I%20stick%20classes%20and%20jars?"><strong>Where do I stick classes
and jars?</strong></a></font></td>
-</tr>
-<tr>
-<td>
-<blockquote>
-
-<p>We are largely reliant on what Avalon is doing in terms of classloading, but
here are a few tips and suggestions:
- <ul>
-
-<li>Stick jars in the james/lib directory and add them to the classpath in run.bat
or run.sh.</li>
-
-<li>Custom mailets and matchers must be included in the james.bar (which is just a
zip like a jar or war file).</li>
-
-</ul>
- Eventually we hope to support mailet reloading and a special lib and classes
directory within the james directory that custom mailets can load from, but for now
these are hopefully some useful tips.
- <br>Serge Knystautas</p>
-
-</blockquote>
-</td>
-</tr>
-</table>
-
-<a name="9"></a>
-
-<table width="100%" cellpadding="2" cellspacing="0" border="0">
-<tr>
-<td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a
name="How%20do%20I%20upgrade%20to%20a%20newer%20version%20of%20James?"><strong>How do
I upgrade to a newer version of James?</strong></a></font></td>
-</tr>
-<tr>
-<td>
-<blockquote>
-
-<p>
-
-<ol>
-
-<li>Rename the previous james directory into a james.old</li>
-
-<li>Run phoenix to let the new james.sar be deployed.</li>
-
-<li>Copy config.xml from james.old to the new deployed james/conf directory</li>
-
-<li>Replace the var directory by the previous var directory. This will copy over
user accounts, inboxes, spools, and whatever else.</li>
-
-<li>Restart James.</li>
-
-</ol>
- Daniel Herlemont
- </p>
-
-</blockquote>
-</td>
-</tr>
-</table>
-
-<a name="10"></a>
-
-<table width="100%" cellpadding="2" cellspacing="0" border="0">
-<tr>
-<td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a
name="How%20do%20I%20run%20James%20as%20an%20NT/2k/XP%20service?"><strong>How do I run
James as an NT/2k/XP service?</strong></a></font></td>
-</tr>
-<tr>
-<td>
-<blockquote>
-
-<p>You can use Alexandria will setup/run JAMES on NT/2k/XP</p>
-
-<p>I created a .bat file called InstallJamesNTService.bat containing the
-following (I used the Alexandria tomcat.bat file as my template, as you can
-see):</p>
-
-<div align="left">
-<table border="0" cellpadding="0" cellspacing="4">
-<tr>
-<td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td
height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
-</tr>
-<tr>
-<td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1"
width="1" src="/images/void.gif"></td><td height="1" bgcolor="#ffffff">
-<pre>
-
- @echo off
- echo --------
- echo Usage: %0 jdk_home james_home (classic/hotspot/server)
- echo NOTE: You MAY NOT use spaces in the path names.
- echo JDK 1.3 does not come with hotpot server by default, you must
- echo install this separately if you wish to use it.
- echo Example: %0 c:\progra~1\jdk c:\progra~1\james classic
- echo --------
-
- if "%1" == "" goto eof
- if "%2" == "" goto eof
- if "%3" == "" goto eof
-
- copy JavaService.exe %2\bin\James.exe > nul
- %2\bin\James.exe -install JamesMailServer
- rem put the following command all on one line
- %1\jre\bin\%3\jvm.dll -Djava.ext.dirs=%2\lib
- -Djava.class.path=%CLASSPATH%;%2\bin\phoenix-loader.jar;
- %2\bin\phoenix-engine.jar
- -start org.apache.avalon.phoenix.launcher.Main
- -out %2\logs\stdout.log -err %2\logs\stderr.log
-
- goto eof
-
- :eof
- </pre>
-</td><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
-</tr>
-<tr>
-<td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td
height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
-</tr>
-</table>
-</div>
-
-<p>
- I created another .bat file called UnistallJamesNTService containing the
following 1 line:
- </p>
-
-<div align="left">
-<table border="0" cellpadding="0" cellspacing="4">
-<tr>
-<td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td
height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
-</tr>
-<tr>
-<td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1"
width="1" src="/images/void.gif"></td><td height="1" bgcolor="#ffffff">
-<pre>
- James -uninstall JamesMailServer
- </pre>
-</td><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
-</tr>
-<tr>
-<td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td
height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
-</tr>
-</table>
-</div>
-
-<p>By copying the 2 above .bat files and the JavaService.exe (follow the download
link at http://www.alexandriasc.com/software/JavaService/index.html) to the
[james]\bin folder, I am able to install and uninstall the JamesMailServer NT service!
- <br>Taken from
http://www.mail-archive.com/james-user@;jakarta.apache.org/msg01389.html by Steve Belt
- </p>
-
-</blockquote>
-</td>
-</tr>
-</table>
-
-<a name="11"></a>
-
-<table width="100%" cellpadding="2" cellspacing="0" border="0">
-<tr>
-<td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a
name="Why%20isn't%20my%20mailet%20making%20changes%20to%20a%20MimeMessage?"><strong>Why
isn't my mailet making changes to a MimeMessage?</strong></a></font></td>
-</tr>
-<tr>
-<td>
-<blockquote>
-
-<p>Check the JavaMail docs... I don't think I would have designed it this way, but
per the API, when you call MimeMessage.setContent(blah), you have to call
saveChanges() to apply your changes. James tries to automatically call this method so
you don't have to, but in certain cases you'll still have to call saveChanges().
- <br>
- Serge Knystautas
- </p>
-
-</blockquote>
-</td>
-</tr>
-</table>
-
-<a name="12"></a>
-
-<table width="100%" cellpadding="2" cellspacing="0" border="0">
-<tr>
-<td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a
name="How%20to%20remove%20unneeded%20services%20like%20NNTP,%20POP3?"><strong>How to
remove unneeded services like NNTP, POP3?</strong></a></font></td>
-</tr>
-<tr>
-<td>
-<blockquote>
-
-<p>The following information is based on James 2.0a3, but the
- upcoming 2.1 version should be similar.</p>
-
-<p>NNTP and other underlying services are called "blocks" in the
- Avalon Phoenix terminology. Blocks are specified in the
- assembly.xml file which is under the apps/james/conf directory in
- 2.0a3 and apps\james\SAR-INF in 2.1. Note: this file is created
- during the first startup of James.</p>
-
-<p>There are dependencies between the blocks, which you can read from
- the file. For example the SMTP Server block depends on the
- users-store block, so if you want SMTP then you cannot remove the
- users-store block even if you only want to relay messages.</p>
-
-<p>To remove the NNTP Server comment out the following blocks:
- NNTP server, NNTP Authentication Service, NNTP repository.
- To remove the POP3 Server comment out the POP3 Server block.</p>
-
-<p>If you remove a block it wont't be loaded next time you restart
- James. You must also remove all sections related to the removed
- blocks from the James configuration file - config.xml - otherwise
- you will get error messages, saying that there is no corresponding
- block.<br>
- Hontvari Jozsef</p>
-
-</blockquote>
-</td>
-</tr>
-</table>
-
-<a name="13"></a>
-
-<table width="100%" cellpadding="2" cellspacing="0" border="0">
-<tr>
-<td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a
name="How%20can%20I%20contribute%20to%20James"><strong>How can I contribute to
James</strong></a></font></td>
-</tr>
-<tr>
-<td>
-<blockquote>
-
-<p>Read the "Contributors How To" <a href="contribute.html">here</a>
-
-<br>
- Danny Angus
- </p>
-
-</blockquote>
-</td>
-</tr>
-</table>
-
-<a name="14"></a>
-
-<table width="100%" cellpadding="2" cellspacing="0" border="0">
-<tr>
-<td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a
name="How%20can%20I%20make%20sendmail%20route%20local%20mail%20(or%20all%20mail)%20through%20James%20on%20the%20same%20machine?"><strong>How
can I make sendmail route local mail (or all mail) through James on the same
machine?</strong></a></font></td>
-</tr>
-<tr>
-<td>
-<blockquote>
-
-<p>Read the "sendmail How To" <a href="james_and_sendmail.html">here</a>
-
-<br>
- Danny Angus
- </p>
-
-</blockquote>
-</td>
-</tr>
-</table>
-
-</blockquote>
-</td>
-</tr>
-</table>
-</td>
-</tr>
-<!--FOOTER SEPARATOR-->
-<tr>
-<td colspan="2">
-<hr size="1" noshade="">
-</td>
-</tr>
-<!--PAGE FOOTER-->
-<tr>
-<td colspan="2">
-<div align="center">
-<font size="-1" color="#525D76"><em>
- Copyright © 1999-2002, Apache Software Foundation
- </em></font>
-</div>
-</td>
-</tr>
-</table>
-</body>
-</html>
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+<title>Jakarta James - Frequently Asked Questions</title>
+<meta value="Danny Angus" name="author">
+<meta value="[EMAIL PROTECTED]" name="email">
+<LINK TITLE="Style" HREF="stylesheet.css" TYPE="text/css" REL="stylesheet">
+</head>
+<body vlink="#525D76" alink="#525D76" link="#525D76" text="#000000"
bgcolor="#ffffff">
+<table cellspacing="4" width="100%" border="0">
+<!--PAGE HEADER-->
+<tr>
+<td colspan="2">
+<!--JAKARTA LOGO--><a href="http://jakarta.apache.org/";><img border="0" alt="The
Jakarta Project" align="left"
src="http://jakarta.apache.org/images/jakarta-logo.gif";></a>
+<!--PROJECT LOGO--><a href="http://jakarta.apache.org/james/";><img border="0"
alt="JAMES - Java Apache Mail Enterprise Server" align="right"
src="http://jakarta.apache.org/james///images/james-logo.jpg";></a></td>
+</tr>
+<!--HEADER SEPARATOR-->
+<tr>
+<td colspan="2">
+<hr size="1" noshade="">
+</td>
+</tr>
+<tr>
+<!--LEFT SIDE NAVIGATION-->
+<td nowrap="true" valign="top" width="20%">
+<p>
+<strong>James</strong>
+</p>
+<ul>
+<li>
+<a href="./index.html">Overview</a>
+</li>
+<li>
+<a href="./architecture_v2_0.html">Architecture</a>
+</li>
+<li>
+<a href="./FAQ.html">James FAQ</a>
+</li>
+</ul>
+<p>
+<strong>Translated</strong>
+</p>
+<ul>
+<li>
+<a href="http://www.terra-intl.com/jakarta/james/";>Japanese (web)</a>
+</li>
+</ul>
+<p>
+<strong>Downloads</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>Documentation</strong>
+</p>
+<ul>
+<li>
+<a href="./install.html">Install</a>
+</li>
+<li>
+<a href="./configuration_v2_0.html">Configuration</a>
+</li>
+<li>
+<a href="./javadocs/index.html">James API</a>
+</li>
+<li>
+<a href="./mailet/index.html">Mailet API</a>
+</li>
+<li>
+<a href="./usingJDBC_v2.0.html">Using JDBC</a>
+</li>
+<li>
+<a href="./usingLDAP_v1_2.html">Using LDAP</a>
+</li>
+<li>
+<a href="./usingTLS_v1_2.html">Using TLS</a>
+</li>
+<li>
+<a href="./james_and_sendmail.html">James and sendmail</a>
+</li>
+<li>
+<a href="http://jakarta.apache.org/james/rfclist";>Useful RFCs (web)</a>
+</li>
+</ul>
+<p>
+<strong>Project</strong>
+</p>
+<ul>
+<li>
+<a href="http://jakarta.apache.org/site/bugs.html";>Bug Database </a>
+</li>
+<li>
+<a href="./contribute.html">How Can I Contribute?</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>
+<li>
+<a href="./changelog.html">Changelog</a>
+</li>
+<li>
+<a href="./weare.html">Who We Are</a>
+</li>
+</ul>
+<p>
+<strong>Jakarta Information (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/mail.html";>Mailing Lists</a>
+</li>
+<li>
+<a href="http://jakarta.apache.org/site/getinvolved.html";>Get Involved</a>
+</li>
+<li>
+<a href="http://jakarta.apache.org/site/cvsindex.html";>CVS Repositories</a>
+</li>
+<li>
+<a href="http://jakarta.apache.org/site/library.html";>Reference Library</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>
+<!--RIGHT SIDE MAIN BODY--><td align="left" valign="top" width="80%">
+<table width="100%" cellpadding="2" cellspacing="0" border="0">
+<tr>
+<td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a
name="This%20FAQ"><strong>This FAQ</strong></a></font></td>
+</tr>
+<tr>
+<td>
+<blockquote>
+
+<P>This is a living document that provides answers to common questions about James,
installation, configuration, admin and running not already answered in the
documentation. Last Updated August 2002.</P>
+
+</blockquote>
+</td>
+</tr>
+</table>
+<table width="100%" cellpadding="2" cellspacing="0" border="0">
+<tr>
+<td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a
name="Questions"><strong>Questions</strong></a></font></td>
+</tr>
+<tr>
+<td>
+<blockquote>
+
+<p>
+
+<ul>
+
+<li>
+
+<a href="#1">Would you please teach me how to set up a mailing list</a>
+
+</li>
+
+<li>
+
+<a href="#2">Is James an Open Relay for Spam?</a>
+
+</li>
+
+<li>
+
+<a href="#3">I can send messages to James, but nobody is receiving them. What do I
do?</a>
+
+</li>
+
+<li>
+
+<a href="#4">I can send people messages via James, but nobody can send me messages.
What do I do?</a>
+
+</li>
+
+<li>
+
+<a href="#5">I'm trying to debug messages that James is trying to deliver. Where
should I look?</a>
+
+</li>
+
+<li>
+
+<a href="#6">What about IMAP support?</a>
+
+</li>
+
+<li>
+
+<a href="#7">What about support virtual hosting?</a>
+
+</li>
+
+<li>
+
+<a href="#8">Where do I stick classes and jars?</a>
+
+</li>
+
+<li>
+
+<a href="#9">How do I upgrade to a newer version of James?</a>
+
+</li>
+
+<li>
+
+<a href="#10">How do I run James as an NT/2k/XP service?</a>
+
+</li>
+
+<li>
+
+<a href="#11">Why isn't my mailet making changes to a MimeMessage?</a>
+
+</li>
+
+<li>
+
+<a href="#12">How to remove unneeded services like NNTP, POP3?</a>
+
+</li>
+
+<li>
+
+<a href="#13">How can I contribute to James?</a>
+
+</li>
+
+<li>
+
+<a href="#14">How can I make sendmail route local mail (or all mail) through James
on the same machine?</a>
+
+</li>
+
+<li>
+
+<a href="#15">I am using Microsoft's SQL Type 4 JDBC Driver, why do I get a "Can't
start manual transaction mode because there are cloned connections" exception?</a>
+
+</li>
+
+</ul>
+
+</p>
+
+</blockquote>
+</td>
+</tr>
+</table>
+<table width="100%" cellpadding="2" cellspacing="0" border="0">
+<tr>
+<td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a
name="Answers"><strong>Answers</strong></a></font></td>
+</tr>
+<tr>
+<td>
+<blockquote>
+
+<a name="1"></a>
+
+<table width="100%" cellpadding="2" cellspacing="0" border="0">
+<tr>
+<td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a
name="Would%20you%20please%20teach%20me%20how%20to%20set%20up%20a%20mailing%20list"><strong>Would
you please teach me how to set up a mailing list</strong></a></font></td>
+</tr>
+<tr>
+<td>
+<blockquote>
+
+<p>James currently (v2.0a3) includes only the most basic list functionality, users
can subscribe and unsubscribe, but there is no moderation of messages or
subscriptions</p>
+
+<p>To enable a list you need the following in config.xml in the root processor
block and above the final mailet block -</p>
+
+<div align="left">
+<table border="0" cellpadding="0" cellspacing="4">
+<tr>
+<td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td
height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
+</tr>
+<tr>
+<td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1"
width="1" src="/images/void.gif"></td><td height="1" bgcolor="#ffffff">
+<pre>
+<mailet match="CommandForListserv=james@localhost"
+ class="AvalonListservManager">
+ <repositoryName>list-james</repositoryName>
+</mailet>
+</pre>
+</td><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
+</tr>
+<tr>
+<td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td
height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
+</tr>
+</table>
+</div>
+
+<p>that will intercept the command emails sent to
+<ul>
+
+<li>james-on@localhost to subscribe the sender</li>
+
+<li>james-off@localhost to unsubscribe the sender</li>
+
+</ul>
+
+</p>
+
+<p>and-</p>
+
+<div align="left">
+<table border="0" cellpadding="0" cellspacing="4">
+<tr>
+<td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td
height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
+</tr>
+<tr>
+<td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1"
width="1" src="/images/void.gif"></td><td height="1" bgcolor="#ffffff">
+<pre>
+<mailet match="RecipientIs=james@localhost" class="AvalonListserv">
+ <membersonly> false </membersonly>
+ <attachmentsallowed> true </attachmentsallowed>
+ <replytolist> true </replytolist>
+ <repositoryName>list-james</repositoryName>
+ <subjectprefix>JamesList</subjectprefix>
+</mailet>
+</pre>
+</td><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
+</tr>
+<tr>
+<td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td
height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
+</tr>
+</table>
+</div>
+
+<p>Which will distribute the mail to the current subscribers</p>
+
+<p>in addition to the above you need to have a repository configured in the
users-store block(usually near the bottom of config.xml) like so (database)-</p>
+
+<div align="left">
+<table border="0" cellpadding="0" cellspacing="4">
+<tr>
+<td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td
height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
+</tr>
+<tr>
+<td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1"
width="1" src="/images/void.gif"></td><td height="1" bgcolor="#ffffff">
+<pre>
+<repository name="list-james"
+ class="org.apache.james.userrepository.ListUsersJdbcRepository"
+ destinationURL="db://maildb/lists/list-james">
+ <sqlFile>file://conf/sqlResources.xml</sqlFile>
+</repository>
+</pre>
+</td><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
+</tr>
+<tr>
+<td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td
height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
+</tr>
+</table>
+</div>
+
+<p>Database users will also need to ensure that they have configured a data-source
named to match the destination URL</p>
+
+<p>Using the filesystem:-</p>
+
+<div align="left">
+<table border="0" cellpadding="0" cellspacing="4">
+<tr>
+<td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td
height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
+</tr>
+<tr>
+<td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1"
width="1" src="/images/void.gif"></td><td height="1" bgcolor="#ffffff">
+<pre>
+<repository name="list-james"
+ class="org.apache.james.userrepository.UsersFileRepository">
+ <destination URL="file://var/lists/list-james/"/>
+</repository>
+</pre>
+</td><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
+</tr>
+<tr>
+<td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td
height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
+</tr>
+</table>
+</div>
+
+<p>Restart James, send a mail to james-on@localhost and you should be
subscribed.</p>
+
+<p>The repository, be it a database table or directory in the filesystem will be
created automatically.</p>
+
+<p>Database users can manipulate the users repository using SQL, and hence any
application capable of running SQL queries against it.<br>Danny Angus</p>
+
+</blockquote>
+</td>
+</tr>
+</table>
+
+<a name="2"></a>
+
+<table width="100%" cellpadding="2" cellspacing="0" border="0">
+<tr>
+<td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a
name="James%20seems%20to%20be%20an%20open%20relay%20for%20Spam,%20is%20it?"><strong>James
seems to be an open relay for Spam, is it?</strong></a></font></td>
+</tr>
+<tr>
+<td>
+<blockquote>
+
+<p>In some simple tests of mail relays James appears to be an open relay, properly
configured it is not. </p>
+
+<p>Because James is an email application platform it currently accepts all mail
delivered to it via SMTP for processing. Only after the mail has been recieved does
this processing begin.</p>
+
+<p>This means that James accepts Spam. However the default configuration, and any
sensible re-configuration has a number of anti-spam measures which will prevent the
re-transmisson of spam from James. This makes it a blackhole for spam.</p>
+
+<p>This also means that James will not verify addresses, but of course this means
that valid addresses can't be harvested from James by spammers either.<br>Danny
Angus</p>
+
+</blockquote>
+</td>
+</tr>
+</table>
+
+<a name="3"></a>
+
+<table width="100%" cellpadding="2" cellspacing="0" border="0">
+<tr>
+<td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a
name="I%20can%20send%20messages%20to%20James,%20but%20nobody%20is%20receiving%20them.%20%20What%20do%20I%20do?"><strong>I
can send messages to James, but nobody is receiving them. What do I
do?</strong></a></font></td>
+</tr>
+<tr>
+<td>
+<blockquote>
+
+<p>Check that you've added valid DNS servers to your James installation. Email
delivery requires the use of special mail related DNS information (MX records), so
James needs to explicitly be given DNS servers. Look at your config.xml file for a
<dnsserver> section and add one or more DNS servers. Serge Knystautas</p>
+
+<p>Additionally, check the RemoteAddrNotInNetwork matcher under<processor
name="transport">. By default it looks like this:</p>
+
+<div align="left">
+<table border="0" cellpadding="0" cellspacing="4">
+<tr>
+<td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td
height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
+</tr>
+<tr>
+<td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1"
width="1" src="/images/void.gif"></td><td height="1" bgcolor="#ffffff">
+<pre>
+<mailet match="RemoteAddrNotInNetwork=127.0.0.1" class="ToProcessor">
+ <processor> spam </processor>
+</mailet>
+</pre>
+</td><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
+</tr>
+<tr>
+<td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td
height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
+</tr>
+</table>
+</div>
+
+<p>because most mail programs will use the external IP address (as opposed to
127.0.0.1) when processing mail, you need to add your internal network and/or your
static IP address to this list. You may also use a DNS domain name in this list. The
resulting entry would look something like this:</p>
+
+<div align="left">
+<table border="0" cellpadding="0" cellspacing="4">
+<tr>
+<td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td
height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
+</tr>
+<tr>
+<td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1"
width="1" src="/images/void.gif"></td><td height="1" bgcolor="#ffffff">
+<pre>
+<mailet match="RemoteAddrNotInNetwork=127.0.0.1,192.168.1.*"
+ class="ToProcessor">
+ <processor> spam </processor>
+</mailet>
+</pre>
+</td><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
+</tr>
+<tr>
+<td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td
height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
+</tr>
+</table>
+</div>
+
+<p>This tells the processor that anything not in this address list should go to the
spam processor.</p>
+
+<p>Please note that if you wish to configure James to allow users to send email
from any domain or IP address you will need to disable this matcher. In this
situation you must use SMTP AUTH to ensure that your server does not act as an open
relay. For more on open relays, please see <a href="http://www.ordb.org";>the Open
Relay Database</a>.</p>
+
+</blockquote>
+</td>
+</tr>
+</table>
+
+<a name="4"></a>
+
+<table width="100%" cellpadding="2" cellspacing="0" border="0">
+<tr>
+<td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a
name="I%20can%20send%20people%20messages%20via%20James,%20but%20nobody%20can%20send%20me%20messages.%20%20What%20do%20I%20do?"><strong>I
can send people messages via James, but nobody can send me messages. What do I
do?</strong></a></font></td>
+</tr>
+<tr>
+<td>
+<blockquote>
+
+<p>You need to do one of two things:
+ <ol>
+
+<li>Update your domain's DNS entries so there are MX records that point to the
machine that is running James. Note that it is illegal for MX records to point to IP
addresses. You need to point MX records to a valid CNAME or A name entry, and then
map that eventually to an IP address.</li>
+
+<li>You could alternatively give people an email address with IP addresses. Most
people will think it's a very strange email address, but hello@[192.168.0.1] is a
valid email address. Note that you need to wrap the IP address in brackets.</li>
+
+</ol>
+ Serge Knystautas</p>
+
+</blockquote>
+</td>
+</tr>
+</table>
+
+<a name="5"></a>
+
+<table width="100%" cellpadding="2" cellspacing="0" border="0">
+<tr>
+<td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a
name="I'm%20trying%20to%20debug%20messages%20that%20James%20is%20trying%20to%20deliver.%20%20Where%20should%20I%20look?"><strong>I'm
trying to debug messages that James is trying to deliver. Where should I
look?</strong></a></font></td>
+</tr>
+<tr>
+<td>
+<blockquote>
+
+<p>First step is to look in the log directory at the James.Mailet.log file. Look
for entries that include the text "RemoteDelivery". This should provide some
high-level debug information of James's attempt to delivery mail remotely.</p>
+
+<p>If you want to delve into the code, look at the RemoteDelivery mailet. You may
also want to review the mail repository source code for the repository type you are
using (file, db, etc...).<br>Serge Knystautas</p>
+
+</blockquote>
+</td>
+</tr>
+</table>
+
+<a name="6"></a>
+
+<table width="100%" cellpadding="2" cellspacing="0" border="0">
+<tr>
+<td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a
name="What%20about%20IMAP%20support?"><strong>What about IMAP
support?</strong></a></font></td>
+</tr>
+<tr>
+<td>
+<blockquote>
+
+<p>Unfortunately IMAP support is currently stalled. There is a proposal in CVS,
but IMAP is a significantly more complex than other mail protocols, both from a
protocol command support and in terms of complexity you need on the server. If you
are interested in taking the proverbial ball and running with it, we would all very
much appreciated. (I personally am incredibly frustrated with an old Netscape Mail
server, but I've sworn myself to upgrade only to James's IMAP once ready as incentive.)
+ <br>Serge Knystautas</p>
+
+<p>An update to Serge's comment: the IMAP server has recently attracted new
interest. We are hopeful that we will be able to provide basic IMAP support in James
2.1<br>Peter M. Goldstein</p>
+
+</blockquote>
+</td>
+</tr>
+</table>
+
+<a name="7"></a>
+
+<table width="100%" cellpadding="2" cellspacing="0" border="0">
+<tr>
+<td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a
name="What%20about%20support%20virtual%20hosting?"><strong>What about support virtual
hosting?</strong></a></font></td>
+</tr>
+<tr>
+<td>
+<blockquote>
+
+<p>Virtual hosting is something the developers are still wrestling with. The
challenge is that POP3 does not support virtual hosting in that it does not have a
command to indicate what domain the user is in. What this means is the mail server
needs to develop a 'mapping' or 'translation', e.g., '[EMAIL PROTECTED]' gets a
username 'domaina.user1'. This allows the mail server to have a single username
namespace. We have seen a few good proposals put forward, but nothing that seemed the
clear solution as ideally we could have this part solve the next issue.</p>
+
+<p>Beyond that, James needs to refine virtual hosting for mailet processing. The
mailet API has a Mail.getUser() method that no longer would be useable as a reliable
indicator of whether they were in the local username namespace. To date we are
unclear of the best way to bring this translation into the mailet processing.
Similarly, it would be nice to support different mailet processing based on the
domain, although this is somewhat feasible using the limited processing flow offered
with a HostIs/ForwardTo combination.</p>
+
+<p>This is one of the most requested feature, so hopefully this will be resolved
soon.
+ <br>Serge Knystautas</p>
+
+</blockquote>
+</td>
+</tr>
+</table>
+
+<a name="8"></a>
+
+<table width="100%" cellpadding="2" cellspacing="0" border="0">
+<tr>
+<td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a
name="Where%20do%20I%20stick%20classes%20and%20jars?"><strong>Where do I stick classes
and jars?</strong></a></font></td>
+</tr>
+<tr>
+<td>
+<blockquote>
+
+<p>We are largely reliant on what Avalon is doing in terms of classloading, but
here are a few tips and suggestions:
+ <ul>
+
+<li>Stick jars in the james/lib directory and add them to the classpath in run.bat
or run.sh.</li>
+
+<li>Custom mailets and matchers must be included in the james.bar (which is just a
zip like a jar or war file).</li>
+
+</ul>
+ Eventually we hope to support mailet reloading and a special lib and classes
directory within the james directory that custom mailets can load from, but for now
these are hopefully some useful tips.
+ <br>Serge Knystautas</p>
+
+</blockquote>
+</td>
+</tr>
+</table>
+
+<a name="9"></a>
+
+<table width="100%" cellpadding="2" cellspacing="0" border="0">
+<tr>
+<td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a
name="How%20do%20I%20upgrade%20to%20a%20newer%20version%20of%20James?"><strong>How do
I upgrade to a newer version of James?</strong></a></font></td>
+</tr>
+<tr>
+<td>
+<blockquote>
+
+<p>
+
+<ol>
+
+<li>Rename the previous james directory into a james.old</li>
+
+<li>Run phoenix to let the new james.sar be deployed.</li>
+
+<li>Copy config.xml from james.old to the new deployed james/conf directory</li>
+
+<li>Replace the var directory by the previous var directory. This will copy over
user accounts, inboxes, spools, and whatever else.</li>
+
+<li>Restart James.</li>
+
+</ol>
+ Daniel Herlemont
+ </p>
+
+</blockquote>
+</td>
+</tr>
+</table>
+
+<a name="10"></a>
+
+<table width="100%" cellpadding="2" cellspacing="0" border="0">
+<tr>
+<td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a
name="How%20do%20I%20run%20James%20as%20an%20NT/2k/XP%20service?"><strong>How do I run
James as an NT/2k/XP service?</strong></a></font></td>
+</tr>
+<tr>
+<td>
+<blockquote>
+
+<p>You can use Alexandria will setup/run JAMES on NT/2k/XP</p>
+
+<p>I created a .bat file called InstallJamesNTService.bat containing the
+following (I used the Alexandria tomcat.bat file as my template, as you can
+see):</p>
+
+<div align="left">
+<table border="0" cellpadding="0" cellspacing="4">
+<tr>
+<td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td
height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
+</tr>
+<tr>
+<td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1"
width="1" src="/images/void.gif"></td><td height="1" bgcolor="#ffffff">
+<pre>
+
+ @echo off
+ echo --------
+ echo Usage: %0 jdk_home james_home (classic/hotspot/server)
+ echo NOTE: You MAY NOT use spaces in the path names.
+ echo JDK 1.3 does not come with hotpot server by default, you must
+ echo install this separately if you wish to use it.
+ echo Example: %0 c:\progra~1\jdk c:\progra~1\james classic
+ echo --------
+
+ if "%1" == "" goto eof
+ if "%2" == "" goto eof
+ if "%3" == "" goto eof
+
+ copy JavaService.exe %2\bin\James.exe > nul
+ %2\bin\James.exe -install JamesMailServer
+ rem put the following command all on one line
+ %1\jre\bin\%3\jvm.dll -Djava.ext.dirs=%2\lib
+ -Djava.class.path=%CLASSPATH%;%2\bin\phoenix-loader.jar;
+ %2\bin\phoenix-engine.jar
+ -start org.apache.avalon.phoenix.launcher.Main
+ -out %2\logs\stdout.log -err %2\logs\stderr.log
+
+ goto eof
+
+ :eof
+ </pre>
+</td><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
+</tr>
+<tr>
+<td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td
height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
+</tr>
+</table>
+</div>
+
+<p>
+ I created another .bat file called UnistallJamesNTService containing the
following 1 line:
+ </p>
+
+<div align="left">
+<table border="0" cellpadding="0" cellspacing="4">
+<tr>
+<td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td
height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
+</tr>
+<tr>
+<td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0" height="1"
width="1" src="/images/void.gif"></td><td height="1" bgcolor="#ffffff">
+<pre>
+ James -uninstall JamesMailServer
+ </pre>
+</td><td width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
+</tr>
+<tr>
+<td height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td><td height="1" bgcolor="#023264"><img
border="0" hspace="0" vspace="0" height="1" width="1" src="/images/void.gif"></td><td
height="1" width="1" bgcolor="#023264"><img border="0" hspace="0" vspace="0"
height="1" width="1" src="/images/void.gif"></td>
+</tr>
+</table>
+</div>
+
+<p>By copying the 2 above .bat files and the JavaService.exe (follow the download
link at http://www.alexandriasc.com/software/JavaService/index.html) to the
[james]\bin folder, I am able to install and uninstall the JamesMailServer NT service!
+ <br>Taken from
http://www.mail-archive.com/james-user@;jakarta.apache.org/msg01389.html by Steve Belt
+ </p>
+
+</blockquote>
+</td>
+</tr>
+</table>
+
+<a name="11"></a>
+
+<table width="100%" cellpadding="2" cellspacing="0" border="0">
+<tr>
+<td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a
name="Why%20isn't%20my%20mailet%20making%20changes%20to%20a%20MimeMessage?"><strong>Why
isn't my mailet making changes to a MimeMessage?</strong></a></font></td>
+</tr>
+<tr>
+<td>
+<blockquote>
+
+<p>Check the JavaMail docs... I don't think I would have designed it this way, but
per the API, when you call MimeMessage.setContent(blah), you have to call
saveChanges() to apply your changes. James tries to automatically call this method so
you don't have to, but in certain cases you'll still have to call saveChanges().
+ <br>
+ Serge Knystautas
+ </p>
+
+</blockquote>
+</td>
+</tr>
+</table>
+
+<a name="12"></a>
+
+<table width="100%" cellpadding="2" cellspacing="0" border="0">
+<tr>
+<td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a
name="How%20to%20remove%20unneeded%20services%20like%20NNTP,%20POP3?"><strong>How to
remove unneeded services like NNTP, POP3?</strong></a></font></td>
+</tr>
+<tr>
+<td>
+<blockquote>
+
+<p>The following information is based on James 2.0a3, but the
+ upcoming 2.1 version should be similar.</p>
+
+<p>NNTP and other underlying services are called "blocks" in the
+ Avalon Phoenix terminology. Blocks are specified in the
+ assembly.xml file which is under the apps/james/conf directory in
+ 2.0a3 and apps\james\SAR-INF in 2.1. Note: this file is created
+ during the first startup of James.</p>
+
+<p>There are dependencies between the blocks, which you can read from
+ the file. For example the SMTP Server block depends on the
+ users-store block, so if you want SMTP then you cannot remove the
+ users-store block even if you only want to relay messages.</p>
+
+<p>To remove the NNTP Server comment out the following blocks:
+ NNTP server, NNTP Authentication Service, NNTP repository.
+ To remove the POP3 Server comment out the POP3 Server block.</p>
+
+<p>If you remove a block it wont't be loaded next time you restart
+ James. You must also remove all sections related to the removed
+ blocks from the James configuration file - config.xml - otherwise
+ you will get error messages, saying that there is no corresponding
+ block.<br>
+ Hontvari Jozsef</p>
+
+</blockquote>
+</td>
+</tr>
+</table>
+
+<a name="13"></a>
+
+<table width="100%" cellpadding="2" cellspacing="0" border="0">
+<tr>
+<td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a
name="How%20can%20I%20contribute%20to%20James"><strong>How can I contribute to
James</strong></a></font></td>
+</tr>
+<tr>
+<td>
+<blockquote>
+
+<p>Read the "Contributors How To" <a href="contribute.html">here</a>
+
+<br>
+ Danny Angus
+ </p>
+
+</blockquote>
+</td>
+</tr>
+</table>
+
+<a name="14"></a>
+
+<table width="100%" cellpadding="2" cellspacing="0" border="0">
+<tr>
+<td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a
name="How%20can%20I%20make%20sendmail%20route%20local%20mail%20(or%20all%20mail)%20through%20James%20on%20the%20same%20machine?"><strong>How
can I make sendmail route local mail (or all mail) through James on the same
machine?</strong></a></font></td>
+</tr>
+<tr>
+<td>
+<blockquote>
+
+<p>Read the "sendmail How To" <a href="james_and_sendmail.html">here</a>
+
+<br>
+ Danny Angus
+ </p>
+
+</blockquote>
+</td>
+</tr>
+</table>
+
+<a name="15"></a>
+
+<table width="100%" cellpadding="2" cellspacing="0" border="0">
+<tr>
+<td bgcolor="#828DA6"><font face="arial,helvetica.sanserif" color="#ffffff"><a
name="I%20am%20using%20Microsoft's%20SQL%20Type%204%20JDBC%20Driver,%20why%20do%20I%20get%20a%20%22Can't%20start%20manual%20transaction%20mode%20because%20there%20are%20cloned%20connections%22%20exception?"><strong>I
am using Microsoft's SQL Type 4 JDBC Driver, why do I get a "Can't start manual
transaction mode because there are cloned connections"
exception?</strong></a></font></td>
+</tr>
+<tr>
+<td>
+<blockquote>
+
+<p>I am using Microsoft's SQL Type 4 JDBC Driver, why do I get the following
exception?<br>java.sql.SQLException: [Microsoft][SQLServer 2000 Driver for JDBC]Can't
start manual transaction mode because there are cloned connections.</p>
+
+<p>This seems to be a problem with the Microsoft Type 4 JDBC Driver and concurrent
statements/transactions/resultsets on the same database conntection.</p>
+
+<p>To solve this you need to add <b>;SelectMethod=cursor</b> to the end of your
dburl string. Your dburl string would then look something like
this<br><dburl>jdbc:microsoft:sqlserver://dbserver.host.name:1433;SelectMethod=cursor</dburl></p>
+
+<p>NOTE. some people have complained about performance when using this option, the
alternative is a 3rd party JDBC driver but these are often not free.<br>Serge
Sozonoff</p>
+
+</blockquote>
+</td>
+</tr>
+</table>
+
+
+</blockquote>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+<!--FOOTER SEPARATOR-->
+<tr>
+<td colspan="2">
+<hr size="1" noshade="">
+</td>
+</tr>
+<!--PAGE FOOTER-->
+<tr>
+<td colspan="2">
+<div align="center">
+<font size="-1" color="#525D76"><em>
+ Copyright © 1999-2002, Apache Software Foundation
+ </em></font>
+</div>
+</td>
+</tr>
+</table>
+</body>
+</html>
1.19 +11 -0 jakarta-james/src/xdocs/FAQ.xml
Index: FAQ.xml
===================================================================
RCS file: /home/cvs/jakarta-james/src/xdocs/FAQ.xml,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -r1.18 -r1.19
--- FAQ.xml 30 Aug 2002 15:22:32 -0000 1.18
+++ FAQ.xml 2 Nov 2002 02:55:36 -0000 1.19
@@ -53,6 +53,9 @@
<li>
<a href="#14">How can I make sendmail route local mail (or all
mail) through James on the same machine?</a>
</li>
+ <li>
+ <a href="#15">I am using Microsoft's SQL Type 4 JDBC Driver, why
do I get a "Can't start manual transaction mode because there are cloned connections"
exception?</a>
+ </li>
</ul>
</p>
</section>
@@ -268,6 +271,14 @@
Danny Angus
</p>
</subsection>
+ <a name="15"/>
+ <subsection name="I am using Microsoft's SQL Type 4 JDBC Driver, why do I
get a "Can't start manual transaction mode because there are cloned
connections" exception?">
+<p>I am using Microsoft's SQL Type 4 JDBC Driver, why do I get the following
exception?<br/>java.sql.SQLException: [Microsoft][SQLServer 2000 Driver for
JDBC]Can't start manual transaction mode because there are cloned connections.</p>
+<p>This seems to be a problem with the Microsoft Type 4 JDBC Driver and concurrent
statements/transactions/resultsets on the same database conntection.</p>
+<p>To solve this you need to add <b>;SelectMethod=cursor</b> to the end of your
dburl string. Your dburl string would then look something like
this<br/><dburl>jdbc:microsoft:sqlserver://dbserver.host.name:1433;SelectMethod=cursor</dburl></p>
+<p>NOTE. some people have complained about performance when using this option, the
alternative is a 3rd party JDBC driver but these are often not free.<br/>Serge
Sozonoff</p>
+ </subsection>
+
</section>
</body>
</document>
--
To unsubscribe, e-mail: <mailto:james-dev-unsubscribe@;jakarta.apache.org>
For additional commands, e-mail: <mailto:james-dev-help@;jakarta.apache.org>
![http://jakarta.apache.org/images/jakarta-logo.gif"](http://jakarta.apache.org/images/jakarta-logo.gif"){kind=link}
![http://jakarta.apache.org/james///images/james-logo.jpg"](http://jakarta.apache.org/james///images/james-logo.jpg"){kind=link}