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 pg...@apache.org on 2002/12/13 19:22:12 UTC
cvs commit: jakarta-james/src/xdocs FAQ.xml
pgoldstein 2002/12/13 10:22:12
Modified: src/xdocs FAQ.xml
Log:
Minor corrections.
Revision Changes Path
1.22 +15 -16 jakarta-james/src/xdocs/FAQ.xml
Index: FAQ.xml
===================================================================
RCS file: /home/cvs/jakarta-james/src/xdocs/FAQ.xml,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -r1.21 -r1.22
--- FAQ.xml 7 Dec 2002 20:16:54 -0000 1.21
+++ FAQ.xml 13 Dec 2002 18:22:11 -0000 1.22
@@ -12,7 +12,7 @@
<p>
<ul>
<li>
- <a href="#1">Would you please teach me how to set up a mailing list</a>
+ <a href="#1">How do I set up a mailing list</a>
</li>
<li>
<a href="#2">Is James an Open Relay for Spam?</a>
@@ -46,7 +46,7 @@
</li>
<li>
<a href="#12">How to remove unneeded services like NNTP, POP3?</a>
- </li>
+ </li>
<li>
<a href="#13">How can I contribute to James?</a>
</li>
@@ -65,7 +65,7 @@
<section name="Answers">
<a name="1"/>
<subsection name="Would you please teach me how to set up a mailing list">
- <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>James currently (v2.1) 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>
<source>
<mailet match="CommandForListserv=james@localhost"
@@ -139,28 +139,27 @@
<a name="4"/>
<subsection name="I can send people messages via James, but nobody can send me messages. What do I do?">
<p>You need to do one of two things:
- <ol>
+ <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>
+ Serge Knystautas</p>
</subsection>
<a name="5"/>
<subsection name="I'm trying to debug messages that James is trying to deliver. Where should I look?">
- <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>First step is to look in the log directory at the mailet.log file. Look for entries that include the text "RemoteDelivery". This should provide some high-level debug information of James' 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>
</subsection>
<a name="6"/>
<subsection name="What about IMAP support?">
- <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>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>
</subsection>
<a name="7"/>
<subsection name="What about support virtual hosting?">
<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., 'user1@domaina.com' 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.
+ <p>This is one of the most requested features, so hopefully this will be resolved soon. It is currently scheduled for the 3.0 release.
<br/>Serge Knystautas</p>
</subsection>
<a name="8"/>
@@ -168,7 +167,7 @@
<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>
+ <li>Instructions for including classes for custom mailets and matchers can be found <a href="custom_mailet_2_1.html">here</a> and <a href="custom_matcher_2_1.html">here</a> respectively..</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>
@@ -183,8 +182,8 @@
<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>
+ Daniel Herlemont
+ </p>
</subsection>
<a name="10"/>
<subsection name="How do I run James as an NT/2k/XP service?">
@@ -198,7 +197,7 @@
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 JDK 1.3 does not come with hotspot 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 --------
@@ -243,8 +242,8 @@
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
+ assembly.xml file which is located in the apps/james/SAR-INF directory (2.1)
+ or apps/james/conf directory (2.0a3). 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
@@ -279,7 +278,7 @@
<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>
+<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>
<a name="16"/>
<subsection name="I am using James with a MySQL database and I keep getting a "Packet is larger than max_allowed_packet" when receiving large messages despite the fact that my max packet size is configured to be larger than my max message size. What's going on?">
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>