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 da...@apache.org on 2002/05/30 13:21:44 UTC

cvs commit: jakarta-james/www FAQ.html index.html

danny       02/05/30 04:21:44

  Modified:    www      FAQ.html index.html
  Log:
  updating James version numbers
  
  Revision  Changes    Path
  1.8       +172 -22   jakarta-james/www/FAQ.html
  
  Index: FAQ.html
  ===================================================================
  RCS file: /home/cvs/jakarta-james/www/FAQ.html,v
  retrieving revision 1.7
  retrieving revision 1.8
  diff -u -r1.7 -r1.8
  --- FAQ.html	21 Apr 2002 20:39:45 -0000	1.7
  +++ FAQ.html	30 May 2002 11:21:43 -0000	1.8
  @@ -130,7 +130,7 @@
         </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 February 2002.</P>
  +                                    <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 May 2002.</P>
                               </blockquote>
           </p>
         </td></tr>
  @@ -145,17 +145,42 @@
         <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>
  -</ul>
  -</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>
  +				</ul>
  +			</p>
                               </blockquote>
           </p>
         </td></tr>
  @@ -206,10 +231,10 @@
       </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>
  +						<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 cellspacing="4" cellpadding="0" border="0">
  @@ -340,9 +365,9 @@
           <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>
  +						<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>
  @@ -406,11 +431,136 @@
           <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>
  +						<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>
  +      <tr><td><br/></td></tr>
  +    </table>
  +                                                <a name="9" />
  +                                                    <table border="0" cellspacing="0" cellpadding="2" width="100%">
  +      <tr><td bgcolor="#828DA6">
  +        <font color="#ffffff" face="arial,helvetica,sanserif">
  +          <a name="How do I upgrade to a newer version of James?"><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>
  +      <tr><td><br/></td></tr>
  +    </table>
  +                                                <a name="10" />
  +                                                    <table border="0" cellspacing="0" cellpadding="2" width="100%">
  +      <tr><td bgcolor="#828DA6">
  +        <font color="#ffffff" face="arial,helvetica,sanserif">
  +          <a name="How do I run James as an NT/2k/XP service?"><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 cellspacing="4" cellpadding="0" border="0">
  +    <tr>
  +      <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  +      <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  +      <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  +    </tr>
  +    <tr>
  +      <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  +      <td 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 seperately if you wish to use it.
  +  echo Example: %0 c:\progra~1\jdk c:\progra~1\james classic
  +  echo --------
  +
  +  if &quot;%1&quot; == &quot;&quot; goto eof
  +  if &quot;%2&quot; == &quot;&quot; goto eof
  +  if &quot;%3&quot; == &quot;&quot; goto eof
  +
  +  copy JavaService.exe %2\bin\James.exe &gt; nul
  +  %2\bin\James.exe -install JamesMailServer
  +  %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 bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  +    </tr>
  +    <tr>
  +      <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  +      <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  +      <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  +    </tr>
  +    </table>
  +    </div>
  +                                                <p>
  +  I created another .bat file called UnistallJamesNTService containing the following 1 line:
  +  </p>
  +                                                    <div align="left">
  +    <table cellspacing="4" cellpadding="0" border="0">
  +    <tr>
  +      <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  +      <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  +      <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  +    </tr>
  +    <tr>
  +      <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  +      <td bgcolor="#ffffff"><pre>
  +  James -uninstall JamesMailServer
  +  </pre></td>
  +      <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  +    </tr>
  +    <tr>
  +      <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  +      <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  +      <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></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>
  +      <tr><td><br/></td></tr>
  +    </table>
  +                                                <a name="11" />
  +                                                    <table border="0" cellspacing="0" cellpadding="2" width="100%">
  +      <tr><td bgcolor="#828DA6">
  +        <font color="#ffffff" face="arial,helvetica,sanserif">
  +          <a name="Why isn't my mailet making changes to a MimeMessage?"><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>
         <tr><td><br/></td></tr>
  
  
  
  1.9       +7 -7      jakarta-james/www/index.html
  
  Index: index.html
  ===================================================================
  RCS file: /home/cvs/jakarta-james/www/index.html,v
  retrieving revision 1.8
  retrieving revision 1.9
  diff -u -r1.8 -r1.9
  --- index.html	27 Feb 2002 22:01:07 -0000	1.8
  +++ index.html	30 May 2002 11:21:44 -0000	1.9
  @@ -132,10 +132,10 @@
         </td></tr>
         <tr><td>
           <blockquote>
  -                                    <p> The Java Apache Mail Enterprise Server (a.k.a. Apache James) is a 100% pure Java server, designed to be a complete and portable enterprise mail engine solution based on currently available open protocols (SMTP, POP3, NTTP). </p>
  +                                    <p> The Java Apache Mail Enterprise Server (a.k.a. Apache James) is a 100% pure Java server, designed to be a complete and portable enterprise mail engine solution based on currently available open protocols (SMTP, POP3, NNTP). </p>
                                                   <p>James is also a mail application platform. <br />The James project hosts the Apache Mailet API, and James provides and implementation of this mail application platform API.  </p>
                                                   <p>James is based upon the Apache Avalon application framework. (For more information about Avalon, please go to <a href="http://jakarta.apache.org/avalon">http://jakarta.apache.org/avalon</a>)</p>
  -                                                <p>James requires Java 2 (specific requirement is the JRE 1.3, JRE 1.4 is not yet fully supported). </p>
  +                                                <p>James requires Java 2 (either JRE 1.3 or 1.4 as of 2.0a3). </p>
                                                       <table border="0" cellspacing="0" cellpadding="2" width="100%">
         <tr><td bgcolor="#828DA6">
           <font color="#ffffff" face="arial,helvetica,sanserif">
  @@ -144,10 +144,10 @@
         </td></tr>
         <tr><td>
           <blockquote>
  -                                    <p><b>We've added an FAQ page.</b><br />There are only two FAQ's so far, but its a beginning (the link is on the left)</p>
  -                                                <p><b>Version 2.0a2 is now available.</b></p>
  -                                                <p>This new version contains a number of important bugfixes and performance improvements over v2.0a1</p>
  -                                                <p><a href="http://jakarta.apache.org/builds/jakarta-james/release/">Binary &amp; Source release of 2.0a2</a></p>
  +                                    <p><b>We've added an FAQ page.</b><br />There are only half a dozen FAQ's so far, but its a <a href="FAQ.html">beginning</a>.</p>
  +                                                <p><b>Version 2.0a3 is now available.</b></p>
  +                                                <p>This new version contains a number of important bugfixes and performance improvements over v2.0a1 and v2.0a2</p>
  +                                                <p><a href="http://jakarta.apache.org/builds/jakarta-james/latest/">Binary &amp; Source release of 2.0a3</a></p>
                               </blockquote>
         </td></tr>
         <tr><td><br/></td></tr>
  @@ -216,7 +216,7 @@
   </td>
                                   <td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
       <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  -                Status (v2.0a2)
  +                Status (v2.0a3)
               </font>
   </td>
                                   <td bgcolor="#039acc" colspan="" rowspan="" valign="top" align="left">
  
  
  

--
To unsubscribe, e-mail:   <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>