danny 2002/12/06 05:33:54 Modified: src/xdocs fetchpop_configuration_2_1.xml Log: beefed it up a bit. Revision Changes Path 1.2 +48 -12 jakarta-james/src/xdocs/fetchpop_configuration_2_1.xml Index: fetchpop_configuration_2_1.xml =================================================================== RCS file: /home/cvs/jakarta-james/src/xdocs/fetchpop_configuration_2_1.xml,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- fetchpop_configuration_2_1.xml 1 Dec 2002 09:55:00 -0000 1.1 +++ fetchpop_configuration_2_1.xml 6 Dec 2002 13:33:54 -0000 1.2 @@ -1,14 +1,14 @@ -<?xml version="1.0"?> - -<document> - - <properties> - <title>James 2.1 - Configuring FetchPOP</title> - </properties> +<?xml version="1.0"?> -<body> +<document> + + <properties> + <title>James 2.1 - Configuring FetchPOP</title> + </properties> + +<body> <section name="FetchPOP Configuration"> -<p>FetchPOP is controlled by a configuration block in the config.xml. +<p>FetchPOP is controlled by a configuration block in the config.xml. The fetchpop tag defines the boundaries of the configuration block. It encloses all the relevant configuration for the FetchPOP scheduler. The behavior of the POP service is controlled by the attributes and children of this tag.</p> @@ -21,11 +21,47 @@ <p>In addition to the <strong>name</strong> attribute, the <strong>fetch</strong> tag has four children, all of which are required.</p> <ul> -<li><strong>host</strong> - The host name or IP address of the POP3 server hosting the mail to be fetched.</li> +<li><strong>host</strong> - The host name or IP address of the POP3 server hosting the mail to be fetched.</li> <li><strong>user</strong> - The user name of the account whose mail is to be fetched.</li> <li><strong>password</strong> - The password for the account whose mail is to be fetched.</li> <li><strong>interval</strong> - A non-negative integer representing the number of milliseconds between fetches.</li> </ul> </section> -</body> -</document> +<section name="Considerations when handling fetched mail"> +<p>There are a number of issues which have to be considered when handling fetched mail, such as avoiding circular +routeing of mail, some scenarios are described below with suggested configurations.</p> + +<subsection name="All mail for the domain is handled locally by this server"> +<p>This is the intended primary use of FetchPOP. +If all mail for a domain being fetched is ultimately being handled by this server then it is enough to add +the domain name as a servername to the servernames section described <a href="serverwide_configuration_2_1.html">here</a>. +<br/>This is the simplest solution and is used where James is being used to redistribute all mail from the +free catch-all POP accounts provided by many domain registration/hosting companies.</p> +</subsection> +<subsection name="Only part of this domains mail is being handled locally"> +<p>If only part of a domain's mail(perhaps only a single users POP account) is being handled by this instance +of James we need to ensure that outgoing mail to other users on the same domain is not intercepted by James. +To manage this FetchPop adds a header, X-fetchedby, to the fetched message. We can examine this header with +a special matcher <b>FetchedFrom</b> exactly once, as the matcher removes the header to prevent outgoing replies +or redirections from looping.<br/> FetchedFrom takes the name set in the fetch configuration as its condition +<mailet match="FetchedFrom=<i>fetchname</i>" class="ToProcessor"><br/> +We can use this to direct fetched mail to a new processor we set up to handle mail fetched from one or more POP accounts. +<br/>This processor should contain mailets which will filter and forward mail to real local or remote users. +This can be achieved in the usual fashion as described elsewhere in this documentation.</p> +</subsection> + <subsection name="Catching undeliverable mail"> +<p>It is important to note that this first version of FetchPop does not access the original intended recipient +address of the mail, but uses the <b>To:</b> address from the Headers only. This may result in no valid user +being found for mail where the fetched account is in the cc or bcc field, or is not present in the mail headers +at all. It is intended that this behaviour be addressed in the next version of James, but in the meantime a +catch-all forwarding of locally undeliverable fetched mail is recommended.</p> +<p>In the case of the first scenario we can use the <mailet match="FetchedFrom=<i>fetchname</i>" class="forward"> matcher.<br/> +Place this between the "RecipientIsLocal" and "HostIsLocal" in the Transport processor as set up in the default configuration +and it will intercept mail fetched by your fetcher but not delivered to a local user</p> +<p>In the case of the second scenario we can use the <mailet match="All" class="forward"> matcher.<br/> +Place this at the end of your new processor to catch all mail which can't be forwarded or redirected by the mailets +you have defined.</p> +</subsection> +</section> +</body> +</document>
-- To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]> For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
